Amazon Bedrock AgentCoreトレースをエージェント分析に送信する
AgentCoreはホストです。エージェントフレームワークはすでにスパンを発行しています。CloudWatchの横にOTLP/HTTPエクスポータを追加し、そのエージェントと一致するフレームワークガイドに従います。 エージェントプロセスではAmplitude AI SDKは必要ありません。
このページには個別のキャプチャはありません。AgentCore上のStrandsはAWS Strandsです。その他のエージェントは、Google ADK、Pydantic AI、Microsoft Agent Framework、または OpenInference を使用します。 Amplitudeは、エクスポートしたスパンを保存します。 個人データがインフラストラクチャを離れる前に、スクラブ(匿名化)してください。エージェント分析のプライバシーモードを参照してください。
AIコーディングエージェントを使用した設定(推奨)
このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、Codexなどの AI コーディング エージェントに貼り付けます。
Connect this Amazon Bedrock AgentCore agent to Amplitude Agent Analytics with native OpenTelemetry.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/amazon-bedrock-agentcore.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
変更を確認し、今すぐ始めるの手順に従って確認します。
これによる影響
- 実行状況:エージェントのAgentCoreはすでに実行中で、CloudWatchに加えて2番目のOTLP/HTTPエクスポータが存在します。
- 必要となります:そのエージェントのフレームワークガイド、AmplitudeプロジェクトのAPIキー、および毎回安定した会話IDとプロダクトアナリティクスユーザーID。
- プロトコル:OTLP over HTTP。 AmplitudeはprotobufとJSONを受け入れます。AmplitudeはgRPCを受け入れません。
- プライバシー:Amplitudeは、受信後にコンテンツを削除しません。エクスポートする前に、コンテンツの属性をマスクするかドロップします。
エクスポート
CloudWatchエクスポータをそのまま使用してください。これらの変数を追加します。 環境変数に値がある場合、ヘッダー値内のスペースは%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を使用します。
AgentCoreはすでにOpenInference、OpenLLMetry、OpenLIT、Traceloopの各属性を受け入れています。 Amplitudeはすでにこれらをマッピングしています。
アイデンティティ
フレームワークガイドは、会話、プロダクトユーザー、エージェントを設定します。AgentCoreはこれらを追加しません。
| 属性 | 値 |
|---|---|
gen_ai.conversation.idまたはsession.id | 会話、スレッド、またはチケットID。すべてのターンで同じ値を使用します。 |
user.id | ユーザーIDは、プロダクト分析で既に使用されています。 Amplitudeは、欠落しているユーザーをunknownとして保存します。 |
gen_ai.agent.id | このエージェントの安定した名前。 Amplitudeはgen_ai.agent.nameを読み取りません。 |
引き継がれるもの
イベントは、ランタイム時のフレームワークのイベントです。操作がchatであるモデルスパンは、新しいユーザーメッセージごとに1つの[Agent] AI Responseと1つの[Agent] User Messageになります。execute_toolは[Agent] Tool Callになります。
セッションを閉じる
[Agent] Session Endはオプションであり、推奨されます。AgentCoreエクスポートはこれを送信しません。 Amplitudeは、デフォルトでは条件を満たすイベントがない状態で30分経過するとセッションを終了し、セッションごとのオーバーライドが設定されていない場合はセッション開始から24時間後にセッションを終了します。最初に閉じたものがカウントされます。セッションレコードとコンテンツベースのシグナルを含むエンリッチメントは、その終了後に一度実行されます。 OpenTelemetryトランスレータは、スパンからidle-timeout属性を読み取ることはありません。 セッションの終了方法を参照してください。
今すぐ始める
Amazon Bedrock AgentCore連携ガイドに従い、次にエージェントのフレームワークガイドに従ってください。 同じセッションIDを使用して2つのターンを送信し、ライブイベントで確認します。
- セッションIDは会話IDであり、トレースIDではありません。
- ユーザーIDはプロダクト分析ユーザーであり、
unknownではありません。 - エージェントIDは
gen_ai.agent.idです。 - ターンには、ユーザーメッセージのテキスト、ツール呼び出し、AIレスポンスのテキストが表示されます。また、モデル名と両方のトークン数も含まれます。
- 2番目のターンでは、最初のユーザーメッセージは複製されません。
ガイドは、別途のキャプチャなしのホスティングページとして、2026年10月27日に最終検証されました。Amazon BedrockとAgentCoreは、その所有者の商標です。 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.