​
Overview

LangGraph 애플리케이션은 하나 이상의 graph, 설정 파일(langgraph.json), 의존성을 지정하는 파일, 그리고 환경 변수를 지정하는 선택적 .env 파일로 구성됩니다. 이 가이드는 애플리케이션의 일반적인 구조를 보여주고 LangSmith를 사용하여 애플리케이션을 배포하는 데 필요한 정보를 지정하는 방법을 보여줍니다.

​
Key Concepts

LangSmith를 사용하여 배포하려면 다음 정보를 제공해야 합니다:
  1. 애플리케이션에 사용할 의존성, graph, 환경 변수를 지정하는 LangGraph 설정 파일(langgraph.json)
  2. 애플리케이션의 로직을 구현하는 graph
  3. 애플리케이션을 실행하는 데 필요한 의존성을 지정하는 파일
  4. 애플리케이션 실행에 필요한 환경 변수

​
File Structure

다음은 애플리케이션의 디렉토리 구조 예시입니다:
  • Python (requirements.txt)
  • Python (pyproject.toml)
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 애플리케이션의 디렉토리 구조는 프로그래밍 언어와 사용되는 패키지 매니저에 따라 달라질 수 있습니다.

​
Configuration File

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

​
Examples

  • 의존성에는 커스텀 로컬 패키지와 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"
}

​
Dependencies

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

​
Graphs

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

​
Environment Variables

로컬에서 배포된 LangGraph 애플리케이션으로 작업하는 경우 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