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 コーディング エージェントに貼り付けます。 エージェントはガイドを取得し、フックを追加し、ドライ実行から開始します。

text
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はモデルループを実行するため、ラップするクライアントはありません。

引き継がれる内容

鮮度と制限

  • レイテンシ:各ターンが終了すると、投稿されます。組み込みのシグナルは、セッションが30分間アイドル状態になった後、一度実行されます。
  • 再起動:フックはイベントをリプレイしません。このフックは、エージェントプロセスがダウンしている間は終了したターンを送信しません。
  • ユーザーID: デフォルトはありません。 フックは、プロダクト分析ユーザーIDのないセッションをunknownとして保存するのではなく、スキップします。
  • プライバシー:Amplitudeは、受信後にコンテンツを削除しません。メタデータのみを送信するか、投稿の前にフックでスクラブ(除外)します。エージェント分析のプライバシーモードを参照してください。
  • Resends: Insert IDはstableです。 Amplitudeは、7日間の期間内に再送信されたイベントを重複排除します。

今すぐ始める

Cursor Agent SDK連携ガイドに従ってください。 まずはドライランから開始してください。これは、イベントを送信することなくイベントを出力します。次に、ツール呼び出しを使用して1つの実際のセッションを送信し、ライブイベントで確認します:

  1. セッションIDは、Agent SDKセッションIDです。
  2. ユーザーIDはプロダクト分析ユーザーであり、unknownではありません。
  3. エージェントIDはエージェントの名前です。
  4. ターンには、ユーザーメッセージ、ツール呼び出し、返信テキストが表示されます。また、モデル名と両方のトークン数も含まれます。
  5. 同じエージェントから実行された評価の実行は表示されません。

セッションが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.

このページでは