Cursor Agent SDKセッションをエージェント分析にインポートする
Cursor Agent SDKとの連携は、エージェントのすべてのライブセッションをAgent分析に送信します。これには、ユーザーの質問内容、実行されたツール、エージェントの回答内容、使用されたトークン数が含まれます。各セッションは、残りのプロダクト分析と同じユーザーIDに設定されているため、ユーザーが求めたものを得たかどうか、そのものがコンバージョンとリテンションに表示されたかどうかを確認できます。 エージェントプロジェクトのフックは、完了時に各ターンをAmplitude HTTP APIに投稿します。その後、Amplitudeによってセッション、ターン、ツール呼び出しが構築され、セッション終了後に組み込みのシグナルが実行されます。
CursorのevalsとAgent分析は、異なる質問に答えます。Cursorのevalは、リリース前に固定されたテストケースに対してエージェントを実行します。 エージェント分析は、リリース後に実際のユーザーに何が起こったかを示します。このフックはevalセッションとdry-runセッションをスキップするため、どちらもAgent分析には表示されません。
AIコーディングエージェントを使用した設定(推奨)
このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、Codexなどの AI コーディング エージェントに貼り付けます。 エージェントはガイドを取得し、フックを追加し、ドライ実行から開始します。
Forward live Cursor Agent SDK sessions to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/cursor-agent-sdk.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.
エージェントは停止し、推測できない値(たとえば、どのフィールドにユーザーIDが含まれているか、どのモデルが実行されているかなど)を尋ねます。 その変更を確認し、「Get started」の手順に従って検証します。
必要な対応
- 追加するもの:Agent SDKプロジェクトに追加する2つのファイル。
bot/hooks/にはフック、bot/lib/にはマッピングファイルを追加します。ツール、プロンプト、モデル呼び出しに変更はありません。 - 必要となるもの:AmplitudeプロジェクトのAPIキー、
api2.amplitude.comへの送信(EU区域データレジデンシーの場合はapi.eu.amplitude.com)、およびプロダクト分析ユーザーIDを保持するセッション上のフィールド。 - 不要:Amplitude AI SDK。Cursorはモデルループを実行するため、ラップするクライアントはありません。
引き継がれる内容
| データ | 引き継ぎの有無 |
|---|---|
| セッションのグループ化 | はい、1つのAgent SDKセッションが1つのセッションになります |
| ユーザーとエージェントのメッセージ | はい、メタデータのみを送信する場合を除き、それぞれのフルテキストが送信されます。 |
| ツール呼び出し | はい、名前、成功の成否、入力、および出力 |
| サブエージェント | 個別のエージェントとしてではなく、親エージェントのターン内のツール呼び出しとして |
| モデル | はい、bot/agent.tsで設定されたmodel |
| トークン | はい、入力と出力 |
| コスト | いいえ、Cursorは各ターンではなく、セッション全体を値付けします |
| 失敗したターン | はい、エラーとしてマークされたAIレスポンスとして。 フックは、ユーザーがキャンセルしたターンをスキップします。 |
| Cursor eval実行とdry-runセッション | いいえ |
鮮度と制限
- レイテンシ:各ターンが終了すると、投稿されます。組み込みのシグナルは、セッションが30分間アイドル状態になった後、一度実行されます。
- 再起動:フックはイベントをリプレイしません。このフックは、エージェントプロセスがダウンしている間は終了したターンを送信しません。
- ユーザーID: デフォルトはありません。 フックは、プロダクト分析ユーザーIDのないセッションを
unknownとして保存するのではなく、スキップします。 - プライバシー:Amplitudeは、受信後にコンテンツを削除しません。メタデータのみを送信するか、投稿の前にフックでスクラブ(除外)します。エージェント分析のプライバシーモードを参照してください。
- Resends: Insert IDはstableです。 Amplitudeは、7日間の期間内に再送信されたイベントを重複排除します。
今すぐ始める
Cursor Agent SDK連携ガイドに従ってください。 まずはドライランから開始してください。これは、イベントを送信することなくイベントを出力します。次に、ツール呼び出しを使用して1つの実際のセッションを送信し、ライブイベントで確認します:
- セッションIDは、Agent SDKセッションIDです。
- ユーザーIDはプロダクト分析ユーザーであり、
unknownではありません。 - エージェントIDはエージェントの名前です。
- ターンには、ユーザーメッセージ、ツール呼び出し、返信テキストが表示されます。また、モデル名と両方のトークン数も含まれます。
- 同じエージェントから実行された評価の実行は表示されません。
セッションが30分間アイドル状態になったら、セッションビューアでセッションを開き、組み込みのシグナルを確認します。
ガイドの最終確認日は2026年10月26日で、@grok/agent-sdk0.3.0に対して行われました。CursorとAgent SDKは、各所有者の商標です。 AmplitudeはCursorと提携していません。また、Cursorによって承認されていません。
これは役に立ちましたか?
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.