에이전트 분석 설정

조기 액세스

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

이 페이지는 제품 수준의 요약입니다. Agent 분석 SDK는 설치, 초기화, 계측 세션 및 도구, 공급자 노트, 엣지 런타임, OTel 수집, 비용 처리 및 전체 API를 다루는 완전한 개발자 참조입니다.

아래 타임라인은 귀하의 계측기가 무엇을 생산하는지 보여줍니다. 아무 이벤트나 클릭하여 해당 모양을 검사합니다.

이벤트 유형

[Agent] AI ResponseSDK에서

발생 시각:

22:33:48

아이덴티티

[Agent] Session ID	4ddcc6b2-1041-432a-aa8c-ebe3eccac40b
[Agent] Agent ID	support-chatbot
[Agent] Trace ID	b4f63d43-d752-4b1f-8489-d234ddf586b2

이벤트별

$llm_message.text	I can help. Your subscription renews on Aug 15…
[Agent] Model Name	gpt-4o-mini
[Agent] Provider	openai
[Agent] Input Tokens	1245
[Agent] Output Tokens	87
[Agent] Latency Ms	3420
[Agent] Cost USD	0.0012

턴을 닫습니다. SDK doctor가 설정 시 확인하는 8가지 필드를 포함합니다: 세션 ID, 에이전트 ID, 모델, 공급자, Latency Ms, 입력/출력 토큰, 비용 USD.s.trackAiMessage(...) 또는 프로바이더 래퍼에 의해 방출됩니다.

설치 작동 방식

데이터가 Amplitude에 표시되기 전에 세 가지 사항이 충족되어야 합니다.

프로젝트에 에이전트 분석이 활성화되어 있습니다. 그렇지 않은 경우 CSM에게 문의하십시오.
코드를 계측했습니다. Amplitude AI SDK(Node 및 Python)는 대부분의 스택을 지원합니다. SDK가 번들로 제공되지 않는 런타임은 이벤트를 HTTP API로 직접 보낼 수 있습니다. 이러한 런타임에는 Cloudflare Workers, 기타 에지 및 Java, Go, Ruby와 같은 지원되지 않는 언어가 포함됩니다.
앱에서 무엇이 나갈지 결정했습니다. 개인정보 보호 모드는 프롬프트 및 응답 텍스트가 Amplitude에 도달할지 여부를 제어합니다.

계측 경로 선택

경로	사용 시점	어디로 가야 할지
Amplitude AI SDK(노드 또는 Python)	대부분의 스택	SDK 참조
HTTP API	SDK가 지원하지 않는 런타임(Java, Go, Ruby, Cloudflare Workers)	SDK 없이 계측하기
OpenTelemetry	이미 OTel 스팬을 방출하고 있는 스택 또는 스팬 우선 옵저버빌리티를 원하는 경우	OpenTelemetry 스팬 수집 — 권장되는 스팬 우선 접근 방식을 위해 `enable_otel()`/ `enableOtel()`를 호출하십시오.

개인정보 보호 모드 선택

모드	앱을 떠나는 것	사용 시점
`full` (기본값)	프롬프트 및 응답 텍스트(기본적으로 PII 편집이 활성화됨)	대부분의 제품
`metadata_only`	토큰, 지연 시간, 모델 및 비용(텍스트 없음)	민감하거나 규제를 받는 데이터
`customer_enriched`	귀하가 전송하는 사전 채점 요약 정보 `trackSessionEnrichment()`	이미 평가 스택을 보유하고 있습니다.

구성 세부 정보 및 PII 편집 조정 가능 사항에 대한 자세한 내용은 개인정보 보호 모드 선택을 참조하십시오.

데이터 검증

이벤트가 도착하기 시작하면 프로젝트의 라이브 이벤트 스트림에 Session ID, Agent ID, Model, , Provider, Latency Ms``Input/Output Tokens``Cost USD, 및 로 채워진 [Agent] AI Response이벤트가 표시됩니다. 이러한 필드 중 전체라도 누락된 경우 SDK 참조에서 데이터 검증을 참조하십시오.

로컬 확인: 배포하기 전에 실행하여 캡처된 모든 이벤트의 채우율 리포트를 가져옵니다MockAmplitudeAI.summary(). 이 기능은 8가지 검증 게이트(ID, 세션, 모델, 공급자, 지연 시간, 입력 토큰, 출력 토큰, 비용)를 확인하고 데이터가 Amplitude에 도달하기 전에 누락된 부분을 찾아냅니다.

데이터가 흐르고 있는지 확인한 후, Amplitude가 상단에서 추론하는 내용인 턴 레벨 신호, 세션 롤업, 대시보드를 구동하는 평가자 결과를 확인하려면 에이전트 결과 분석으로 이동하십시오.

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