LangSmith 대화를 에이전트 분석으로 가져오기

LangSmith 연동은 과거 대화를 포함하여 LangSmith가 이미 추적한 에이전트 대화를 에이전트 분석으로 전달합니다. 인프라에서 예약된 작업은 완료된 LangSmith 스레드를 가져오고, [Agent] 이벤트에 매핑한 다음 Amplitude HTTP API로 전송합니다. 그런 다음 Amplitude는 세션, 턴 및 도구 호출을 구축하고 내장 신호를 실행합니다.

앱에서 이미 OpenTelemetry를 내보내는 경우, 이 작업을 실행하는 대신 Amplitude를 두 번째 OTLP 내보내기로 추가할 수 있습니다. 에이전트 분석으로 OpenTelemetry 추적 보내기를 참조하십시오. 이 연동을 사용하여 기록을 포함하여 이미 LangSmith에 있는 내용을 전달하십시오.

포워더는 스레드에 구성된 [Agent] Agent ID을(를) 기록합니다. 중첩된 LangSmith 실행은 도구 호출이나 스팬으로 유지됩니다. 이들은 하위 에이전트가 되지 않으며, 작업에서도 [Agent] Parent Agent ID을(를) 설정하지 않습니다. 상위-하위 계열의 경우, 실행 중인 에이전트를 runAs()로 계측하거나 OpenTelemetry 스팬에 amplitude.parent.agent.id을(를) 설정하십시오. 멀티 에이전트 시스템 계측을 참조하십시오.

AI 코딩 에이전트로 설정(권장)

이 프롬프트를 Cursor, Claude Code, Windsurf, GitHub Copilot 또는 Codex와 같은 AI 코딩 에이전트에 붙여넣으십시오. 에이전트는 가이드를 가져오고, 작업을 빌드한 후 드라이 런으로 시작합니다.

text
Connect our LangSmith threads to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/langsmith.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의 단계에 따라 확인합니다.

이것이 여러분에게 의미하는 바

  • 실행 내용: 예를 들어 시간별 등 일정에 따라 실행되는 TypeScript 작업입니다. 실행 사이에 워터마크를 저장합니다.
  • 필요한 항목은 LangSmith API 키, 프로젝트 ID, LangSmith 지역 또는 셀프호스팅 URL, Amplitude 프로젝트 API 키입니다. 셀프 호스팅 LangSmith는 버전 0.16 이상이 필요합니다.
  • 앱은 기록해야 합니다: session_id 또는 thread_id 및 실행 메타데이터 내 사용자 ID. 이 작업은 해당 스레드를 제외하고 건너뛰며 개수를 셉니다.

이월되는 항목

신선도 및 제한

  • Settle 시간: 작업은 새로운 트레이스가 없는 상태로 2시간이 지나면 스레드를 완료된 것으로 간주합니다.
  • 속도 제한: LangSmith는 API 호출에 속도 제한을 적용합니다. 작업은 백오프를 사용하여 재시도되며 Retry-After을(를) 준수합니다.
  • Retention: LangSmith는 기본 리텐션의 경우 14일, 확장 리텐션의 경우 180일 동안 트레이스를 보관하므로 백필은 해당 범위까지만 유지합니다.
  • 재전송: 세션의 [Agent] Session End 이후에 전송된 이벤트는 새로운 내장 신호 결과를 얻지 못합니다. Amplitude는 7일 내에 재발생하는 이벤트를 중복 제거합니다.

시작하기

LangSmith 연동 가이드를 따르십시오. 드라이 런으로 시작하고, 첫 번째 실행 후 라이브 이벤트와 세션 뷰어를 확인한 다음 동일한 창을 다시 실행하여 중복 항목이 추가되지 않는지 확인하십시오.

가이드는 2026년 10월 6일에 마지막으로 확인되었습니다. LangSmith는 소유자의 상표입니다. Amplitude는 LangChain과 제휴하지 않으며 LangChain의 보증을 받지 않습니다.

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

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.

이 페이지에서