skills.rest
padjei
padjeiCOMMUNITY
Explore all skills by this author →
GitHub

platform-tracing-agentforce-configure

Generate AgentforcePlatformTracingSettings metadata to enable Agentforce agent trace spans in Data Cloud.

Updated Jul 2, 2026
Search Tags:#observability#metadata#tracing#settings#salesforce#agentforce#data cloud
One-click install
npx skills add https://github.com/padjei/SF_Build --skill platform-tracing-agentforce-configure-padjei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: platform-tracing-agentforce-configure
Source: https://github.com/padjei/SF_Build/tree/main/.claude/skills/platform-tracing-agentforce-configure
Command: npx skills add https://github.com/padjei/SF_Build --skill platform-tracing-agentforce-configure-padjei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Configuring Agentforce agent execution tracing requires hand-writing a specific Salesforce Settings metadata file with the correct XML namespace, file naming, and API version, and mistakes cause silent deploy failures or non-functional tracing. ## Core Features & Use Cases - Settings File Generation: Produces AgentforcePlatformTracing.settings-meta.xml from a template with the correct namespace and the single enableAgentforcePlatformTracing boolean field. - Prerequisite Guidance: Warns that Data Cloud provisioning, the PlatformObservability org permission, and API v68.0+ are required for tracing to actually work. - Use Case: An admin wants Agentforce agent execution spans flowing into Data Cloud for observability. The skill generates the deployable settings file with tracing enabled and explains why spans may not appear if prerequisites are missing. ## Quick Start Ask the assistant to enable Agentforce platform tracing and generate the settings metadata file for your Salesforce project.

Frequently Asked Questions about platform-tracing-agentforce-configure

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

FAQPage Schema
How do I enable Agentforce agent tracing in Salesforce?▼

Deploy an AgentforcePlatformTracing.settings-meta.xml file with enableAgentforcePlatformTracing set to true. The org must also have Data Cloud provisioned and the PlatformObservability permission active for trace spans to flow.

What API version is required for AgentforcePlatformTracingSettings?▼

AgentforcePlatformTracingSettings requires API version 68.0 (Spring '25) or higher. Orgs or tooling on older versions reject the metadata type entirely, so update sourceApiVersion in sfdx-project.json.

Why is Agentforce tracing not working after deploying the settings file?▼

The most common cause is a missing prerequisite: Data Cloud is not provisioned or the PlatformObservability org permission is not active. Both are provisioned at the org level and cannot be set via metadata.

What is the difference between Agentforce tracing and Platform Tracing TraceSpanEvent?▼

AgentforcePlatformTracingSettings forwards Agentforce agent execution spans to Data Cloud's ingestion pipeline. Platform Tracing for TraceSpanEvent is a separate feature configured through a different metadata type and skill.

Can AgentforcePlatformTracingSettings have multiple instances or fields?▼

No, it is a singleton Settings type with exactly one boolean field, enableAgentforcePlatformTracing. Only one file exists per org, and including extra fields or a wrong namespace causes deploy failure.

Related Skills

Explore More Software Engineering Skills→
angryracoonangryracoon

platform-tracing-agentforce-configure

Generate AgentforcePlatformTracing settings metadata to enable or disable trace forwarding to Data Cloud.

Community
Intermediate
dmckeeSFdmckeeSF

observing-agentforce

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

Community
Advanced
padjeipadjei

platform-tracing-configure

Generate EventSettings metadata to enable or disable Platform Tracing in Salesforce Event Monitoring.

Community
Basic
Avila-TekAvila-Tek

domain-model-generator

Generate and update docs/domain_model.md from project context and logs.

Official
Advanced