エージェントプラットフォーム追跡

エージェントプラットフォーム追跡の設定

セッションおよびプラットフォームトレースの Data 360 レポートを生成するには、ユーザーが最初に Data 360 とプラットフォームトレースを有効にする必要があります。

1. [設定] で、[クイック検索] ボックスを使用して Einstein 生成 AI を検索します。
2. Einstein生成AIで、[Einstein Audit, Analytics, and Monitoring Setup]をクリックします。
3. Agentforce セッショントレーシングが有効になっていることを確認します。「Set Up Agentforce Session Tracing」を参照してください。
4. [エージェントプラットフォーム追跡] 切り替えまでスクロールしてオンにします。

データモデルはわずか数分でプロビジョニングされます。その後、データ収集はすぐに開始され、5 分間隔で繰り返されます。データ収集を切り替えると、組織のクレジット消費率が増えます。

データ収集を一時停止すると、後で再開できるようにデータが保持されます。レポートには、無効にしてから再度有効にするまでのギャップが表示されます。

サービス担当者セッションとプラットフォーム追跡の Data 360 レポート

KPI とトレンドに関するインサイトを取得するには、エージェントセッショントレースとエンドツーエンドプラットフォームトレースの両方を統合する 1 つの Data 360 レポートを作成します。このレポートは、ほぼリアルタイムのデータに対して実行でき、レコードのグループ化、絞り込み、集計を行い、他のユーザーと共有できます。

エージェントトレーシングには、次のサービスからのスパンが含まれます。

• Apex
• フロー
• プロンプトビルダー
• 呼び出し可能なアクション
• プランナー
• AI ゲートウェイ
• LLM ゲートウェイ
• DC クエリ統合

Data 360 レポートの生成

テレメトリトレーススパンや AI エージェントインタラクションなど、特定のデータモデルオブジェクト (DMO) に関するレポートを作成して、統合データを分析および学習します。

1. Salesforce の [レポート] タブに移動し、[新規レポート] をクリックします。[レポートタイプ] ページが表示されます。
2. 検索バーに、レポートを作成するデータモデルオブジェクト (DMO) の名前を入力します。この場合、[テレメトリー追跡範囲] または [AI エージェントインタラクション] を選択します。
3. 関連するデータモデルオブジェクト内に新しい項目リレーションを作成します。この場合、[Telemetry Trace Span - Telemetry Trace (テレメトリートレース範囲 - テレメトリートレース)] → [ManyToOne] → [AI Agent Interaction - Telemetry Trace (AI エージェントインタラクション - テレメトリートレース)] を選択できます。

   Data 360 では、キー項目を使用して「ソース DMO」から「対象 DMO」への接続を定義することで、DMO 間のリレーションが確立されます。最も頻繁なリレーションの種別は多対一で、ソース DMO の複数のレコードが対象 DMO の 1 つのレコードに対応します。詳細は、「データモデルオブジェクトリレーション」を参照してください。

4. DMO の詳細ページには、[リレーション] タブがあります。このタブには、この DMO に存在するすべてのリレーションが視覚的に構造化されています。[リレーション] タブで新しい DMO リレーションを確認します。

   テレメトリトレース範囲の例

   AI エージェントのインタラクションの例

5. カスタムレポートタイプを作成します。
6. [設定] の [新規カスタムレポート] で [新規カスタムレポート] をクリックします。項目を入力して、新しいカスタムレポートタイプを作成します。この場合は、Session & Platform Traces レポートタイプを作成します。
7. Data Cloud アプリケーションに移動し、[レポート] タブを選択します。
8. Data 360 レポートを作成します。[新規レポート] をクリックし、目的のレポートタイプ ([Session Traces (セッショントレース)] と [Platform Traces (プラットフォームトレース)]) を選択します。
9. [Start Report (レポートを開始)] をクリックします。

レポートを開始すると、各エージェントセッションの一部として記録された相関プラットフォームテレメトリ追跡期間を視覚化できます。

メモ Data 360 レポートでは、実行モードで最大 2,000 行が表示されます。最大 50,000 行をエクスポートできます。詳細は、「Data 360 のレポートとダッシュボード」および「Data Cloud のレポートとダッシュボード: 制限」を参照してください。

エージェントプラットフォーム追跡のデータモデル

これらの機能を有効にすると、Data 360 データストリーム、データレークオブジェクト (DLO)、データモデルオブジェクト (DMO) が自動的に生成されます。このデータは、「監査と監視」で指定されたデータスペース内で作成されます。

Observability Spans データストリーム

Observability Spans データストリームは自動的に作成され、追跡データが取得されます。

Observability Spans Data Lake Object (オブザーバビリティがデータレークオブジェクトにまたがる)

ObservabilitySpans という新しい DLO が次の項目を使用して作成されます。

テレメトリトレーススパンデータモデルオブジェクト

次の項目を使用して、Telemetry Trace Span という新しい DMO が作成されます。

SOQL の例

DLO SOQL

SELECT attributes__c, cdp_sys_PartitionDate__c, cdp_sys_SourceVersion__c, DataSource__c, DataSourceObject__c, 
durationNanos__c, endDateTime__c, InternalOrganization__c, KQ_parentSpanId__c, KQ_spanId__c 
FROM ObservabilitySpans__dll LIMIT 100

DMO SOQL

SELECT ssot__DataSourceId__c, ssot__DataSourceObjectId__c, ssot__DurationNumber__c, ssot__EndDateTime__c, 
ssot__InternalOrganizationId__c, KQ_TelemetryParentSpanId__c, KQ_Id__c, ssot__OperationName__c, ssot__ServiceName__c, 
ssot__SpanKind__c FROM ssot__TelemetryTraceSpan__dlm LIMIT 100

トレースの例

  Trace ID: a744ad5ccf0f61c2                                                                                                    
   
  run.interaction [Atlas Reasoning Engine] [ROOT]                                                                               
  (spanId: 9dcc09221a05d4cf)
  │
  ├── run.action.AnswerQuestionsWithKnowledge_179gL0000019Ah7 [Atlas Reasoning Engine]
  │   (spanId: 90a3808ba7a67fe8)
  │   │
  │   └── run.invokeActions.STREAM_KNOWLEDGE_SEARCH [InvocableAction]
  │       (spanId: 95499b41725eb82a)
  │       │
  │       └── run.einstein_gpt__answerWithKnowledge.1 [PromptTemplate]
  │           (spanId: a9a8b8f2e1fd35cb)
  │           📋 Attributes:
  │              • prompt_template.execution.api.version: 66.0
  │              • prompt_template.execution.step: 66.0
  │              • prompt_template.api.name: einstein_gpt__answerWithKnowledge
  │              • prompt_template.api.version: 1
  │           │
  │           └── run.invokeActions.EINSTEIN_RETRIEVER_GET_RESULTS [InvocableAction]
  │               (spanId: 82559a5dedaff638)
  │               │
  │               ├── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │   (spanId: 934afceaac15c6d4)
  │               │   📋 Attributes:
  │               │      • prompt_template.step.start_time: 1774049705404
  │               │      • prompt_template.step.end_time: 1774049705430
  │               │      • prompt_template.step: resolve_template
  │               │   │
  │               │   └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │       (spanId: b93e831b1c492cf9)
  │               │       📋 Attributes:
  │               │          • prompt_template.step.start_time: 1774049705447
  │               │          • prompt_template.step.end_time: 1774049705449
  │               │          • prompt_template.step: mask_template
  │               │       │
  │               │       └── run.step.einstein_gpt__answerWithKnowledge [PromptTemplate]
  │               │           (spanId: 8380c9b813f64afa)
  │               │           📋 Attributes:
  │               │              • prompt_template.step.start_time: 1774049705500
  │               │              • prompt_template.step.end_time: 1774049705502
  │               │              • prompt_template.step: generation
  │               │
  │               └── run.retriever.File_ADL_File_ADL_1Cx_Xl7d6d114de [Einstein AI Gateway]
  │                   (spanId: a0f6b9721e1049a3)
  │                   📋 Attributes:
  │                      • retriever.numberofresults: 10
  │                      • retriever.isadvancedmode: False
  │                      • retriever.retrievername: File_ADL_File_ADL_1Cx_Xl7d6d114de
  │                   │
  │                   └── run.hybridsearch.ADL_File_ADL_index__dlm [Data Cloud]
  │                       (spanId: 86aa7512858c1aa9)
  │
  ├── run.topic.GeneralFAQ_16jgL000001ATzR [Atlas Reasoning Engine]
  │   (spanId: a3709c000d5d6a2e)
  │   │
  │   ├── run.llmstep [Atlas Reasoning Engine]
  │   │   (spanId: 9829763b4362466f)
  │   │
  │   ├── run.llmstep [Atlas Reasoning Engine]
  │   │   (spanId: 9a29b1009ea0f4c6)
  │   │
  │   └── run.llmstep [Atlas Reasoning Engine]
  │       (spanId: bf63506e4fccff9f)
  │
  └── run.llmstep [Atlas Reasoning Engine]
      (spanId: 9f31edde2c62d1dc)
  Summary:
  - 15 total spans in this trace
  - 5 spans with attributes (marked with 📋)
  - 10 spans without attributes
  - All spans share trace ID: a744ad5ccf0f61c2