LangSmith에 배포하려면, application은 하나 이상의 graph, 설정 파일(langgraph.json), 의존성을 지정하는 파일, 그리고 환경 변수를 지정하는 선택적 .env 파일로 구성되어야 합니다. 이 페이지에서는 LangSmith application이 어떻게 구성되는지, 그리고 배포에 필요한 설정 세부 정보를 제공하는 방법을 설명합니다.

​
주요 개념

LangSmith를 사용하여 배포하려면 다음 정보를 제공해야 합니다:
  1. application에 사용할 의존성, graph, 환경 변수를 지정하는 설정 파일(langgraph.json).
  2. application의 로직을 구현하는 graph.
  3. application을 실행하는 데 필요한 의존성을 지정하는 파일.
  4. application 실행에 필요한 환경 변수.
Framework 독립적LangSmith Deployment는 LangGraph graph 배포를 지원합니다. 그러나 graph의 node 구현에는 임의의 Python 코드가 포함될 수 있습니다. 이는 node 내에서 모든 프레임워크를 구현하고 LangSmith Deployment에 배포할 수 있음을 의미합니다. 이를 통해 핵심 애플리케이션 로직을 LangGraph 외부에 유지하면서도 배포, 확장 및 관찰 가능성을 위해 LangSmith를 계속 사용할 수 있습니다.

​
파일 구조

다음은 Python 및 JavaScript application의 디렉토리 구조 예시입니다:
  • 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
application의 디렉토리 구조는 프로그래밍 언어와 사용되는 패키지 매니저에 따라 달라질 수 있습니다.

​
설정 파일

langgraph.json 파일은 application을 배포하는 데 필요한 의존성, graph, 환경 변수 및 기타 설정을 지정하는 JSON 파일입니다. JSON 파일에서 지원되는 모든 키에 대한 자세한 내용은 LangGraph 설정 파일 참조를 참조하세요.
LangGraph CLI는 기본적으로 현재 디렉토리의 설정 파일 langgraph.json을 사용합니다.

​
예시

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

​
의존성

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

​
Graph

배포된 application에서 사용할 수 있는 graph를 지정하려면 설정 파일의 graphs 키를 사용하세요. 설정 파일에서 하나 이상의 graph를 지정할 수 있습니다. 각 graph는 고유한 이름과 (1) 컴파일된 graph 또는 (2) graph를 정의하는 function에 대한 경로로 식별됩니다.

​
환경 변수

배포된 LangGraph application을 로컬에서 작업하는 경우, 설정 파일의 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