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を追加するたびに、プロダクトのより多くの機能のロックが解除されます。以下のいずれも、すでに実行したインストルメンテーションをやり直す必要はありません。

テストデータを使用している場合を除き、プレースホルダIDの使用は避けてください。 AmplitudeでのID 解決の処理方法の詳細については、こちらをご覧ください。

完全な設定を検証する

  1. アプリを実行し、エージェント経由でメッセージを送信します。
  2. Amplitudeで、プロジェクトのライブイベントビューを開きます。約1分以内に、[Agent] User Message、[Agent] AI Responseが表示され、セッションが完了すると、[Agent] Session Endが表示されます。
  3. [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.

このページでは