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クイックスタート
この機能は早期アクセスです。 この期間中、機能のさまざまな側面はまだ開発されている可能性があり、このドキュメントは常に最新であるとは限りません。 ご質問がある場合は、までお問い合わせください。Amplitude Support.
SDKをインストールして1つのコマンドを実行すると、エージェントのトラフィックが今から約5分後にAmplitudeに表示されます。 必要なのは、Agent Analyticsが有効になっているプロジェクトとそのAPIキーだけで、それ以外は何も必要ありません。匿名ユーザーとセッションIDを使用できます。
これは最短のやり方です。完全なIDとプライバシー管理を使用してプロダクションを計測する場合は、Agent Analyticsの設定とSDKリファレンスを参照してください。
SDKをインストールする
npm install @amplitude/ai @amplitude/analytics-node
セットアップエージェントを実行する
これを実行し、表示されたプロンプトをコーディングアシスタント（Cursor、Claude Code、Windsurf、GitHub Copilot、または Codex）に貼り付け、提案された変更を承認します。
npx amplitude-ai
エージェントはすべてのLLMコールサイトとセッションライフサイクルを検出し、それらを計測し、何かをデプロイする前に、イベントとフィールドの充足率に関するドライランレポートを印刷します。
代わりに1行にパッチを適用する
コーディングアシスタントが手元にない場合は、スタートアップ時に1回呼び出すだけで、サポートされているプロバイダークライアント（OpenAI、Anthropic、Geminiなど）をモンキーパッチするため、SDKは他のコードを変更することなく既存のLLMコールを追跡できます。
import { AmplitudeAI, patch } from "@amplitude/ai";
const ai = new AmplitudeAI({ apiKey: process.env.AMPLITUDE_AI_API_KEY! });
patch({ amplitudeAI: ai });
このパッチはベーシックな[Agent] AI Responseイベントのみをキャプチャします。これはパイプラインの動作を確認するには十分ですが、最終状態を捉えるものではありません。
イベントが到着する様子を確認する
Doctorを実行して、環境変数、依存関係、イベントとパイプラインの接続を検証します。
npx amplitude-ai doctor
次に、プロジェクトのLive Eventsストリームを開きます。[Agent] AI Responseイベントがモデル、プロバイダー、レイテンシ、トークン、コストの各フィールドが入力された状態で表示されます。検証チェックリストの詳細については、データを検証するを参照してください。
準備が整ったらIDを追加する
これは時間をかけて登るはしごであり、初日に記入するフォームではありません。
| 追加 | 開放される事項 |
|---|---|
| なし（パッチのみ） | 基本的なLLMトレースと集計コール数 |
| ユーザーID | ユーザーごとのアナリティクス、コホート、リテンション |
| セッションID | マルチターン分析、セッションの強化、品質スコア |
| エージェントID | エージェントあたりのコスト、レイテンシー、品質のダッシュボード |
プレースホルダーIDでも機能します。イベントは通常どおり送信され、セッションも引き続き強化されます。また、再計装することなく、後で実際のIDに切り替えることができます。詳細については、SDKリファレンスの設定内容と取得内容を参照してください。
これは役に立ちましたか？