배포

배포 (Deployment)

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

LangChain 에이전트를 프로덕션에 배포할 준비가 되면 스택에 맞는 호스팅 모델을 선택하세요. LangSmith Cloud 는 상태를 유지하고 지속 상태·백그라운드 실행이 있는 장기 실행 에이전트를 위한 완전 관리형 인프라를 제공해요.

또한 Next.js, SvelteKit, Nuxt, Cloudflare Workers, Deno Deploy 같은 JavaScript 프레임워크·플랫폼에 동일한 Agent Streaming Protocol을 사용해 배포할 수 있어요.

프레임워크·플랫폼 가이드: LangSmith, Next.js, SvelteKit, Nuxt, Cloudflare, Deno (전체 가이드 보기)

LangSmith는 Cloud 외에도 [하이브리드(hybrid)](/langsmith/hybrid), [독립 실행 서버(standalone servers)](/langsmith/deploy-standalone-server), [컨트롤 플레인이 있는 셀프 호스팅](/langsmith/deploy-with-control-plane) 등 여러 배포 옵션을 제공해요. 자세한 내용은 [LangSmith Deployment 개요](/langsmith/deployment)를 참고하세요.

LangSmith Cloud

이 섹션은 GitHub 리포지토리에서 LangSmith Cloud로 에이전트를 배포하는 방법을 안내해요. LangSmith가 인프라, 확장, 운영 관련 문제를 처리해요.

사전 요구 사항 (Prerequisites)

시작하기 전에 다음이 있는지 확인하세요:

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

에이전트 배포 (Deploy your agent)

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

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

2. LangSmith에 배포

LangSmith Deployment로 이동: LangSmith에 로그인하세요. 왼쪽 사이드바에서 Deployments를 선택하세요.
새 배포 만들기: + New Deployment 버튼을 클릭하세요. 필수 필드를 채울 수 있는 창이 열립니다.
리포지토리 연결: 첫 사용자이거나 이전에 연결되지 않은 비공개 리포지토리를 추가하는 경우 Add new account 버튼을 클릭하고 지침에 따라 GitHub 계정을 연결하세요.
리포지토리 배포: 애플리케이션 리포지토리를 선택하세요. Submit을 클릭해 배포합니다. 완료까지 약 15분이 걸릴 수 있어요. Deployment details 보기에서 상태를 확인할 수 있어요.

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

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

방금 만든 배포를 선택해 더 많은 세부 정보를 봅니다.
오른쪽 상단의 Studio 버튼을 클릭합니다. Studio가 열려 그래프를 표시합니다.

4. 배포의 API URL 가져오기

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

5. API 테스트

이제 API를 테스트할 수 있어요:

JavaScript:

npm install @langchain/langgraph-sdk

const { Client } = await import("@langchain/langgraph-sdk");

const client = new Client({ apiUrl: "your-deployment-url", apiKey: "your-api-key" });

const streamResponse = client.runs.stream(
    null,    // Threadless run
    "agent", // Name of agent. Defined in langgraph.json.
    {
        input: {
            "messages": [
                { "role": "user", "content": "What is LangGraph?"}
            ]
        },
        streamMode: "messages",
    }
);

for await (const chunk of streamResponse) {
    console.log(`Receiving new event of type: ${chunk.event}...`);
    console.log(JSON.stringify(chunk.data));
    console.log("\n\n");
}

REST API:

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

LangSmith는 셀프 호스팅과 하이브리드를 포함한 추가 호스팅 옵션을 제공해요. 자세한 내용은 [Platform setup 개요](/langsmith/platform-setup)를 참고하세요.

출처: 문서

본문

이 페이지는 LangChain 에이전트를 프로덕션에 배포하는 방법을 안내해요. LangSmith Cloud는 상태 유지·장기 실행 에이전트를 위한 완전 관리형 인프라를 제공하며, GitHub 리포지토리에서 배포 설정(GitHub 리포지토리 생성→LangSmith 배포 생성→Studio 테스트→API URL 획득→API 테스트)을 안내해요. Next.js·SvelteKit·Nuxt·Cloudflare Workers·Deno 등의 JavaScript 프레임워크·플랫폼에도 Agent Streaming Protocol로 배포할 수 있어요.

더 알아보기 (Learn more)

LangChain JavaScript 배포 문서