Agent Analyticsクイックスタート
SDKと設定パスを選択し、約5分でエージェントのトラフィックがAmplitudeに流れるようにします。 エージェント分析が有効になっているプロジェクトとそのAPIキーが必要です。匿名ユーザーとセッションIDを使用できます。
このページには、限定的なカスタマイズが可能な高速インストールパスが含まれています。完全なIDとプライバシー管理を使用してプロダクションを計測する場合は、Agent Analyticsの設定とSDKリファレンスを参照してください。
Instrument this app with Amplitude Agent Analytics using the Node SDK. Install the SDK: npm install @amplitude/ai @amplitude/analytics-node Then follow `node_modules/@amplitude/ai/amplitude-ai.md`.
ランタイムがNodeまたはPython SDK(エッジワーカー、ブラウザのSPA、Java、Go、Rubyなどの言語)に適合しない場合は、上記のブロックをスキップしてください。 HTTPパスについては「Send agent events without the AI SDK」に移動してください。または、すでにOpenTelemetry GenAIスパンを生成している場合は、直接「Send OpenTelemetry traces」してください。
Amplitudeエージェント分析の設定方法のデモンストレーションについては、以下の実装ビデオをご覧ください。
IDラダー
IDを追加するたびに、プロダクトのより多くの機能のロックが解除されます。以下のいずれも、すでに実行したインストルメンテーションをやり直す必要はありません。
| 追加 | 開放される事項 |
|---|---|
| なし(パッチのみ) | 基本的なLLMトレースと集計コール数 |
| ユーザーID | ユーザーごとのアナリティクス、コホート、リテンション |
| エージェントのセッションID | マルチターン分析、セッションの強化、品質スコア |
| エージェントID | エージェントあたりのコスト、レイテンシー、品質のダッシュボード |
| ブラウザのセッションID | エージェントのアクティビティを、プロダクトのウェブおよびアプリの分析セッションにリンクします。 |
| セッションリプレイID | セッションリプレイで一致するセッションを表示する |
テストデータを使用している場合を除き、プレースホルダIDの使用は避けてください。 AmplitudeでのID 解決の処理方法の詳細については、こちらをご覧ください。
完全な設定を検証する
- アプリを実行し、エージェント経由でメッセージを送信します。
- Amplitudeで、プロジェクトのライブイベントビューを開きます。約1分以内に、
[Agent] User Message、[Agent] AI Responseが表示され、セッションが完了すると、[Agent] Session Endが表示されます。 [Agent] AI Responseイベントを開き、モデル名、プロバイダー、入力および出力トークン、コスト(USD)、レイテンシ(ミリ秒)、セッションID、エージェントIDなどの主要フィールドが入力されていることを確認します。
Amplitudeをチェックする前にローカルで検証するには、debug: trueを使用してクライアントを構築します。このモードでは、すべての追跡済みイベントが、そのモデル、トークン、コスト、およびレイテンシと共に stderr に出力されます。
rungごとの予想ギャップ:検証は8つのコアフィールドすべてをチェックしますが、期待される内容はラダーのどの位置にいるかによって異なります。まだ実際の ID を渡していない場合、Agent セッション ID には自動生成された値が表示され、エンリッチメントの結果は意味がなくなります。これは期待どおりの状態であり、失敗ではありません。 完全なインストルメンテーションにより、8つのゲートすべてが意味を持ちます。
次のアクション
[Agent] Session Endはオプションであり、推奨されます。Session Endを送信したか、またはアイドル状態になったかのいずれかにより、セッションが閉じられた後に、Amplitudeがセッションを評価し、[Agent] Session Recordを発行します。明示的 close は次の取り込みバッチを待機するため、レコードは通常 15 ~ 20 分の期間内に到着します。アイドル状態のクローズは、まず30分のウィンドウが経過するまで待機します。エンリッチメントのバックログ期間中、時間がかかることがあります。左側のナビゲーションにあるエージェント分析に移動してセッションを確認し、その後設定に進み、プライバシーモードを選択して、本番環境のインストルメンテーションをプランします。
これは役に立ちましたか?
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.