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.
Agent Analyticsを設定する
This feature is in Early Access. During this time, aspects of the functionality may still be developed, and this documentation may not always be up to date. If you have any questions, contact Amplitude Support.
このページは製品レベルの概要です。 Agent Analytics SDKは開発者向けの完全なリファレンスであり、インストール、初期化、計測セッションとツール、プロバイダーに関する注意事項、エッジランタイム、OTelの取り込み、コスト処理、およびAPIの全てについて説明しています。
以下のタイムラインは、計装によって何が生成されるかを示しています。任意のイベントをクリックすると、その形状を確認できます。
| [Agent] Session ID | 4ddcc6b2-1041-432a-aa8c-ebe3eccac40b |
| [Agent] Agent ID | support-chatbot |
| [Agent] Trace ID | b4f63d43-d752-4b1f-8489-d234ddf586b2 |
| $llm_message.text | I can help. Your subscription renews on Aug 15… |
| [Agent] Model Name | gpt-4o-mini |
| [Agent] Provider | openai |
| [Agent] Input Tokens | 1245 |
| [Agent] Output Tokens | 87 |
| [Agent] Latency Ms | 3420 |
| [Agent] Cost USD | 0.0012 |
s.trackAiMessage(...) or a provider wrapper.セットアップの仕組み
Amplitudeにデータが表示されるには、次の3つの条件を満たしている必要があります：
- **プロジェクトでAgent Analyticsが有効になっていること。**そうでない場合は、CSMに連絡してください。
- コードが計測済みであること。 Amplitude AI SDK（NodeとPython）はほとんどのスタックに対応しています。SDKにバンドルされていないランタイムは、イベントをHTTP APIに直接送信できます。これらのランタイムには、Cloudflare Workers、その他のエッジ、Java、Go、Rubyなどのサポートされていない言語が含まれます。
- **アプリから送信する事項を決定済みであること。**プライバシーモードは、プロンプトとレスポンステキストがAmplitudeに到達するかどうかを制御します。
計測パスの選択
| パス | 使用するタイミング | 送信先 |
|---|---|---|
| Amplitude AI SDK（NodeまたはPython） | ほとんどのスタック | SDKリファレンス |
| HTTP API | SDKがサポートしていないランタイム（Java、Go、Ruby、Cloudflare Workers） | SDKを使用しない計測 |
| OpenTelemetry | すでにOTelスパンを発行しているスタック、またはスパンファーストのオブザーバビリティが必要な場合 | OpenTelemetryスパンの取り込み — 推奨されるスパンファーストアプローチとしてenable_otel() / enableOtel()を呼び出します |
プライバシーモードを選択する
| モード | アプリから送信される事項 | 使用するタイミング |
|---|---|---|
full（デフォルト） | プロンプトとレスポンスのテキスト（PIIのマスキングはデフォルトで有効化） | ほとんどの製品 |
metadata_only | トークン、レイテンシ、モデル、コスト（テキストなし） | 機密データまたは規制対象データ |
customer_enriched | trackSessionEnrichment()を通して送信した事前に採点済みのサマリー | すでに評価スタックが存在する |
設定の詳細とPIIマスキングの調整項目については、プライバシーモードの選択を参照してください。
データを検証する
イベントの到着が始まると、プロジェクトのライブイベントストリームにSession ID、Agent ID、Model、Provider、Latency Ms、Input/Output Tokens、およびCost USDが入力された[Agent] AI Responseイベントが表示されます。これらのフィールドのいずれかが欠落している場合は、SDKリファレンスのデータを検証するにある手順を確認してください。
- ローカル検証：デプロイ前に
MockAmplitudeAI.summary()を実行し、キャプチャされたすべてのイベントの充足率レポートを取得します。データがAmplitudeに到達する前に、8つの検証ゲート（ID、セッション、モデル、プロバイダー、レイテンシ、入力トークン、出力トークン、コスト）をチェックし、ギャップにフラグを立てます。
データが流れていることを確認したら、エージェント結果を分析するにアクセスして、ターンレベルのシグナル、セッションのロールアップ、ダッシュボードを駆動する評価ツールの結果など、Amplitudeがその上で推測する内容を確認してください。
Was this helpful?