Cursor Agent SDK 세션을 에이전트 분석으로 가져오기
Cursor Agent SDK 연동은 사용자가 요청한 내용, 실행된 도구, 에이전트가 응답한 내용, 사용한 토큰 수와 같이 에이전트의 모든 라이브 세션을 에이전트 분석로 전송합니다. 각 세션은 나머지 프로덕트 분석과 동일한 사용자 ID로 표시되므로, 사용자가 원하는 결과를 얻었는지, 그리고 그것이 전환 및 리텐션에 반영되는지 확인할 수 있습니다. 에이전트 프로젝트의 후크는 각 턴이 완료되면 Amplitude HTTP API에 게시합니다. 그런 다음 Amplitude는 세션, 턴 및 도구 호출을 구축하고 세션이 종료된 후 내장 신호를 실행합니다.
Cursor의 evals와 에이전트 분석은 서로 다른 질문에 답변합니다. Cursor의 evals는 출시되기 전에 고정된 테스트 케이스에서 에이전트를 실행합니다. 에이전트 분석은 배포 후 실제 사용자에게 어떤 일이 발생했는지 보여줍니다. 후크는 eval 및 dry-run 세션을 건너뛰므로 둘 다 에이전트 분석에 나타나지 않습니다.
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의 단계에 따라 확인합니다.
이것이 여러분에게 의미하는 바
- 다음 내용을 추가합니다: 에이전트 SDK 프로젝트에 두 개의 파일, 즉
bot/hooks/에 후크와bot/lib/에 매핑 파일을 추가하십시오. 도구, 프롬프트 또는 모델 호출에 변경 사항이 없습니다. - 필요한 사항: Amplitude 프로젝트 API 키,
api2.amplitude.com로의 이그레스(EU 데이터 레지던시의 경우api.eu.amplitude.com), 그리고 세션에서 제품 분석 사용자 ID를 보유한 필드. - 필요하지 않습니다: Amplitude AI SDK. Cursor는 모델 루프를 실행하므로 래핑할 클라이언트가 없습니다.
전송되는 항목
| 데이터 | 전송됨 |
|---|---|
| 세션 그룹화 | 예, 하나의 에이전트 SDK 세션이 하나의 세션이 됩니다. |
| 사용자 및 에이전트 메시지 | 예, 메타데이터만 전송하지 않는 한 각 항목의 전체 텍스트 |
| 도구 호출 | 예, 이름, 성공, 입력 및 출력 포함 |
| 하위 에이전트 | 별도의 에이전트가 아닌 상위 에이전트의 턴 내에서 도구 호출로 |
| 모델 | 네, model에 bot/agent.ts을(를) 설정했습니다 |
| 토큰 | 예, 입력 및 출력 |
| 비용 | 아니오. Cursor는 각 턴이 아니라 전체 세션에 가격을 지정합니다. |
| 실패한 턴 | 예, 오류로 표시된 AI 응답입니다. 이 후크는 사용자가 취소한 턴을 건너뜁니다 |
| Cursor eval 실행 및 dry-run 세션 | 아니요 |
신선도 및 제한
- 지연 시간: 각 턴이 끝날 때 게시됩니다. 내장 신호는 세션이 30분 동안 유휴 상태인 후 한 번 실행됩니다.
- 다시 시작: 후크는 이벤트를 재생하지 않습니다. 에이전트 프로세스가 다운된 동안 후크는 턴을 전송하지 않습니다.
- 사용자 ID: 기본값은 없습니다. 후크는 product-분석 사용자 ID가 없는 세션을 로 저장하는 대신
unknown건너뜁니다. - 개인정보 보호: Amplitude는 콘텐츠를 수신한 후 삭제하지 않습니다. 메타데이터만 전송하거나 POST 요청 전에 후크에서 삭제하십시오. 에이전트 분석 개인정보 보호 모드를 참조하십시오.
- Resends: Insert ID가 안정적입니다. Amplitude는 7일 내에 재전송된 이벤트를 중복 제거합니다.
시작하기
Cursor Agent SDK 연동 가이드를 따르십시오. 이벤트를 전송하지 않고 출력하는 드라이 런으로 시작합니다. 그런 다음 도구 호출을 사용하여 하나의 실제 세션을 전송하고 라이브 이벤트에서 확인합니다:
- 세션 ID는 에이전트 SDK 세션 ID입니다.
- User ID는 product-분석 사용자가 아니라
unknown입니다. - 에이전트 ID는 에이전트의 이름입니다.
- 턴(turn)은 사용자 메시지, 도구 호출 및 회신 텍스트를 표시하며, 모델 이름과 두 토큰 카운트가 포함됩니다.
- 동일한 에이전트의 eval 실행이 나타나지 않습니다.
세션이 30분 동안 유휴 상태인 후에는 세션 뷰어에서 세션을 열어 내장 신호를 확인하십시오.
가이드는 2026년 10월 26일에 @grok/agent-sdk 0.3.0 버전 기준으로 마지막으로 확인되었습니다. Cursor 및 에이전트 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.