他のツールからエージェントの会話をインポートする

エージェント分析の統合により、会話が既に存在する場所からAmplitudeに取り込まれます。ホスト型プラットフォーム、トレースツール、ウェアハウス、エージェントフレームワークでは、エージェントコードにAmplitude AI SDKは必要ありません。 Gateways、Fireworks、ローカルモデルではそうなります。 各パスが会話をAI SDKが送信するものと同じ[Agent]イベントへと変換するため、セッション、組み込みシグナル、評価ツール、チャートが同じように機能します。

ホスト型プラットフォームでエージェントが実行されている場合、トレースツールがすでにエージェントを記録している場合、会話がウェアハウスに送信されている場合、Cursor Agent SDKがモデルループを実行している場合、またはエージェントフレームワークがすでにOpenTelemetryをエクスポートしている場合に、連携を使用します。ご自身でモデル呼び出しをインストルメントする場合は、Amplitude AI SDKを使用してください。SDKは、コスト、ツールの入力、ユーザーのフィードバックなど、そのパスに関するほとんどの詳細をキャプチャします。 AI SDKを使用してエージェントをインストルメントするを参照してください。

AIコーディングエージェントを使用して設定する

Amplitudeは、コーディングエージェントとエンジニア向けの各プラットフォーム、トレースツール、ウェアハウス、エージェントフレームワークのガイドを作成しています。それぞれに、「パート2:コーディングエージェントの手順」があり、エージェントが最初から最後までその手順に沿って進められます。「連携を選択」の表から、エージェントにソースのページを指定するか、完全なリストを指定します:

GitHubのガイドは公開されており、SDKのインストール不要で機能し、mainを追跡します。これらは@amplitude/ai npmパッケージにも含まれています。インストールされている場合、同じファイルはnode_modules/@amplitude/ai/docs/integrations/の下にあります。

連携の仕組み

インテグレーションは、5つの方法のうちのいずれかで会話を移動します。

  • ホスト型プラットフォームとトレースツール:インフラストラクチャ内のジョブが完了した会話を読み取り、それらを[Agent]イベントにマップし、Amplitude HTTP APIに送信します。Sierraはプッシュもできます。
  • エージェントフレームワーク: このフレームワークはOpenTelemetryをエクスポートします。Amplitudeジョブを実行しません。
  • Cursor Agent SDK:エージェントのフックが、各ライブターンを投稿します。
  • データウェアハウス:Amplitudeは、テーブル行に設定したスケジュールに従ってSQLを実行します。すでにテーブルに保存されているスパンの場合、ジョブはそれらをOTLPエンドポイントにリプレイします。
  • ゲートウェイ、Fireworks、ローカルモデル:Amplitude AI SDKは呼び出しを記録します。Fireworksおよび一部のゲートウェイでは、OpenTelemetryをエクスポートすることもできます。

各連携には、GitHub上にエンジニアとAIコーディングエージェント向けに書かれたステップバイステップのガイドがあります。 コーディングエージェントにガイドのURLを渡すと、連携を構築できます。ここにあるドキュメントページでは、各パスが何をキャプチャするか、開始する前に何を決定すべきかを説明しています。

連携を選択する

ホスト型エージェントプラットフォーム

エージェントのランタイム

LLMトレースツール

エージェントフレームワーク

TypeScriptとJavaでは、ガイドのエクスポーターが書き換えるまで、モデルスパンにはcall_llmという名前が付けられます。GoはメッセージテキストをOpenTelemetryログに書き込みます。Amplitudeはこれを読み取っていません。 エージェントがすでにOpenTelemetry GenAI spanを発行していて、ここに表示されていない場合は、Amplitudeを2番目のOTLPエクスポータとして追加してください。 「OpenTelemetryトレースをAgent分析に送信」を参照してください。

推論ルーター

データウェアハウス

ローカルモデル

ビルドする前に決定する

すべての連携では、ソースデータにこれらの値が必要です。 ガイドは、推測するのではなく、確認を求めます。

  • 会話ID:メッセージを1つのセッションにグループ化するID。 このジョブは、識別子がない会話を送信するのではなく、スキップしてカウントします。
  • ユーザーID:プロダクト分析で送信したものと同じユーザーIDであるため、エージェントセッションはプロダクトデータに組み込まれます。このジョブは、識別子がない会話をスキップします。

連携を確認する

各ガイドは、イベントを送信することなくイベントを構築するdry runから始まります。check-agent-events.mjsスクリプトは@amplitude/ai npmパッケージに含まれており、サンプルをイベントコントラクトと照合します。このインストールでは、SDKがアプリに追加されることはありません。ダウンロードするのではなく、npm install --no-save --ignore-scripts @amplitude/ai && node node_modules/@amplitude/ai/docs/integrations/check-agent-events.mjs events.jsonパッケージから実行します。最初の本番実行後、ライブイベントをチェックし、エージェント分析でセッションを開き、その後同じ期間で再度実行して、重複がないことを確認します。Agent分析のインストルメンテーションを確認を参照してください。

連携ガイドが最後に検証されたのは2026年10月6日です。 Strandsガイドの最終検証日は2026年10月14日です。Google ADK、Vercel AI SDK、Pydantic AI、Mastra、Microsoft Agent Framework、OpenInferenceの各ガイドは、2026年10月28日に最後に検証されました。 Amazon Bedrock AgentCoreガイドの最終検証日は2026年10月27日です。

これは役に立ちましたか?

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.

このページでは