Agentforce セッション トレーシングのデータ モデル
これらの DLO/DMO のデータを使用して、エージェントの行動に関するインサイトを提供するレポート、ダッシュボード、クエリを作成します。
必要なエディション
| 使用可能なエディション: Einstein for Sales、Einstein for Platform、Einstein for Service、Einstein 1 Service、または Einstein GPT Service アドオンが付属する Enterprise Edition、Performance Edition、および Unlimited Edition。アドオンを購入するには、Salesforce アカウントエグゼクティブにお問い合わせください。 |
Agentforce セッショントレーシングデータモデルについて
Agentforce セッション トレーシングのデータ モデルは、エージェントの動作に関する詳細なセッション トレーシング ログが含まれる Data Lake Objects(DLO; データ レイク オブジェクト)と Data Model Objects(DMO; データ モデル オブジェクト)のコレクションです。データモデルには、フィードバックデータまたはガードレール総計値との結合をサポートするために推論エンジンで実行するすべての LLM コールへの参照も含まれます。データは Data 360 の DLO にストリーミングされ、該当する DMO にマッピングされます。
Agentforce セッショントレーシングデータモデル ERD
| DLO/DMO | 説明 |
|---|---|
AIAgentSession
|
1 人以上の AI エージェントとの連続するインタラクションを取得する包括的なコンテナを表します。通常のセッションは、顧客が最初の質問をしたときに開始し、エージェントのチャットウィンドウを閉じると終了します。 |
AIAgentSessionParticipant
|
AIAgentSession に参加するエンティティ (人間または AI) を表します。 |
AIAgentInteraction
|
セッション内のセグメントを表します。通常、ユーザーの要求で始まり、AI エージェントがその要求に応答したときに終了します。 |
AIAgentInteractionStep
|
ユーザーの要求を満たすためにインタラクション中に実行される個別のアクションまたは操作を表します。 |
AIAgentInteractionMessage
|
セッション中にユーザーが提供した、または AI エージェントが生成した 1 つのコミュニケーションを表します。 |
エンティティ間のリレーションを次に示します。
| DLO/DMO | 説明 |
|---|---|
AIAgentSession: AIAgentInteraction |
1: 多 (1 つのセッションに多数のインタラクションがある) |
AIAgentSession: AIAgentSessionParticipant |
1: 多 (1 つのセッションに多数の参加者が含まれる) |
AIAgentInteraction: AIAgentInteractionMessage
|
1: 多 (1 つのインタラクションに多数のメッセージがある) |
AIAgentInteraction: AIAgentInteractionStep
|
1: 多 (1 つのインタラクションに多数のステップがある) |
AIAgentInteractionMessage : AIAgentSessionParticipant |
多: 1 (各メッセージに送信者参加者が 1 人いる)。 また、スレッドの [ |
AI エージェントセッション DMO
エージェントセッションレベルの詳細を取得する Data Cloud DMO。AIAgentSession オブジェクトには次の属性があります。
| 項目表示ラベル | 項目の API 参照名 | データ型 | 説明 |
|---|---|---|---|
AI Agent Session Id
|
Id
|
テキスト | プライマリキー。 |
Start Timestamp
|
StartTimestamp
|
日付 - 時間 | セッションが開始されたときのタイムスタンプ。 |
End Timestamp
|
EndTimestamp
|
日付 - 時間 | セッションが終了またはタイムアウトしたタイムスタンプ。 |
Variable
|
VariableText
|
テキスト | 将来の使用のために予約されています。インタラクション中にエージェントが使用するコンテキストセッションデータのキーと値のペア。 |
Session Owner
|
SessionOwnerId
|
テキスト | 将来の使用のために予約されています。セッションを開始した関係者のレコードの ID。 |
Session Owner Object
|
SessionOwnerObject
|
テキスト | 将来の使用のために予約されています。セッション所有者レコードが属する DMO の名前。 例: |
Individual
|
IndividualId
|
テキスト - 参照 ID (ルックアップ) | 将来の使用のために予約されています。セッション所有者関係者を表す個人レコードへの参照。SessionOwnerObjectが Individual の場合にのみ入力されます。 |
AI Agent Channel Type
|
AiAgentChannelTypeId
|
テキスト - 参照 ID (ルックアップ) | セッションが開始された通信チャネルの種別。 |
Related Voice Call
|
VoiceCallId
|
テキスト - 参照 ID (ルックアップ) | セッションを開始した音声通話にセッションをリンクする ID。 |
Related Messaging Session
|
MessagingSessionId
|
テキスト - 参照 ID (ルックアップ) | AI エージェントセッションを、AI エージェントセッションが開始されたメッセージングセッションにリンクする ID。 |
Previous Session Id
|
PreviousSessionId
|
テキスト - 参照 ID (ルックアップ) | 将来の使用のために予約されています。以前の AI エージェントセッションへの参照。マルチエージェントセッションシナリオに適用されます。 |
AI Agent Session End Type
|
AiAgentSessionEndType
|
テキスト - 参照 ID (ルックアップ) | セッションの終了方法。 値の例: |
AI エージェントセッション参加者 DMO
セッションに関連付けられたユーザー (取引先責任者、リード、取引先など) に関する詳細を取得する Data Cloud DMO。AIAgentSessionParticipant オブジェクトには次の属性があります。
| 項目表示ラベル | 項目の API 参照名 | データ型 | 説明 |
|---|---|---|---|
AI Agent Session Participant Id
|
Id
|
テキスト | プライマリキー。 |
AI Agent Session
|
AiAgentSessionId
|
テキスト → 参照 → ID (親) | この参加者が関与した特定の AiAgentSession への参照。 |
AI Agent Type
|
AiAgentTypeId
|
テキスト → 参照 → ID (ルックアップ) | AI エージェントの種別。 値の例: |
AI Agent Template Api Name
|
AiAgentTemplateApiName
|
テキスト | エージェントの作成に使用するテンプレート。 |
Start Timestamp
|
Date - Time
|
日付 - 時間 | 参加者がセッションに参加したときのタイムスタンプ。 |
End Timestamp
|
Date - Time
|
日付 - 時間 | 参加者がセッションから退席したか、セッションでのやり取りを停止したタイムスタンプ。 |
Participant Attribute
|
ParticipantAttributeText
|
テキスト | 将来の使用のために予約されています。このセッションに固有の参加者の追加メタデータまたは属性を表す JSON キーと値のペア。 |
Participant
|
ParticipantId
|
テキスト | セッションに関与する関係者を表すレコードへの参照。 |
Participant Object
|
ParticipantObject
|
テキスト | 関係者レコードが属する DMO の名前。 値の例: |
AI Agent Version Api Name
|
AiAgentVersionApiName
|
テキスト | AI エージェントバージョンの API 参照名。参加者が AI エージェントの場合にのみ入力されます。 |
AI Agent Api Name
|
AiAgentApiName
|
テキスト | AI エージェントの API 参照名。参加者が AI エージェントの場合にのみ入力されます。 |
Individual
|
IndividualId
|
テキスト → 参照 → ID (ルックアップ) | 将来の使用のために予約されています。関係者を表す個人レコードへの参照。関係者レコードの DMO タイプが Individual の場合に入力されます。 |
AI Agent Session Participant Role
|
AiAgentSessionParticipantRoleId
|
テキスト → 参照 → ID (ルックアップ) | セッション内の参加者の役割を定義します。 値の例: |
AI エージェントインタラクション DMO
インタラクションに関連付けられたターンバイターンの詳細を取得する Data Cloud DMO。AIAgentInteraction オブジェクトには次の属性があります。
| 項目表示ラベル | 項目の API 参照名 | データ型 | 説明 |
|---|---|---|---|
AI Agent Interaction Id
|
Id
|
テキスト | 主キー。 |
AI Agent Session
|
AiAgentSessionId
|
テキスト → 参照 → ID (親) | このインタラクションが発生した親セッションへの参照。 |
Previous Interaction
|
PrevInteractionId
|
テキスト → 参照 → ID (ルックアップ) | 前のインタラクションへの参照。インタラクションのシーケンスまたはチェーンを有効にします。 |
Ai Agent Interaction Type
|
AiAgentInteractionTypeId
|
テキスト → 参照 → ID (ルックアップ) | インタラクション種別を分類します。 例: |
Start Timestamp
|
StartTimestamp
|
日付 - 時間 | インタラクションが開始されたタイムスタンプ。 |
End Timestamp
|
EndTimestamp
|
日付 - 時間 | インタラクションが完了したときのタイムスタンプ。 |
Attributes
|
AttributeText
|
テキスト | インタラクションに固有の追加のメタデータまたはコンテキスト情報を保存する JSON キーと値のペア。 |
Telemetry Trace
|
TelemetryTraceId
|
テキスト | 分散トレースに使用される識別子。システムコンポーネント間のやりとりを追跡できます。 |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
テキスト → 参照 → ID (ルックアップ) | より大きな分散トレーシングコンテキスト内でこの特定のインタラクションをトレースするためのスパン識別子。 |
Session Owner
|
SessionOwnerId
|
テキスト | 将来の使用のために予約されています。セッションを開始した (所有した) 参加者のレコードの ID。 |
Session Owner Object
|
SessionOwnerObject
|
テキスト | 将来の使用のために予約されています。セッション所有者レコードが属する DMO の名前。 例: |
Individual
|
IndividualId
|
テキスト → 参照 → ID (ルックアップ) | 将来の使用のために予約されています。セッション所有者関係者を表す個人レコードへの参照。SessionOwnerObjectが Individual の場合にのみ入力されます。 |
Topic Api Name
|
TopicApiName
|
テキスト | インタラクションに分類されたトピックの API 参照名。 |
AI エージェントインタラクションメッセージ DMO
セッションインタラクションメッセージに関する詳細を取得する Data Cloud DMO。AIAgentInteractionMessage オブジェクトには次の属性があります。
| 項目表示ラベル | 項目の API 参照名 | データ型 | 説明 |
|---|---|---|---|
AI Agent Interaction Message Id
|
Id
|
テキスト | プライマリキー。 |
AI Agent Interaction
|
AiAgentInteractionId
|
テキスト → 参照 → ID (親) | このメッセージが属するインタラクションへの参照。 |
AI Agent Session Participant
|
AiAgentSessionParticipantId
|
テキスト → 参照 → ID (ルックアップ) | メッセージを送信した参加者への参照。 |
Parent Message
|
ParentMessageId
|
テキスト → 参照 → ID (ルックアップ) | 別のメッセージへの参照。このメッセージが返信または続行の場合に入力されます。 |
AI Agent Interaction Message Type
|
AiAgentInteractionMessageTypeId
|
テキスト → 参照 → ID (ルックアップ) | メッセージの種別。 値の例: |
Message Sent Timestamp
|
MessageSentTimestamp
|
日付 - 時間 | メッセージが送信された正確な時刻。 |
Ai Agent Interaction Msg Content Type
|
AiAgentInteractionMsgContentTypeId
|
テキスト → 参照 → ID (ルックアップ) | メッセージコンテンツの形式または種別。 例: text/plain、application/json、 audio/wav |
Content
|
ContentText
|
テキスト | メッセージがテキストベースの場合はテキストコンテンツ。それ以外の場合、項目には NA が含まれます。 |
AI Agent Session
|
AiAgentSessionId
|
テキスト → 参照 → ID (ルックアップ) | このメッセージが属するセッションへの参照。 |
Session Owner
|
SessionOwnerId
|
テキスト | 将来の使用のために予約されています。セッションを開始した参加者 (所有者) のレコードの ID。 |
Session Owner Object
|
SessionOwnerObject
|
テキスト | 将来の使用のために予約されています。セッション所有者レコードが属する DMO の名前。 例: |
Individual
|
IndividualId
|
テキスト → 参照 → ID (ルックアップ) | 将来の使用のために予約されています。個人レコードへの参照。セッション所有者関係者を表します。SessionOwnerObjectが Individual の場合にのみ入力されます。 |
AI エージェントインタラクションステップ DMO
インタラクションステップの詳細を取得する Data Cloud DMO。AIAgentInteractionStep オブジェクトには次の属性があります。
| 項目表示ラベル | 項目の API 参照名 | データ型 | 説明 |
|---|---|---|---|
AI Agent Interaction Step Id
|
Id
|
テキスト | プライマリキー。 |
AI Agent Interaction
|
AiAgentInteractionId
|
テキスト → 参照 → ID (親) | このステップが属するインタラクションへの参照。 |
Previous Step
|
PrevStepId
|
テキスト → 参照 → ID (ルックアップ) | 将来の使用のために予約されています。前のインタラクションへの参照。インタラクションのシーケンスまたはチェーンを有効にします。 |
Ai Agent Interaction Step Type
|
AiAgentInteractionStepTypeId
|
テキスト → 参照 → ID (ルックアップ) | ステップ種別を分類します。 値の例: |
Start Timestamp
|
StartTimestamp
|
日付 - 時間 | ステップの実行が開始されたタイムスタンプ。 |
End Timestamp
|
EndTimestamp
|
日付 - 時間 | ステップの実行が完了したときのタイムスタンプ。 |
Pre-step Variables
|
PreStepVariableText
|
テキスト | 将来の使用のために予約されています。ステップの実行が開始される前の関連変数の状態。 |
Post-step Variables
|
PostStepVariableText
|
テキスト | 将来の使用のために予約されています。ステップ実行終了後の変数の状態。 |
Input Value
|
InputValueText
|
テキスト | ステップに提供される入力データ。 |
Output Value
|
OutputValueText
|
テキスト | ステップの実行結果の出力データ。 |
Error Message
|
ErrorMessageText
|
テキスト | ステップの実行で問題または例外が発生した場合のエラーの詳細。 |
Attributes
|
AttributeText
|
テキスト | ステップの追加のメタデータまたはプロパティを表す JSON キーと値のペア。 |
Telemetry Trace Span
|
TelemetryTraceSpanId
|
テキスト → 参照 → ID (ルックアップ) | 分散トレースに使用される識別子。このステップをより広範なトレースコンテキスト内で関連付けます。 |
Generation
|
GenerationId
|
テキスト | ステップが LLM 生成要求を行った場合の GenAiGeneration レコードへの参照。 |
Gen AI Gateway Request
|
GenAiGatewayRequestId
|
テキスト | ステップが LLM 生成要求を行った場合の GenAiGatewayRequest レコードへの参照。 |
Gen AI Gateway Response
|
GenAiGatewayResponseId
|
テキスト | 関連するステップで LLM 生成要求を行う場合は GenAiGatewayResponse レコードを参照します。 |
Name
|
Name
|
テキスト | AI エージェントが実行するステップの名前。たとえば、ステップ種別がアクションの場合、[名前] がアクション名になります。 |

