用途:生成 AgentforcePlatformTracing.settings-meta.xml 元数据,用于启用或禁用将 Agentforce 智能体执行追踪跨度(trace spans)转发到 Data Cloud 的摄取管道。该类型为单例 Settings,只有一个布尔字段,于 API v68.0(Spring '25)引入。
主要能力:按用户意图将 enableAgentforcePlatformTracing 设为 true(启用)或 false(禁用),并输出到项目的 settings/AgentforcePlatformTracing.settings-meta.xml。
必要用法:先确认启用还是禁用;读取 assets/AgentforcePlatformTracing-template.xml 模板;用 true/false 替换 {ENABLED};文件放到源目录的 settings/ 下。若用户已表达清楚,直接生成,无需反复确认。
限制与前置条件:需要组织中已开通 Data Cloud(否则追踪跨度没有目标);需要生效 PlatformObservability 组织权限(通过配置开通,不能通过元数据设置);需要 API v68.0+(旧版本无法识别该类型)。部署成功但追踪未生效,通常是因为缺少上述前置条件。文件命名必须为 AgentforcePlatformTracing.settings-meta.xml,XML 命名空间必须为 http://soap.sforce.com/2006/04/metadata,且只能包含 enableAgentforcePlatformTracing 一个字段。
范围说明:不包括 TraceSpanEvent 的平台追踪(应使用 platform-tracing-configure)、事件日志文件、Change Data Capture、组织权限开通及 Data Cloud 开通。若用户把本功能与 TraceSpanEvent 发布混淆,需说明本技能是向 Data Cloud 发送 Agentforce 智能体执行跨度。
交付前检查:命名空间正确、文件名正确、仅含单个字段。其余细节暂未提供。