다른 도구에서 에이전트 대화 가져오기

에이전트 분석 통합을 통해 대화가 이루어지는 기존 플랫폼에서 Amplitude로 대화 데이터를 가져올 수 있습니다. 호스팅된 플랫폼, 추적 도구, 웨어하우스 및 에이전트 프레임워크는 에이전트 코드에 Amplitude AI SDK가 필요하지 않습니다. Gateways, Fireworks 및 로컬 모델도 마찬가지입니다. 각 경로는 대화를 AI SDK가 전송하는 것과 동일한 [Agent] 이벤트로 전환하므로 세션, 내장 신호, 평가기 및 차트는 동일한 방식으로 작동합니다.

에이전트가 호스팅된 플랫폼에서 실행되는 경우, 추적 도구가 이미 기록하는 경우, 대화가 웨어하우스에 저장될 때, Cursor Agent SDK가 모델 루프를 실행하는 경우 또는 에이전트 프레임워크가 이미 OpenTelemetry를 내보내는 경우 연동을 사용하십시오. 직접 모델 호출을 계측할 때 Amplitude AI SDK를 사용하십시오. SDK는 비용, 도구 입력, 사용자 피드백을 포함하여 해당 경로에 대한 가장 자세한 정보를 캡처합니다. AI SDK로 에이전트 계측하기를 참조하십시오.

AI 코딩 에이전트로 설정하십시오

Amplitude는 코딩 에이전트와 엔지니어를 위해 각 플랫폼, 트레이싱 도구, 웨어하우스 및 에이전트 프레임워크 가이드를 작성합니다. 각 프로그램에는 에이전트가 처음부터 끝까지 따라야 하는 "Part 2: Coding agent procedure"가 있습니다. '연동 선택' 테이블에서 소스에 대한 페이지를 에이전트에게 제공하거나 전체 목록으로 안내하십시오:

GitHub 가이드는 공개이며 SDK가 설치되지 않은 상태에서 작동하며, main을(를) 추적합니다. 또한 @amplitude/ai npm 패키지에서도 제공됩니다. 설치된 경우 동일한 파일이 node_modules/@amplitude/ai/docs/integrations/ 아래에 있습니다.

통합 작동 방식

통합은 5가지 방법 중 하나로 대화를 전송합니다.

  • 호스팅된 플랫폼 및 추적 도구: 인프라의 작업은 완료된 대화를 읽어 [Agent]이벤트에 매핑한 다음 Amplitude HTTP API로 전송합니다. Sierra도 푸시할 수 있습니다.
  • 에이전트 프레임워크: 이 프레임워크는 OpenTelemetry를 내보냅니다. Amplitude 작업을 실행하지 않습니다.
  • Cursor Agent SDK: 에이전트의 후크가 각 라이브 턴을 게시합니다.
  • 데이터 웨어하우스: Amplitude는 테이블 행에 대해 설정한 일정에 따라 SQL을 실행합니다. 이미 테이블에 저장된 스팬의 경우 작업은 해당 스팬을 OTLP 엔드포인트로 재생합니다.
  • Gateways, Fireworks 및 로컬 모델: Amplitude AI SDK는 호출을 기록합니다. Fireworks 및 일부 게이트웨이도 OpenTelemetry를 내보낼 수 있습니다.

각 연동에는 GitHub에 엔지니어와 AI 코딩 에이전트를 위해 작성된 단계별 가이드가 포함되어 있습니다. 코딩 에이전트에게 가이드 URL을 전달하면 연동을 구축할 수 있습니다. 여기의 문서 페이지에서는 각 경로가 캡처하는 내용과 시작하기 전에 결정해야 할 사항을 설명합니다.

연동 선택

호스팅된 에이전트 플랫폼

에이전트 런타임

LLM 추적 도구

에이전트 프레임워크

TypeScript와 Java는 가이드의 내보내기 기능이 이를 다시 작성할 때까지 모델 스팬을 call_llm라고 명명합니다. Go는 Amplitude가 읽지 않는 OpenTelemetry 로그에 메시지 텍스트를 저장합니다. 에이전트가 이미 OpenTelemetry GenAI 스팬을 생성하고 여기에 나열되지 않은 경우, Amplitude를 두 번째 OTLP 내보내기로 추가하십시오. Agent 분석으로 OpenTelemetry 추적 보내기를 참조하십시오.

추론 라우터

데이터 웨어하우스

로컬 모델

빌드하기 전에 결정하십시오.

모든 연동에는 소스 데이터에 이러한 값이 필요합니다. 가이드는 멈추고 추측하는 대신 질문합니다.

  • 대화 ID: 메시지를 하나의 세션으로 그룹화하는 ID입니다. 작업은 대화를 전송하는 대신 건너뛰고 계산합니다.
  • 사용자 ID: 프로덕트 분석에서 전송하는 것과 동일한 사용자 ID이므로 에이전트 세션은 제품 데이터에 결합됩니다. 작업은 ID가 없는 대화를 건너뜁니다.

연동 확인

각 가이드는 이벤트를 전송하지 않고 구축하는 드라이 런으로 시작합니다. check-agent-events.mjs 스크립트는 @amplitude/ai npm 패키지에 포함되어 있으며 이벤트 컨트랙트에 대해 샘플을 확인합니다. 이 설치는 SDK를 앱에 추가하지 않습니다. 다운로드하는 대신 패키지에서 실행하십시오: npm install --no-save --ignore-scripts @amplitude/ai && node node_modules/@amplitude/ai/docs/integrations/check-agent-events.mjs events.json. 첫 번째 실제 실행 후에는 라이브 이벤트를 확인하고 Agent 분석에서 세션을 연 다음 동일한 창을 다시 실행하여 중복 항목이 추가되지 않는지 확인하십시오. 에이전트 분석 계측 확인을 참조하십시오.

연동 가이드는 2026년 10월 6일에 마지막으로 확인되었습니다. Strands 가이드는 2026년 10월 14일에 마지막으로 확인되었습니다. Google ADK, Vercel AI SDK, Pydantic AI, Mastra, Microsoft Agent Framework 및 OpenInference 가이드는 2026년 10월 28일에 마지막으로 확인되었습니다. Amazon Bedrock AgentCore 가이드는 2026년 10월 27일에 마지막으로 확인되었습니다.

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

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.

이 페이지에서