Platform Tracing — Agentforce Configure
Generate 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).
Scope
- In scope: Generating
AgentforcePlatformTracing.settings-meta.xmlto enable or disable Agentforce agent tracing. - Out of scope: Platform Tracing for TraceSpanEvent (use
platform-tracing-configure). Event Log Files. Change Data Capture. Org permission provisioning. Data Cloud provisioning.
Prerequisites
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:
- Data Cloud must be provisioned in the org — trace spans are forwarded to Data Cloud's ingestion pipeline. Without Data Cloud, there is no destination for the spans.
PlatformObservabilityorg permission must be active — this permission gates the feature. It is provisioned (not settable via metadata).- API version 68.0+ — the
AgentforcePlatformTracingSettingstype 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.
Clarifying Questions
Before generating, confirm with the user if not already clear:
- Enable or disable? (Which state do you want for Agentforce agent tracing?)
No other clarification needed — this is a singleton type with one boolean field.
Required Inputs
Gather or infer before proceeding:
- Desired state:
true(enable) orfalse(disable)
Defaults unless specified:
- If user says "enable" or "turn on": set to
true - If user says "disable" or "turn off": set to
false
If the user provides a clear request, generate immediately without unnecessary back-and-forth.
Workflow
-
Warn about prerequisites — inform the user that this feature requires Data Cloud and the
PlatformObservabilityorg permission. -
Read the template — load
assets/AgentforcePlatformTracing-template.xml. -
Generate the settings file — replace
{ENABLED}withtrueorfalsebased on the user's desired state. -
Place the file — output to
settings/AgentforcePlatformTracing.settings-meta.xmlin the project's source directory.
Rules / Constraints
Gotchas
Output Expectations
Deliverables:
settings/AgentforcePlatformTracing.settings-meta.xml
Before delivering, verify:
- XML namespace is exactly
http://soap.sforce.com/2006/04/metadata - File is named
AgentforcePlatformTracing.settings-meta.xml - Only
enableAgentforcePlatformTracingis present (no extra fields)
