LangGraph 배포

LangGraph 배포 (Deploy)

LangGraph 에이전트를 프로덕션에 올릴 준비가 되었다면, 자신의 스택에 맞는 호스팅 모델을 고르면 돼요. LangSmith Cloud는 상태가 유지되고 오래 실행되는 에이전트를 위한 완전 관리형 인프라(영속 상태, 백그라운드 실행 포함)를 제공해요. LangSmith는 Cloud 외에도 하이브리드, 독립 서버, 컨트롤 플레인이 있는 셀프 호스팅 등 여러 배포 옵션을 제공하니까, 먼저 LangSmith Deployment 개요를 보는 걸 권장해요.

출처: 공식문서

LangSmith Cloud

이 섹션은 GitHub 저장소에서 에이전트를 LangSmith Cloud로 배포하는 과정을 안내해요. LangSmith가 인프라·스케일링·운영 부담을 처리해 주기 때문에, 별도 서버 관리 없이도 배포할 수 있어요.

사전 준비 (Prerequisites)

시작하기 전에 다음이 준비돼 있어야 해요.

  • GitHub 계정
  • LangSmith 계정 (가입은 무료)

1. GitHub에 저장소 만들기

배포할 애플리케이션의 코드는 GitHub 저장소에 있어야 해요. 공개·비공개 저장소 모두 지원돼요. 먼저 로컬 서버 설정 가이드를 따라 앱이 LangGraph 호환인지 확인한 뒤, 코드를 저장소에 푸시하면 돼요.

2. LangSmith에 배포하기

  1. LangSmith Deployment로 이동 — LangSmith에 로그인하고 왼쪽 사이드바에서 Deployments를 선택해요.
  2. 새 deployment 생성 — + New Deployment 버튼을 클릭하면 필요한 필드를 채울 수 있는 창이 열려요.
  3. 저장소 연결 — 처음이거나 이전에 연결하지 않은 비공개 저장소라면 Add new account 버튼을 클릭해 GitHub 계정 연결 절차를 따르세요.
  4. 저장소 배포 — 애플리케이션 저장소를 선택하고 Submit을 클릭해요. 완료에 약 15분 정도 걸릴 수 있고, 상태는 Deployment details 뷰에서 확인할 수 있어요.

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

배포가 완료되면 방금 만든 deployment를 선택해 세부 정보를 확인하고, 오른쪽 위의 Studio 버튼을 클릭하면 그래프가 열려요.

4. 배포의 API URL 확인하기

LangGraph의 Deployment details 뷰에서 API URL을 클릭하면 클립보드에 복사돼요.

5. API 테스트하기

LangGraph SDK를 설치하고:

pip install langgraph-sdk

에이전트에 메시지를 보내 보세요:

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")

REST API로도 같은 요청을 보낼 수 있어요:

curl -s --request POST \
    --url <DEPLOYMENT_URL>/runs/stream \
    --header 'Content-Type: application/json' \
    --header "X-Api-Key: *** API KEY> \
    --data "{
        \"assistant_id\": \"agent\", \`# Name of agent. Defined in langgraph.json.\`
        \"input\": {
            \"messages\": [
                {
                    \"role\": \"human\",
                    \"content\": \"What is LangGraph?\"
                }
            ]
        },
        \"stream_mode\": \"updates\"
    }"

더 알아보기 (Learn more)

  • LangSmith Deployment 개요와 하이브리드·셀프 호스팅 옵션
  • LangGraph Studio 사용법
  • LangGraph 로컬 서버 설정 가이드