
Observing Agentforce
This is the monitoring and debugging counterpart to agent development. It queries Salesforce Data Cloud's Session Trace Data Model to pull real production conversation logs, then lets you reproduce issues locally with `sf agent preview` and fix them by editing the .agent file directly. The workflow is observe, reproduce, improve. If your org doesn't have STDM enabled, it falls back to running test suites and analyzing local traces instead. The skill resolves agent names against the org metadata, handles the double-nesting bug in `sf project retrieve`, and walks you through the three-phase loop. Use this when production agents are misbehaving and you need actual session data to figure out why, not when you're writing new agents from scratch.
- skills.sh installs
- 3.6K
- GitHub stars
- 1.2K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add forcedotcom/sf-skills --skill observing-agentforce --agent claude-codeInstalls into .claude/skills of the current project.
Files
This is the monitoring and debugging counterpart to agent development. It queries Salesforce Data Cloud's Session Trace Data Model to pull real production conversation logs, then lets you reproduce issues locally with `sf agent preview` and fix them by editing the .agent file directly. The workflow is observe, reproduce, improve. If your org doesn't have STDM enabled, it falls back to running test suites and analyzing local traces instead. The skill resolves agent names against the org metadata, handles the double-nesting bug in `sf project retrieve`, and walks you through the three-phase loop. Use this when production agents are misbehaving and you need actual session data to figure out why, not when you're writing new agents from scratch.
Browse the repository on GitHubSponsors
Details
- Repository
- github.com/forcedotcom/sf-skills
- Categories
- Testing & QA, Git & Pull Requests, AI & Agent Building, Debugging, Cloud & Infrastructure
- First seen
- Jun 3, 2026
More from forcedotcom/sf-skills
All 158- Uplifting Components To Slds23.6K
- Searching Media3.6K
- Using Ui Bundle Salesforce Data3.6K
- Implementing Ui Bundle File Upload3.5K
- Implementing Ui Bundle Agentforce Conversation Client3.5K
- Creating B2b Commerce Store3.3K
- Generating Lwc Components3.1K
- Querying Soql3K
- Debugging Apex Logs3K
- Deploying Metadata3K
- Fetching Salesforce Docs3K
- Running Apex Tests3K
- Handling Sf Data2.9K
- Building Sf Integrations2.9K
- Generating Mermaid Diagrams2.8K
- Configuring Connected Apps2.8K
- Generating Visual Diagrams2.8K
- Getting Datacloud Schema2.6K
- Developing Datacloud Code Extension2.5K
- Retrieving Datacloud2.5K
- Connecting Datacloud2.5K
- Activating Datacloud2.5K
- Harmonizing Datacloud2.5K
- Orchestrating Datacloud2.5K