에이전트 분석 빠른 시작

조기 액세스

이 기능은 Early Access 버전입니다. 다음 기간동안 기능의 일부 측면은 여전히 개발 중일 수 있으며 이 문서가 항상 최신 상태인 것은 아닐 수도 있습니다. 질문이 있으시면 다음으로 문의하십시오: Amplitude Support.

SDK를 설치하고 하나의 명령어를 실행하면 에이전트의 트래픽이 지금부터 약 5분 후에 Amplitude에 표시됩니다. 에이전트 분석이 활성화된 프로젝트와 해당 API 키가 필요하며, 그 외에는 아무것도 필요하지 않습니다. 익명 사용자 및 세션 ID는 정상입니다.

이 페이지는 빠른 경로입니다. 완벽한 ID 및 개인 정보 보호 제어를 통해 프로덕션을 계측하려면 대신 에이전트 분석 및 SDK 참조로 이동하십시오.

SDK 설치

bash

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

설치 에이전트 실행

이 명령을 실행하고, 출력된 프롬프트를 코딩 도우미(Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex)에 붙여넣은 다음, 도우미가 제안하는 변경 사항을 승인하십시오.

bash

npx amplitude-ai

에이전트는 모든 LLM 콜 사이트와 세션 생애주기 분석을 검색하여 이를 계측한 다음, 배포하기 전에 이벤트 및 필드 채우기 비율에 대한 드라이 런 리포트를 인쇄합니다.

대신 한 줄을 패치하십시오.

코딩 도우미가 없으신가요? 시작 시 한 번의 호출로 지원되는 공급자 클라이언트(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

그런 다음 프로젝트의 라이브 이벤트 스트림을 엽니다. [Agent] AI Response 이벤트는 모델, 공급자, 지연 시간, 토큰 및 비용 필드가 채워진 상태로 나타납니다. 전체 확인 체크리스트를 보려면 데이터 확인으로 이동하십시오.

준비가 되면 ID 추가

이것은 첫날에 작성하는 양식이 아니라 시간별로 올라가는 사다리입니다.

추가	그것이 잠금 해제하는 것
없음(패치만 해당)	기본 LLM 추적 및 총 호출 수
사용자 ID	사용자별 분석, 코호트, 리텐션
세션 ID	멀티턴 분석, 세션 강화, 품질 점수
에이전트 ID	에이전트당 비용, 지연 시간 및 품질 대시보드

플레이스홀더 ID는 작동합니다. 이벤트는 계속 진행되고, 세션은 계속 보강되며, 나중에 재계측 없이 실제 ID로 교체할 수 있습니다. 자세한 내역은 SDK 참조의 'What you set and what you get' 섹션을 확인하십시오.

이 내용이 도움이 되었나요?