배포 (Deployment)

배포 (Deployment)

LangChain 에이전트를 LangSmith Cloud 또는 JavaScript 프레임워크와 호스팅 플랫폼으로 프로덕션에 배포합니다.

LangChain 에이전트를 프로덕션에 배포할 준비가 되면 스택에 맞는 호스팅 모델을 선택하세요. LangSmith Cloud는 상태 저장 장기 실행 에이전트(stateful, long-running agents)를 위한 완전 관리형 인프라를 제공하며, 영구 상태(persistent state)와 백그라운드 실행(background execution)을 지원합니다.

LangSmith는 Cloud 외에도 하이브리드(hybrid), 독립형 서버(standalone servers), 컨트롤 플레인이 포함된 자체 호스팅(self-hosted with control plane) 등 다양한 배포 옵션을 제공합니다. 자세한 내용은 LangSmith 배포 개요를 참조하세요.

LangSmith Cloud

이 섹션에서는 GitHub 리포지토리에서 에이전트를 LangSmith Cloud에 배포하는 과정을 안내합니다. LangSmith가 인프라, 확장, 운영 부담을 처리합니다.

사전 요구 사항 (Prerequisites)

시작하기 전에 다음 항목이 준비되어 있는지 확인하세요.

  • GitHub 계정
  • LangSmith 계정 (무료로 가입 가능)

에이전트 배포하기 (Deploy your agent)

1. GitHub에 리포지토리 만들기

애플리케이션의 코드는 LangSmith에 배포하려면 GitHub 리포지토리에 있어야 합니다. 공개/비공개 리포지토리 모두 지원됩니다. 이 퀵스타트를 위해 먼저 로컬 서버 설정 가이드를 따라 앱이 LangGraph와 호환되는지 확인하세요. 그런 다음 코드를 리포지토리에 푸시합니다.

2. LangSmith에 배포하기

LangSmith 배포로 이동 LangSmith에 로그인합니다. 왼쪽 사이드바에서 Deployments를 선택합니다.

새 배포 만들기 + New Deployment 버튼을 클릭합니다. 필수 필드를 입력할 수 있는 창이 열립니다.

리포지토리 연결 첫 사용자이거나 아직 연결되지 않은 비공개 리포지토리를 추가하는 경우 Add new account 버튼을 클릭하고 안내에 따라 GitHub 계정을 연결합니다.

리포지토리 배포 애플리케이션의 리포지토리를 선택하고 Submit을 클릭하여 배포합니다. 완료까지 약 15분이 소요될 수 있습니다. 상태는 Deployment details 뷰에서 확인할 수 있습니다.

3. Studio에서 애플리케이션 테스트하기

애플리케이션이 배포되면:

  1. 방금 만든 배포를 선택해 더 자세한 내용을 확인합니다.
  2. 오른쪽 상단의 Studio 버튼을 클릭합니다. Studio가 열리면서 그래프가 표시됩니다.

4. 배포의 API URL 가져오기

  1. LangGraph의 Deployment details 뷰에서 API URL을 클릭해 클립보드에 복사합니다.
  2. URL을 클릭해 클립보드에 복사합니다.

5. API 테스트하기

이제 API를 테스트할 수 있습니다. Python과 Rest API 중 선택할 수 있습니다.

Python

  1. LangGraph Python을 설치합니다:
# pip
pip install -U langgraph-sdk

# uv
uv add langgraph-sdk
  1. 에이전트에 메시지를 보냅니다:
from langgraph_sdk import get_sync_client # or get_client for async

client = get_sync_client(url="your-deployment-url", api_key="your-langsmith-api-key")

for chunk in client.runs.stream(
    None,    # Threadless run
    "agent", # Name of agent. Defined in langgraph.json.
    input={
        "messages": [{
            "role": "human",
            "content": "What is LangGraph?",
        }],
    },
    stream_mode="updates",
):
    print(f"Receiving new event of type: {chunk.event}...")
    print(chunk.data)
    print("\n\n")

LangSmith는 자체 호스팅(self-hosted)과 하이브리드(hybrid) 등 추가적인 호스팅 옵션도 제공합니다. 자세한 내용은 Platform setup 개요를 참조하세요.