observing-agentforce

Analyze production Agentforce agent behavior using session traces and Data Cloud.

Updated May 19, 2026
One-click install
npx skills add https://github.com/dmckeeSF/mcpdctn0507 --skill observing-agentforce-dmckeesf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observing-agentforce
Source: https://github.com/dmckeeSF/mcpdctn0507/tree/main/.agents/skills/observing-agentforce
Command: npx skills add https://github.com/dmckeeSF/mcpdctn0507 --skill observing-agentforce-dmckeesf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires sfdata, sfapex, sfagent, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps analyze and improve production Agentforce agents by leveraging session traces and Data Cloud for identifying and resolving issues like performance bottlenecks, misroutes, and knowledge gaps.

Core Features & Use Cases

  • Session Tracing: Analyze STDM sessions to identify performance issues and misroutes.
  • Data Cloud Insights: Utilize Data Cloud to gain insights into agent behavior and performance.
  • Reproduction: Reproduce reported issues in preview mode to verify and fix problems.
  • Improvement: Directly edit .agent files to improve agent behavior and performance.

Quick Start

Run the observing-agentforce skill to analyze agent behavior for the last 7 days.

Frequently Asked Questions about observing-agentforce

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze Agentforce session traces to identify performance bottlenecks?

To analyze Agentforce session traces, examine STDM sessions to pinpoint performance bottlenecks and misroutes. This process leverages Data Cloud insights to evaluate production agent behavior and highlight operational inefficiencies for targeted improvements.

What is the best way to fix Agentforce misroutes and knowledge gaps?

The best way to fix Agentforce misroutes and knowledge gaps is to reproduce reported issues in preview mode. After verifying the behavior, directly edit the `.agent` file to refine agent structure and resolve the identified routing problems.

Do I need Data Cloud access to troubleshoot Agentforce agent behavior?

Yes, you need Data Cloud access to troubleshoot Agentforce agent behavior effectively. Data Cloud provides the necessary insights into production agent performance, which requires familiarity with agent structure and configuration to properly analyze and resolve issues.

How does Data Cloud integration work with Agentforce session tracing?

Data Cloud integration works with Agentforce session tracing by correlating STDM session data with behavioral insights. This combination identifies specific knowledge gaps and performance bottlenecks across production agents to guide precise `.agent` file modifications.

Can I edit the `.agent` file directly to improve agent performance?

Yes, you can edit the `.agent` file directly to improve agent performance. After analyzing session traces and reproducing issues in preview mode, modifying the `.agent` file allows you to correct misroutes and resolve performance bottlenecks.

How do I reproduce Agentforce issues in preview mode before applying fixes?

To reproduce Agentforce issues in preview mode, use the identified session traces and Data Cloud insights to replicate the exact production scenarios. This verifies the reported misroutes and knowledge gaps before you edit the `.agent` file for resolution.