Langfuse SDKs

Langfuse SDKs

Langfuse는 두 가지 SDK를 제공해요.

출처: 문서

본문

Python SDK v3 또는 JS/TS SDK v4에서 업그레이드 중인가요? 업그레이드 경로를 따라가세요(Python v3 → v4, JS/TS v4 → v5).

Langfuse SDK는 커스텀 observation과 트레이스를 만들고 Langfuse의 프롬프트 관리 및 평가 기능을 사용하는 권장 방법이에요. 두 SDK 모두 같은 코드로 Langfuse Cloud(Langfuse가 호스팅, 무료 티어, 인프라 불필요)와 셀프 호스트 Langfuse에서 동작하며, 자격 증명과 base URL만 다를 뿐이에요.

Langfuse SDK를 사용하지 않나요? OpenTelemetry를 통해 직접 또는 자동 계측 라이브러리로 트레이스를 보낼 수 있어요. Langfuse Cloud에서 POST /api/public/ingestion은 2026년 11월 16일부터 scores를 제외한 모든 것을 수락하지 않게 돼요. 커스텀 통합을 v4로 옮기려면 마이그레이션 가이드를 참고하세요.

주요 장점

  • OpenTelemetry 기반이라 LLM 스택에 어떤 OTEL 기반 계측 라이브러리든 사용할 수 있어요.
  • 완전히 비동기 요청이라 Langfuse가 거의 지연을 추가하지 않아요.
  • Langfuse 네이티브 통합과 상호운용이 가능해요.
  • 동기 타임스탬프를 통한 정확한 지연 추적.
  • 다운스트림 사용을 위한 ID 제공.
  • observation을 중첩할 때 훌륭한 개발 경험(DX).
  • 애플리케이션을 깨뜨리지 않아요: SDK 오류는 캐치되어 기록돼요.

이 섹션은 Langfuse SDK의 트레이싱 관련 기능을 다뤄요. Langfuse SDK를 프롬프트 관리와 평가에 사용하려면 각각의 문서를 방문하세요.

셀프 호스트 Langfuse의 요구사항+

| SDK | 최소 셀프 호스트 서버 버전 | 참고 | | Python SDK v3 and v4 | ≥ 3.63.0 | Observations API v2 및 Metrics API v2는 Langfuse v4가 필요함 | | JS/TS SDK v4 and v5 | ≥ 3.63.0 | Observations API v2 및 Metrics API v2는 Langfuse v4가 필요함 |

Langfuse Cloud는 항상 이 최소 요구사항을 충족해요. 서버 버전별 전체 그림은 셀프 호스트 호환성 매트릭스를, Langfuse Cloud는 버전 및 호환성을 참고하세요.

레거시 문서+

이 문서는 Langfuse SDK의 최신 버전에 대한 것이에요.

더 알아보기 (Learn more)