platform-tracing-agentforce-configure

Platform Tracing — Agentforce の設定

AgentforcePlatformTracingSettings メタデータを生成し、Agentforce エージェントの実行トレーススパンを Data Cloud の取り込みパイプラインに転送するかどうかを有効または無効にします。これは API v68.0（Spring '25）で導入された、ブール型フィールドを 1 つ持つシングルトンの Settings 型です。

対象範囲

• 対象範囲内: AgentforcePlatformTracing.settings-meta.xml を生成し、Agentforce のエージェントトレースを有効または無効にします。
• 対象範囲外: TraceSpanEvent の Platform Tracing（platform-tracing-configure を使用）。イベントログファイル。Change Data Capture。組織の権限プロビジョニング。Data Cloud のプロビジョニング。

---

前提条件

生成する前に、次の要件をユーザーに伝えてください。このスキルでは組織の状態を確認できませんが、これらの前提条件が満たされていない状態でデプロイしても、設定は効果を発揮しません。

1. 組織で Data Cloud がプロビジョニング済みであること — トレーススパンは Data Cloud の取り込みパイプラインに転送されます。Data Cloud がなければ、スパンの送信先がありません。
2. PlatformObservability 組織権限が有効であること — この権限によって機能の使用が制御されます。この権限はプロビジョニングされるものであり、メタデータでは設定できません。
3. API バージョン 68.0 以降であること — AgentforcePlatformTracingSettings 型は Spring '25 で導入されました。古い API バージョンの組織では、この型は認識されません。

デプロイ後に設定が機能しないとユーザーから報告された場合、最も可能性が高い原因は、上記の前提条件が満たされていないことです。

---

確認事項

生成する前に、まだ明確でない場合はユーザーに確認してください。

• 有効にしますか、それとも無効にしますか？（Agentforce エージェントのトレースをどの状態にしますか？）

これはブール型フィールドを 1 つ持つシングルトン型のため、ほかに確認することはありません。

---

必須入力

続行する前に、次の情報を収集するか、推定してください。

• 希望する状態: true（有効）または false（無効）

指定がない場合のデフォルト:

• ユーザーが「有効にする」または「オンにする」と述べた場合: true に設定します
• ユーザーが「無効にする」または「オフにする」と述べた場合: false に設定します

ユーザーの依頼が明確であれば、不要なやり取りをせず、すぐに生成してください。

---

ワークフロー

1. 前提条件について警告する — この機能には Data Cloud と PlatformObservability 組織権限が必要であることをユーザーに伝えます。

2. テンプレートを読み込む — assets/AgentforcePlatformTracing-template.xml を読み込みます。

3. 設定ファイルを生成する — ユーザーが希望する状態に基づいて、{ENABLED} を true または false に置き換えます。

4. ファイルを配置する — プロジェクトのソースディレクトリ内の settings/AgentforcePlatformTracing.settings-meta.xml に出力します。

---

ルール／制約

制約	理由
シングルトン — 組織ごとにファイルは 1 つのみで、ブール型フィールドも 1 つ	このメタデータ型にはインスタンスが 1 つだけ存在します。このファイルをデプロイすると、組織全体の設定が適用されます。
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 エージェントの実行スパンを 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 スキル
Data Cloud にある既存の Agentforce エージェントのトレースデータをクエリまたは分析する	agentforce-observe スキル
Change Data Capture を設定する	integration-eventing-cdc-configure スキル
ManagedEventSubscription を設定する	integration-eventing-subscription-configure スキル

---

参考ファイル一覧

ファイル	参照するタイミング
assets/AgentforcePlatformTracing-template.xml	ステップ 2 — 設定ファイル生成用テンプレート