他のツールからエージェントの会話をインポートする
エージェント分析の統合により、会話が既に存在する場所からAmplitudeに取り込まれます。ホスト型プラットフォーム、トレースツール、ウェアハウス、エージェントフレームワークでは、エージェントコードにAmplitude AI SDKは必要ありません。 Gateways、Fireworks、ローカルモデルではそうなります。 各パスが会話をAI SDKが送信するものと同じ[Agent]イベントへと変換するため、セッション、組み込みシグナル、評価ツール、チャートが同じように機能します。
ホスト型プラットフォームでエージェントが実行されている場合、トレースツールがすでにエージェントを記録している場合、会話がウェアハウスに送信されている場合、Cursor Agent SDKがモデルループを実行している場合、またはエージェントフレームワークがすでにOpenTelemetryをエクスポートしている場合に、連携を使用します。ご自身でモデル呼び出しをインストルメントする場合は、Amplitude AI SDKを使用してください。SDKは、コスト、ツールの入力、ユーザーのフィードバックなど、そのパスに関するほとんどの詳細をキャプチャします。 AI SDKを使用してエージェントをインストルメントするを参照してください。
AIコーディングエージェントを使用して設定する
Amplitudeは、コーディングエージェントとエンジニア向けの各プラットフォーム、トレースツール、ウェアハウス、エージェントフレームワークのガイドを作成しています。それぞれに、「パート2:コーディングエージェントの手順」があり、エージェントが最初から最後までその手順に沿って進められます。「連携を選択」の表から、エージェントにソースのページを指定するか、完全なリストを指定します:
- ガイドのインデックス:https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
- 機械可読リスト:https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/manifest.json
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を渡すと、連携を構築できます。ここにあるドキュメントページでは、各パスが何をキャプチャするか、開始する前に何を決定すべきかを説明しています。
連携を選択する
ホスト型エージェントプラットフォーム
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| Sierra | Sierra | Sierraがプッシュするか、またはジョブがエクスポートをプルします | モデル、トークン、およびコスト |
| Decagon | Decagon | スケジュールされたジョブはエクスポートをプルします。 | モデル、トークン、コスト、およびツールの呼び出し |
| IntercomによるFin | Fin | スケジュールされたジョブが会話をプルします | モデル、トークン、コスト、およびツールの入力と出力 |
| Salesforce Agentforce | Agentforce | スケジュールされたジョブがデータクラウドに対してクエリを実行します | コスト |
エージェントのランタイム
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| Cursor Agent SDK | Cursor Agent SDK | エージェント内のフックが各ライブターンを投稿します。 | ターンあたりのコスト |
LLMトレースツール
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| Langfuse | Langfuse | スケジュールされたジョブはセッションをプルします。 | Langfuseのスコア |
| LangSmith | LangSmith | スケジュールされたジョブはスレッドをプルします | LangSmithフィードバックスコア |
| Braintrust | Braintrust | スケジュールされたジョブは、プロジェクトログで SQL を実行します。 | コストとBraintrustスコア |
エージェントフレームワーク
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| AWS Strands(Python) | AWS Strands | StrandsはネイティブのOTLP/HTTPをエクスポートします | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Google ADK | Google ADK | ADKはネイティブOTLP/HTTPをエクスポートします | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Vercel AI SDK | Vercel AI SDK | Vercel AI SDKはネイティブのOTLP/HTTPをエクスポートします。 | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Pydantic AI | Pydantic AI | Pydantic AIはネイティブのOTLP/HTTPをエクスポートします。 | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Mastra | Mastra | MastraはネイティブのOTLP/HTTPをエクスポートします。 | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Microsoft Agent Framework | Microsoft Agent Framework | このフレームワークはネイティブのOTLP/HTTPをエクスポートします。 | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| OpenInference | OpenInference | Agno、smolagents、DSPy、Haystack、Google GenAI SDK、AutoGen | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
| Amazon Bedrock AgentCore | Amazon Bedrock AgentCore | CloudWatchに加えてOTLP/HTTPを追加します。 | [Agent] Session End、HTTP経由でも別途送信する場合は除く |
TypeScriptとJavaでは、ガイドのエクスポーターが書き換えるまで、モデルスパンにはcall_llmという名前が付けられます。GoはメッセージテキストをOpenTelemetryログに書き込みます。Amplitudeはこれを読み取っていません。 エージェントがすでにOpenTelemetry GenAI spanを発行していて、ここに表示されていない場合は、Amplitudeを2番目のOTLPエクスポータとして追加してください。 「OpenTelemetryトレースをAgent分析に送信」を参照してください。
推論ルーター
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| OpenRouter、LiteLLM、または Requesty | AIゲートウェイとルーター | AI SDK、またはゲートウェイのOTLPエクスポート | パスに依存します。 |
| Fireworks AI | Fireworks AI | AI SDK、またはOpenTelemetryエクスポート | AI SDKには何もありません。 HTTP経由でも併せて送信しない限り、OpenTelemetryのエクスポートでは[Agent] Session Endが失われます。 |
データウェアハウス
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| Snowflake、BigQuery、または Databricksのテーブル | ウェアハウスインポート | Amplitudeは、スケジュールに従ってSQLを使用してインポートします。 | テーブルが記録しないすべての内容 |
| テーブルに保存されたOpenTelemetry、OpenInference、またはMLflowスパン | ウェアハウスインポート | ジョブがスパンをOTLPエンドポイントにリプレイします | スパンが記録しないすべての項目 |
ローカルモデル
| ソース | 連携 | 誰がデータを移動しますか | AI SDKと比較して失うもの |
|---|---|---|---|
| Ollama、LM Studio、または別のローカルモデル | ローカルモデル | 手動トラッキングを備えたAI SDK | コスト |
ビルドする前に決定する
すべての連携では、ソースデータにこれらの値が必要です。 ガイドは、推測するのではなく、確認を求めます。
- 会話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.