Agent Analyticsクイックスタート

Early Access

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.

SDKをインストールして1つのコマンドを実行すると、エージェントのトラフィックが今から約5分後にAmplitudeに表示されます。必要なのは、Agent Analyticsが有効になっているプロジェクトとそのAPIキーだけで、それ以外は何も必要ありません。匿名ユーザーとセッションIDを使用できます。

これは最短のやり方です。完全なIDとプライバシー管理を使用してプロダクションを計測する場合は、Agent Analyticsの設定とSDKリファレンスを参照してください。

SDKをインストールする

bash

npm install @amplitude/ai @amplitude/analytics-node

セットアップエージェントを実行する

これを実行し、表示されたプロンプトをコーディングアシスタント（Cursor、Claude Code、Windsurf、GitHub Copilot、または Codex）に貼り付け、提案された変更を承認します。

bash

npx amplitude-ai

エージェントはすべてのLLMコールサイトとセッションライフサイクルを検出し、それらを計測し、何かをデプロイする前に、イベントとフィールドの充足率に関するドライランレポートを印刷します。

代わりに1行にパッチを適用する

コーディングアシスタントが手元にない場合は、スタートアップ時に1回呼び出すだけで、サポートされているプロバイダークライアント（OpenAI、Anthropic、Geminiなど）をモンキーパッチするため、SDKは他のコードを変更することなく既存のLLMコールを追跡できます。

typescript

import { AmplitudeAI, patch } from "@amplitude/ai";
const ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });
patch({ amplitudeAI: ai });

このパッチはベーシックな[Agent] AI Responseイベントのみをキャプチャします。これはパイプラインの動作を確認するには十分ですが、最終状態を捉えるものではありません。

イベントが到着する様子を確認する

Doctorを実行して、環境変数、依存関係、イベントとパイプラインの接続を検証します。

bash

npx amplitude-ai doctor

次に、プロジェクトのLive Eventsストリームを開きます。[Agent] AI Responseイベントがモデル、プロバイダー、レイテンシ、トークン、コストの各フィールドが入力された状態で表示されます。検証チェックリストの詳細については、データを検証するを参照してください。

準備が整ったらIDを追加する

これは時間をかけて登るはしごであり、初日に記入するフォームではありません。

追加	開放される事項
なし（パッチのみ）	基本的なLLMトレースと集計コール数
ユーザーID	ユーザーごとのアナリティクス、コホート、リテンション
セッションID	マルチターン分析、セッションの強化、品質スコア
エージェントID	エージェントあたりのコスト、レイテンシー、品質のダッシュボード

プレースホルダーIDでも機能します。イベントは通常どおり送信され、セッションも引き続き強化されます。また、再計装することなく、後で実際のIDに切り替えることができます。詳細については、SDKリファレンスの設定内容と取得内容を参照してください。

Was this helpful?