Terminal
Terminal/Skill
Turns Agentforce agent trace spans sent to Data Cloud on or off, by generating the AgentforcePlatformTracingSettings settings file.
By Salesforce
Works with
npx skills add forcedotcom/sf-skills --skill platform-tracing-agentforce-configureGenerate AgentforcePlatformTracingSettings metadata to enable or disable forwarding of Agentforce agent execution trace spans to Data Cloud's ingestion pipeline. This is a singleton Settings type with one boolean field introduced in API v68.0 (Spring '25).
AgentforcePlatformTracing.settings-meta.xml to enable or disable Agentforce agent tracing.platform-tracing-configure). Event Log Files. Change Data Capture. Org permission provisioning. Data Cloud provisioning.Before generating, inform the user of these requirements. The skill cannot check org state, but deploying without these prerequisites means the setting has no effect:
PlatformObservability org permission must be active — this permission gates the feature. It is provisioned (not settable via metadata).AgentforcePlatformTracingSettings type was introduced in Spring '25. Orgs on older API versions will not recognize it.If the user reports the setting isn't working after deploy, the most likely cause is a missing prerequisite above.
Before generating, confirm with the user if not already clear:
No other clarification needed — this is a singleton type with one boolean field.
Gather or infer before proceeding:
true (enable) or false (disable)Defaults unless specified:
truefalseIf the user provides a clear request, generate immediately without unnecessary back-and-forth.
Warn about prerequisites — inform the user that this feature requires Data Cloud and the PlatformObservability org permission.
Read the template — load assets/AgentforcePlatformTracing-template.xml.
Generate the settings file — replace {ENABLED} with true or false based on the user's desired state.
Place the file — output to settings/AgentforcePlatformTracing.settings-meta.xml in the project's source directory.
| Constraint | Rationale |
|---|---|
| Singleton — only one file per org, one boolean field | The metadata type has exactly one instance. Deploying the file sets the org-wide preference. |
XML namespace must be http://soap.sforce.com/2006/04/metadata | Any other namespace causes deploy failure. |
File must be named AgentforcePlatformTracing.settings-meta.xml | SFDX source format convention for this Settings type. |
Only include enableAgentforcePlatformTracing field | No other fields exist on this type. |
| Requires API v68.0+ | Older orgs reject the metadata type entirely. |
| Issue | Resolution |
|---|---|
| Deploy succeeds but tracing doesn't activate | Org lacks PlatformObservability permission or Data Cloud is not provisioned. These are provisioned, not settable via metadata. |
AgentforcePlatformTracingSettings type not recognized | Org or tooling is on API version < 68.0. Update sfdx-project.json sourceApiVersion. |
| User confuses this with Platform Tracing (TraceSpanEvent) | Clarify: this sends Agentforce agent execution spans to Data Cloud. For TraceSpanEvent publishing, use the platform-tracing-configure skill. |
Deliverables:
settings/AgentforcePlatformTracing.settings-meta.xmlBefore delivering, verify:
http://soap.sforce.com/2006/04/metadataAgentforcePlatformTracing.settings-meta.xmlenableAgentforcePlatformTracing is present (no extra fields)| Need | Delegate to |
|---|---|
| Enable TraceSpanEvent publishing (Platform Tracing) | platform-tracing-configure skill |
| Query or analyze existing Agentforce agent trace data in Data Cloud | agentforce-observe skill |
| Set up Change Data Capture | integration-eventing-cdc-configure skill |
| Configure ManagedEventSubscription | integration-eventing-subscription-configure skill |
| File | When to read |
|---|---|
assets/AgentforcePlatformTracing-template.xml | Step 2 — template for generating the settings file |