OpenInferenceのトレースをエージェント分析に送信する
Agno、smolagents、DSPy、Haystack、Google GenAI SDK、AutoGen AgentChatはOpenInferenceのスパンを送信します。 そのエクスポータをAmplitudeに向けます。エージェントプロセスではAmplitude AI SDKは必要ありません。
このページでは、agno 3.1.11、smolagents 1.26.0、dspy 3.4.1、haystack-ai 3.4.1、google-genai 2.33.0、およびautogen-agentchat 0.7.5について説明します。Amplitudeは、エクスポートしたスパンを保存します。 個人データがインフラストラクチャを離れる前に、スクラブ(匿名化)してください。エージェント分析のプライバシーモードを参照してください。
AIコーディングエージェントを使用した設定(推奨)
このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、CodexなどのAIコーディングエージェントに貼り付けます。
Connect this OpenInference agent to Amplitude Agent Analytics with native OpenTelemetry.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/openinference.md
and follow "Part 2: Coding agent procedure".
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Also follow https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/privacy.md
and scrub content before export.
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
変更を確認し、「Get started」の手順に従って確認します。
これがあなたにとって何を意味するのか
- 実行するもの:エージェントプロセス。その際、対象フレームワークのOpenInferenceインストルメンターがAmplitudeを指すように設定します。
- 必要なもの:上記の固定済みパッケージ、一致する
openinference-instrumentation-*パッケージ、AmplitudeプロジェクトのAPIキー、およびuser.id、session.id、gen_ai.agent.idを設定するスパンプロセッサ。 - プロトコル:OTLP over HTTP。 AmplitudeはprotobufとJSONを受け入れます。 AmplitudeはgRPCを受け入れません。 OTLPログは送信しないでください。
- プライバシー:Amplitudeは、受信後にコンテンツを削除しません。 エクスポートする前に、コンテンツの属性をマスクするかドロップします。
エクスポート
エージェントプロセスでこれらの変数を設定します。 環境変数に値がある場合、ヘッダー値内のスペースは%20としてエンコードします。Authorization=の記述は変更しないでください。
OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://api.amplitude.com/otlp/v1/traces
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer%20<project API key>"
OTEL_SERVICE_NAME=order-support
EU地域のデータレジデンシーの場合はhttps://api.eu.amplitude.com/otlp/v1/tracesを使用します。
アイデンティティ
| 属性 | 値 |
|---|---|
session.id | 会話、スレッド、またはチケットID。 すべてのターンで同じ値を使用します。 |
user.id | プロダクト分析で既に使用されているユーザーIDAmplitudeは、欠落しているユーザーをunknownとして保存します。 |
gen_ai.agent.id | このエージェントの安定した名前。 Amplitudeはgen_ai.agent.nameを読み取りません。 |
何が引き継がれるか
| Framework | [Agent] Tool Call | このキャプチャで示されたもの |
|---|---|---|
| Agno 3.1.11 | はい | ツール名と引数、およびモデルスパン上の応答 |
| smolagents 1.26.0 | はい | 応答はfinal_answerツールの結果です |
| DSPy 3.4.1 | はい、エクスポート時にtool.nameを設定した後 | すべてのモデル呼び出しで質問が記録されます。モデル名が到達します。トークン数は到達しません。 |
| Haystack 3.4.1 | いいえ | ツール呼び出しはモデルスパン内に残ります。 |
| Google GenAI SDK 2.33.0 | いいえ | 自動関数呼び出しはSDK内にとどまります。 |
| AutoGen AgentChat 0.7.5 | はい | ツール名と引数、およびモデルスパン上の応答 |
HaystackとGoogle GenAI SDKは、引き続きセッション、ユーザー、モデル、両方のトークン数、返信テキストを生成します。
hide-inputフラグとhide-outputフラグを設定したTraceConfigはメッセージ属性を省略するため、プロンプトと返答テキストは届きません。input.valueおよびoutput.valueはプレースホルダ__REDACTED__です。Amplitudeはそのプレースホルダを削除するため、ツールの引数とツールの結果は空です。 AgnoとAutoGenは、引き続きtool.parametersで引数を送信します。Google GenAIは、引き続きmessage.tool_calls.0.tool_call.function.argumentsでこれらを送信します。smolagentsは、引き続きsmolagents.taskにユーザーの質問を送信します。Amplitudeはこれらの属性を保存します。セッション、ユーザー、エージェントは残ります。Agno、smolagents、Haystack、Google GenAI、AutoGenでは、モデル名と両方のトークン数を保持します。DSPyはモデル名を保持し、トークン数を削除します。Agno、smolagents、DSPy、およびAutoGenはtool.nameを保持します。HaystackとGoogle GenAI SDKにはまだツールスパンがありません。
セッションを閉じる
[Agent] Session Endはオプションであり、推奨されます。ネイティブのOpenInferenceエクスポートはこれを送信しません。 Amplitudeは、デフォルトで資格認定エージェントイベントなしで30分後にセッションを終了します。また、セッションごとのオーバーライドが設定されていない場合は、セッション開始から24時間後にセッションが終了します。 最初に閉じたものがカウントされます。セッションレコードとコンテンツベースのシグナルを含むエンリッチメントは、その終了後に一度実行されます。 OpenTelemetryトランスレータは、スパンからidle-timeout属性を読み取ることはありません。 セッションの終了方法を参照してください。
今すぐ始める
OpenInference連携ガイドに従ってください。 同じセッションIDの2つのターンを送信し、ライブイベントで確認します。
- セッションIDはプロセッサのセッションIDであり、トレースIDではありません。
- ユーザーIDはプロダクト分析ユーザーであり、
unknownではありません。 - エージェントIDは
gen_ai.agent.idです。 - Agno、smolagents、DSPy、AutoGenはツール呼び出しを表示します。 HaystackとGoogle GenAI SDKは返信を表示しますが、ツール呼び出しは表示しません。
- AI レスポンスには、モデル名と両方のトークン数があります。
本ガイドは2026年10月28日に最終検証が行われ、以下のバージョンと照合されました:agno3.1.11、smolagents1.26.0、dspy3.4.1、haystack-ai3.4.1、google-genai2.33.0、およびautogen-agentchat0.7.5。これらの名前は、各所有者の商標です。 Amplitudeはこれらの所有者と提携していません。また、これらの所有者によって承認されていません。
これは役に立ちましたか?
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.