Skip to main content
LangSmith에 배포하려면 애플리케이션은 하나 이상의 그래프, 설정 파일(langgraph.json), 의존성을 지정하는 파일, 그리고 환경 변수를 지정하는 선택적 .env 파일로 구성되어야 합니다. 이 페이지에서는 LangSmith 애플리케이션이 어떻게 구성되는지, 그리고 배포에 필요한 설정 세부 사항을 어떻게 제공하는지 설명합니다.

​
핵심 개념

LangSmith를 사용하여 배포하려면 다음 정보를 제공해야 합니다:
  1. 애플리케이션에 사용할 의존성, 그래프, 환경 변수를 지정하는 설정 파일(langgraph.json)
  2. 애플리케이션의 로직을 구현하는 그래프
  3. 애플리케이션 실행에 필요한 의존성을 지정하는 파일
  4. 애플리케이션 실행에 필요한 환경 변수
프레임워크 독립적LangSmith Deployment supports deploying a LangGraph graph. However, the implementation of a node of a graph can contain arbitrary Python code. This means any framework can be implemented within a node and deployed on LangSmith Deployment. This lets you keep your core application logic outside LangGraph while still using LangSmith for deployment, scaling, and observability.

​
파일 구조

다음은 Python 및 JavaScript 애플리케이션의 디렉터리 구조 예시입니다:
  • Python (requirements.txt)
  • Python (pyproject.toml)
  • JS (package.json)
my-app/
├── my_agent # all project code lies within here
│   ├── utils # utilities for your graph
│   │   ├── __init__.py
│   │   ├── tools.py # tools for your graph
│   │   ├── nodes.py # node functions for your graph
│   │   └── state.py # state definition of your graph
│   ├── __init__.py
│   └── agent.py # code for constructing your graph
├── .env # environment variables
├── requirements.txt # package dependencies
└── langgraph.json # configuration file for LangGraph
애플리케이션의 디렉터리 구조는 사용하는 프로그래밍 언어 및 패키지 관리자에 따라 달라질 수 있습니다.

​
설정 파일

langgraph.json 파일은 애플리케이션을 배포하는 데 필요한 의존성, 그래프, 환경 변수 및 기타 설정을 지정하는 JSON 파일입니다. JSON 파일에서 지원되는 모든 키에 대한 자세한 내용은 LangGraph 설정 파일 레퍼런스를 참조하세요.
LangGraph CLI는 기본적으로 현재 디렉터리의 설정 파일 langgraph.json을 사용합니다.

​
예시

  • Python
  • JavaScript
  • 의존성에는 사용자 정의 로컬 패키지와 langchain_openai 패키지가 포함됩니다.
  • 단일 그래프가 ./your_package/your_file.py 파일에서 variable 변수로 로드됩니다.
  • 환경 변수는 .env 파일에서 로드됩니다.
{
    "dependencies": [
        "langchain_openai",
        "./your_package"
    ],
    "graphs": {
        "my_agent": "./your_package/your_file.py:agent"
    },
    "env": "./.env"
}

​
의존성

애플리케이션은 작성된 프로그래밍 언어에 따라 다른 Python 패키지나 JavaScript 라이브러리에 의존할 수 있습니다. 의존성을 올바르게 설정하려면 일반적으로 다음 정보를 지정해야 합니다:
  1. 의존성을 지정하는 디렉터리 내 파일(예: requirements.txt, pyproject.toml, 또는 package.json)
  2. 애플리케이션 실행에 필요한 의존성을 지정하는 설정 파일의 dependencies 키
  3. 추가 바이너리나 시스템 라이브러리는 LangGraph 설정 파일의 dockerfile_lines 키를 사용하여 지정할 수 있습니다.

​
그래프

배포된 애플리케이션에서 사용할 수 있는 그래프를 지정하려면 설정 파일의 graphs 키를 사용하세요. 설정 파일에 하나 이상의 그래프를 지정할 수 있습니다. 각 그래프는 고유한 이름과 (1) 컴파일된 그래프 또는 (2) 그래프를 정의하는 함수로의 경로로 식별됩니다.

​
환경 변수

배포된 LangGraph 애플리케이션을 로컬에서 작업하는 경우 설정 파일의 env 키에서 환경 변수를 구성할 수 있습니다. 프로덕션 배포의 경우 일반적으로 배포 환경에서 환경 변수를 구성하는 것이 좋습니다.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I