Skip to main content
중요 하이브리드 옵션은 Enterprise 플랜이 필요합니다.
하이브리드 모델은 LangSmith 인프라를 LangChain의 클라우드와 여러분의 클라우드로 분할합니다:
  • Control plane (LangSmith UI, API, 오케스트레이션)은 LangChain의 클라우드에서 실행되며 LangChain이 관리합니다.
  • Data plane (여러분의 및 에이전트 워크로드)는 여러분의 클라우드에서 실행되며 여러분이 관리합니다.
이는 관리형 인터페이스의 편리함과 자체 환경에서 워크로드를 실행하는 유연성을 결합합니다.
control plane, data plane, LangGraph Server 아키텍처 개념에 대해 자세히 알아보세요.
구성 요소역할실행 위치관리 주체
  • 배포 및 리비전 생성을 위한 UI
  • 배포 관리를 위한 API
  • 관측성 데이터 저장소
LangChain의 클라우드LangChain
  • Control plane과 동기화하는 리스너
  • LangGraph Server (여러분의 에이전트)
  • 백업 서비스 (Postgres, Redis 등)
여러분의 클라우드여러분
하이브리드 모델에서 LangSmith를 호스팅할 때는 LangSmith API 키로 인증합니다.

​
워크플로우

  1. langgraph-cli 또는 Studio를 사용하여 로컬에서 그래프를 테스트합니다.
  2. langgraph build 명령을 사용하여 Docker 이미지를 빌드합니다.
  3. control plane UI에서 LangGraph Server를 배포합니다.
지원되는 컴퓨팅 플랫폼: Kubernetes.
설정에 대해서는 하이브리드 설정 가이드를 참조하세요.

​
아키텍처

하이브리드 배포: LangChain이 호스팅하는 control plane(LangSmith UI/API)이 배포를 관리합니다. 여러분의 클라우드는 Kubernetes에서 리스너, LangGraph Server 인스턴스, 백업 스토어(Postgres/Redis)를 실행합니다.

​
컴퓨팅 플랫폼

  • Kubernetes: 하이브리드는 모든 Kubernetes 클러스터에서 data plane 실행을 지원합니다.
Kubernetes에서의 설정에 대해서는 하이브리드 설정 가이드를 참조하세요

​
LangSmith 및 Control Plane으로의 이그레스

하이브리드 배포 모델에서는 자체 호스팅 data plane이 control plane에 네트워크 요청을 보내 data plane에 구현해야 할 변경 사항을 폴링합니다. Data plane 배포의 트레이스도 control plane과 통합된 LangSmith 인스턴스로 전송됩니다. Control plane으로의 이 트래픽은 HTTPS를 통해 암호화됩니다. Data plane은 LangSmith API 키로 control plane에 인증합니다. 이 이그레스를 활성화하려면 내부 방화벽 규칙이나 클라우드 리소스(예: Security Groups)를 업데이트하여 특정 IP 주소를 허용해야 할 수 있습니다.
AWS/Azure PrivateLink 또는 GCP Private Service Connect는 현재 지원되지 않습니다. 이 트래픽은 인터넷을 통해 전송됩니다.

​
리스너

하이브리드 옵션에서는 LangSmith 워크스페이스와 Kubernetes 클러스터가 구성된 방식에 따라 하나 이상의 “리스너” 애플리케이션이 실행될 수 있습니다.

​
Kubernetes 클러스터 구성

  • Kubernetes 클러스터에서 하나 이상의 리스너가 실행될 수 있습니다.
  • 리스너는 해당 클러스터의 하나 이상의 네임스페이스에 배포할 수 있습니다.
  • 클러스터 소유자는 리스너 레이아웃 및 LangGraph Server 배포 계획을 담당합니다.

​
LangSmith 워크스페이스 구성

  • 워크스페이스는 하나 이상의 리스너와 연결될 수 있습니다.
  • 워크스페이스는 모든 리스너가 배포된 Kubernetes 클러스터에만 배포할 수 있습니다.

​
사용 사례

다음은 일반적인 리스너 구성입니다(엄격한 요구사항은 아님):

​
각 LangSmith 워크스페이스 → 별도의 Kubernetes 클러스터

  • 클러스터 alpha는 워크스페이스 A를 실행합니다
  • 클러스터 beta는 워크스페이스 B를 실행합니다

​
공유 “dev” 클러스터를 포함한 별도 클러스터

  • 클러스터 alpha는 워크스페이스 A를 실행합니다
  • 클러스터 beta는 워크스페이스 B를 실행합니다
  • 클러스터 dev는 워크스페이스 A와 B를 실행합니다
  • 두 워크스페이스 모두 두 개의 리스너를 가지며, 클러스터 dev는 두 개의 리스너 배포를 가집니다

​
하나의 클러스터, 워크스페이스당 하나의 네임스페이스

  • 클러스터 alpha, 네임스페이스 1은 워크스페이스 A를 실행합니다
  • 클러스터 alpha, 네임스페이스 2는 워크스페이스 B를 실행합니다

​
하나의 클러스터, 여러 워크스페이스를 위한 단일 네임스페이스

  • 클러스터 alpha는 워크스페이스 A를 실행합니다
  • 클러스터 alpha는 워크스페이스 B를 실행합니다
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I