Salesforce Agentforceの会話をエージェント分析にインポートする
Agentforce連携では、Salesforce Agentforceセッション(アクション、トークン、ユーザーフィードバックなど)がエージェント分析に転送されます。インフラストラクチャ内のスケジュール済みジョブが、データクラウドのAgentforceセッショントレーステーブル上でSQLを実行し、各トレースが完了するまで待機した上で[Agent]イベントにマップし、Amplitude HTTP APIに送信します。Amplitudeは次に、セッション、ターン、ツール呼び出しを構築し、組み込みのシグナルを実行します。
この連携は、セッショントレーシングを使用したAgentforceエージェントを対象としています。Einstein Bots と Agentforce 以外のエージェントは対象外です。
AIコーディングエージェントを使用した設定(推奨)
このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、Codex などのAIコーディングエージェントに貼り付けます。エージェントはガイドを取得し、ジョブを構築し、ドライ実行から始めます。
Connect our Agentforce sessions to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/agentforce.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.
エージェントは停止し、推測できない値(ユーザーIDがどのフィールドに保持されているかなど)を尋ねます。 変更を確認し、今すぐ始めるの手順に従って検証します。
必要な対応
- 実行するもの:スケジュール上のジョブ。毎時間実行します。
- 組織が必要とするもの:AgentforceとData Cloudが有効になったエンタープライズエディション、パフォーマンスエディション、無制限エディション、またはデベロッパーエディション。Agentforceセッション トレーシング、およびトークン、モデル、フィードバックに対してAudit and Feedbackを有効にします。
- 必要なもの:
apiおよびcdp_query_apiスコープを持つOAuthクライアント認証情報を使用する外部クライアントアプリ、およびData Cloudユーザー権限を持つ実行ユーザー。 - 発生するコスト:セッショントレーシングのストレージとすべてのクエリが、組織のデータクラウドクレジットを消費します。大規模なバックフィルは実際のコストです。
引き継がれる内容
| データ | 繰り越します |
|---|---|
| Turnsとセッションのグループ化 | はい |
| アクション | はい。name、inputs、outputs、durationを含むツール呼び出しとして |
| モデル、プロバイダー、およびトークン | はい |
| 親指アイコンによるフィードバック | はい、[Agent] Scoreイベントとして |
| コスト | いいえ。Agentforceは、トークンごとではなく、Flexクレジットで請求します。 |
| エスカレーション後のヒューマンエージェントのメッセージ | いいえ、これらはセッショントレーシングには含まれません |
| 実験 | はい、セッション上のフィールドまたは関連するSalesforceレコードにバリアントが保持されている場合。 コーディングエージェントにどのフィールドかを伝えます。 |
Einstein Trust Layerが、ジョブが読み取る保存済みトレースをマスクしていると想定しないでください。
鮮度と限界
- 遅延:セッショントレースの行が反映されるまで数時間から数日かかることがあるため、セッションは終了後数分ではなく数時間経過してからAmplitudeに到着します。これはバッチ連携であり、リアルタイム連携ではありません。
- 未完了のトレース:ジョブは完了するまでトレースを保持します。72時間後、トレースを転送し、不完全としてマークします。
- レート制限:Salesforceの標準API制限が適用されます。
今すぐ始める
Agentforce連携ガイドに従ってください。この手順は、組織に対するスキーマチェックから始まります。 少なくとも1日以上前の期間を対象にドライ実行を行い、ライブイベントとセッションビューアを確認します。その後、同じ期間を再実行して、重複データが追加されないことを確認します。
Guideは、Salesforceのドキュメントに対して2026年10月6日に最後に検証されました。 Salesforce、Agentforce、Data CloudはSalesforceの商標です。 AmplitudeはSalesforceと提携しておらず、また、同社からの承認を受けていません。
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.