에이전트 분석 빠른 시작

SDK와 설정 경로를 선택한 다음 약 5분 안에 에이전트의 트래픽이 Amplitude로 흐르도록 하십시오. 에이전트 분석이 활성화된 프로젝트와 해당 API 키가 필요합니다. 익명 사용자 및 세션 ID는 정상입니다.

이 페이지에는 제한된 사용자 지정 기능이 포함된 빠른 설치 경로가 포함되어 있습니다. 완벽한 ID 및 개인 정보 보호 제어를 통해 프로덕션을 계측하려면 대신 에이전트 분석 및 SDK 참조로 이동하십시오.

Instrument this app with Amplitude Agent Analytics using the Node SDK.

Install the SDK:

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

Then follow `node_modules/@amplitude/ai/amplitude-ai.md`.

런타임이 Node 또는 Python SDK(엣지 워커, 브라우저 SPA 또는 Java, Go, Ruby 등의 언어)에 맞지 않는 경우, 위의 블록을 건너뛰십시오. HTTP 경로에 대해서는 AI SDK 없이 에이전트 이벤트 전송으로 이동하거나, 이미 OpenTelemetry GenAI 스팬을 방출하는 경우 OpenTelemetry 추적을 직접 전송하십시오.

다음 구현 비디오를 시청하여 Amplitude 에이전트 분석을 설정하는 방법에 대한 데모를 확인하십시오.

ID 사다리

추가하는 각 ID는 제품의 더 많은 기능을 잠금 해제합니다. 아래의 내용 중 이미 수행한 작업을 다시 계측해야 하는 것은 없습니다.

테스트 데이터를 사용하는 경우가 아니라면 위치 표시자 ID를 사용하지 마십시오. Amplitude에서 사용자 식별이 처리되는 방법에 대한 자세한 내용은 여기를 참조하십시오.

전체 설정의 유효성을 검사하십시오.

  1. 앱을 실행하고 에이전트를 통해 메시지를 전송합니다.
  2. Amplitude에서 프로젝트의 라이브 이벤트 보기를 엽니다. 약 1분 이내에 [Agent] User Message 및 [Agent] AI Response이(가) 표시되어야 하며, 세션이 완료되면 [Agent] Session End이(가) 표시됩니다.
  3. [Agent] AI Response 이벤트를 열고 모델 이름, 공급자, 입력 및 출력 토큰, 비용(USD), 지연 시간(Ms), 세션 ID 및 에이전트 ID 등의 주요 필드가 채워져 있는지 확인합니다.

Amplitude를 확인하기 전에 로컬로 확인하려면 debug: true을(를) 사용하여 클라이언트를 구성하십시오. 이 모드에서는 추적된 모든 이벤트가 해당 모델, 토큰, 비용 및 지연 시간과 함께 stderr로 출력됩니다.

단계별 예상 격차: 유효성 검사는 8개의 핵심 필드를 모두 확인하지만, 무엇을 기대할지는 현재 단계에 따라 다릅니다. 아직 실제 ID를 전달하지 않은 경우 에이전트 세션 ID는 자동 생성된 값을 표시하며 보강 결과는 덜 유의미할 수 있습니다. 이는 실패가 아니라 예상된 동작입니다. 전체 계측을 수행하면 8개 게이트 모두가 유의미해집니다.

다음에 일어나는 일

[Agent] Session End은(는) 선택 사항이며 권장됩니다. 세션 종료를 전송했거나 유휴 상태로 전환되어 세션이 닫히면 Amplitude는 해당 세션을 평가하고 [Agent] Session Record을(를) 발생시킵니다. 명시적 클로즈는 여전히 다음 수집 배치를 기다리므로 레코드는 일반적으로 15~20분 내에 도착합니다. 유휴 클로즈는 먼저 30분 기간을 기다립니다. 보강 백로그 중에 더 오래 걸릴 수 있습니다. 왼쪽 탐색기의 에이전트 분석으로 이동하여 세션을 확인한 다음, 설정으로 이동하여 개인정보 보호 모드를 선택하고 프로덕션 계측을 계획하십시오.

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

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.

이 페이지에서