关于 platform-tracing-agentforce-configure
用于生成 Salesforce 元数据，以启用或停用将 Agentforce 执行跟踪跨度转发到 Data Cloud。该技能只配置 `enableAgentforcePlatformTracing` 这一布尔设置。
主要功能
- 01设置 Agentforce 跟踪状态
- 02生成跟踪设置元数据
- 03仅配置一个布尔字段
- 04检查 Data Cloud、权限和 API 前置条件
适用场景
- 01将 Agentforce 跟踪转发到 Data Cloud
- 02停止转发 Agentforce 跟踪
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/platform-tracing-agentforce-configure确认已加载。
附带文件assets/AgentforcePlatformTracing-template.xml
详细介绍
Platform Tracing — Agentforce 配置
生成 AgentforcePlatformTracingSettings 元数据，以启用或禁用将 Agentforce Agent 执行跟踪跨度转发到 Data Cloud 的摄取管道。这是一种单例 Settings 类型，包含一个布尔字段，于 API v68.0（Spring '25）中引入。
范围
- 范围内：生成
AgentforcePlatformTracing.settings-meta.xml，以启用或禁用 Agentforce Agent 跟踪。 - 范围外：TraceSpanEvent 的 Platform Tracing（使用
platform-tracing-configure）。事件日志文件。变更数据捕获。组织权限配置。Data Cloud 配置。
前提条件
生成前，请告知用户以下要求。此技能无法检查组织状态，但如果缺少这些前提条件，部署后设置将不会生效：
- 组织必须已配置 Data Cloud — 跟踪跨度会转发到 Data Cloud 的摄取管道。没有 Data Cloud，就没有可接收这些跨度的目标。
- 必须启用
PlatformObservability组织权限 — 此权限控制该功能。该权限由系统配置（无法通过元数据设置）。 - API 版本为 68.0 或更高 —
AgentforcePlatformTracingSettings类型于 Spring '25 引入。使用较旧 API 版本的组织无法识别此类型。
如果用户反馈部署后设置不起作用，最可能的原因是缺少上述某项前提条件。
澄清问题
生成前，如果用户尚未说明清楚，请确认：
- 启用还是禁用？（你希望 Agentforce Agent 跟踪处于哪种状态？）
无需其他澄清 — 这是一种只包含一个布尔字段的单例类型。
必需输入
继续操作前，收集或推断以下信息：
- 所需状态：
true（启用）或false（禁用）
除非另有说明，否则默认值如下：
- 如果用户说“启用”或“打开”：设为
true - 如果用户说“禁用”或“关闭”：设为
false
如果用户提出了明确请求，请立即生成，避免不必要的来回沟通。
工作流
-
提醒前提条件 — 告知用户此功能需要 Data Cloud 和
PlatformObservability组织权限。 -
读取模板 — 加载
assets/AgentforcePlatformTracing-template.xml。 -
生成设置文件 — 根据用户所需状态，将
{ENABLED}替换为true或false。 -
放置文件 — 将文件输出到项目源目录中的
settings/AgentforcePlatformTracing.settings-meta.xml。
规则 / 约束
| 约束 | 原因 |
|---|---|
| 单例 — 每个组织只能有一个文件，且只有一个布尔字段 | 该元数据类型只有一个实例。部署此文件会设置组织范围的首选项。 |
XML 命名空间必须为 http://soap.sforce.com/2006/04/metadata | 使用其他命名空间会导致部署失败。 |
文件必须命名为 AgentforcePlatformTracing.settings-meta.xml | 这是此 Settings 类型的 SFDX 源格式约定。 |
仅包含 enableAgentforcePlatformTracing 字段 | 此类型不存在其他字段。 |
| 需要 API v68.0 或更高版本 | 较旧的组织会拒绝此元数据类型。 |
注意事项
| 问题 | 解决方法 |
|---|---|
| 部署成功，但跟踪未启用 | 组织缺少 PlatformObservability 权限，或尚未配置 Data Cloud。这些由系统配置，无法通过元数据设置。 |
无法识别 AgentforcePlatformTracingSettings 类型 | 组织或工具使用的 API 版本低于 68.0。更新 sfdx-project.json 中的 sourceApiVersion。 |
| 用户将此功能与 Platform Tracing（TraceSpanEvent）混淆 | 说明：此功能会将 Agentforce Agent 执行跨度发送到 Data Cloud。若要发布 TraceSpanEvent，请使用 platform-tracing-configure 技能。 |
输出要求
交付内容：
settings/AgentforcePlatformTracing.settings-meta.xml
交付前，请确认：
- XML 命名空间准确为
http://soap.sforce.com/2006/04/metadata - 文件名为
AgentforcePlatformTracing.settings-meta.xml - 仅包含
enableAgentforcePlatformTracing（无额外字段）
跨技能集成
| 需求 | 委派给 |
|---|---|
| 启用 TraceSpanEvent 发布（Platform Tracing） | platform-tracing-configure skill |
| 在 Data Cloud 中查询或分析现有 Agentforce Agent 跟踪数据 | agentforce-observe skill |
| 设置 Change Data Capture | integration-eventing-cdc-configure skill |
| 配置 ManagedEventSubscription | integration-eventing-subscription-configure skill |
参考文件索引
| 文件 | 阅读时机 |
|---|---|
assets/AgentforcePlatformTracing-template.xml | 步骤 2 — 用于生成设置文件的模板 |