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

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

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

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

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

text
Connect our Langfuse sessions to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/langfuse.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를 포함하는 필드와 같이 추론할 수 없는 값을 묻습니다. 변경 사항을 검토한 다음 시작하기의 단계에 따라 확인합니다.

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

  • 실행: 일정에 따라 TypeScript 작업을 수행합니다(예: 매시간). 실행 사이에 워터마크를 저장합니다.
  • 필요한 사항은 Langfuse 공개 키 및 비밀 키, Langfuse 호스트(EU, US, 일본, HIPAA 또는 셀프호스팅), Amplitude 프로젝트 API 키입니다. 셀프로 호스팅되는 Langfuse v3에는 v2 관측 API가 없으므로 v4로 업그레이드하십시오.
  • 앱에서 설정해야 하는 항목: 트레이스 기준으로 sessionId 및 userId. 이 작업은 해당 항목이 없는 세션을 건너뛰고 계산합니다.

전송되는 항목

Langfuse가 마스킹한 콘텐츠는 마스킹된 상태로 유지됩니다.

신선도 및 제한

  • 설정 시간: 작업은 2시간 동안 새로운 트레이스가 없으면 세션을 완료된 것으로 간주합니다. 일부 Langfuse SDK와 OTLP 수집은 트레이스를 최대 15분 늦게 전달하므로 20분 미만으로 설정하지 마십시오.
  • 긴 세션: 작업은 세션 내 이전 트레이스를 찾기 위해 7일 전까지의 기록을 조회합니다. 작업은 그보다 오래된 트레이스를 세션에서 제외합니다.
  • 속도 제한: Langfuse는 조직 및 플랜별로 공개 API에 속도 제한을 적용합니다. 작업은 429에서 재시도하며, 재시도 횟수가 소진되면 워터마크를 진행하지 않고 중지됩니다.
  • Resends: 세션의 [Agent] Session End 이후에 전송된 이벤트는 새로운 내장 신호 결과를 얻지 않습니다. Amplitude는 7일 내에 재발생하는 이벤트를 중복 제거합니다.

시작하기

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

Guide는 2026년 10월 6일에 마지막으로 확인되었습니다. Langfuse는 소유자의 상표입니다. Amplitude는 Langfuse와 제휴하지 않으며 Langfuse가 보증하지 않습니다.

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

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.

이 페이지에서