Skip to main content

​
개요

LangGraph 애플리케이션은 하나 이상의 그래프, 구성 파일(langgraph.json), 의존성을 명시하는 파일, 그리고 환경 변수를 명시하는 선택적 .env 파일로 구성됩니다. 이 가이드는 애플리케이션의 일반적인 구조를 보여주며, LangGraph Platform을 사용하여 애플리케이션을 배포하는 데 필요한 정보를 어떻게 명시하는지 설명합니다.

​
주요 개념

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

​
파일 구조

다음은 애플리케이션의 디렉터리 구조 예시입니다: 
my-app/
├── src # 모든 프로젝트 코드가 여기에 위치합니다
│   ├── utils # 그래프를 위한 선택적 유틸리티
│   │   ├── tools.ts # 그래프를 위한 도구
│   │   ├── nodes.ts # 그래프를 위한 노드 함수
│   │   └── state.ts # 그래프의 상태 정의
│   └── agent.ts # 그래프를 구성하는 코드
├── package.json # 패키지 의존성
├── .env # 환경 변수
└── langgraph.json # LangGraph를 위한 구성 파일
LangGraph 애플리케이션의 디렉터리 구조는 사용하는 프로그래밍 언어와 패키지 매니저에 따라 달라질 수 있습니다.

​
구성 파일

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

​
예시

  • 의존성은 로컬 디렉터리의 의존성 파일(예: package.json)에서 로드됩니다.
  • 단일 그래프는 ./your_package/your_file.js 파일의 agent 함수에서 로드됩니다.
  • 환경 변수 OPENAI_API_KEY는 인라인으로 설정됩니다.
{
  "dependencies": ["."],
  "graphs": {
    "my_agent": "./your_package/your_file.js:agent"
  },
  "env": {
    "OPENAI_API_KEY": "secret-key"
  }
}

​
의존성

LangGraph 애플리케이션은 다른 TypeScript/JavaScript 라이브러리에 의존할 수 있습니다. 의존성을 올바르게 설정하려면 일반적으로 다음 정보를 명시해야 합니다:
  1. 의존성을 명시하는 디렉터리 내 파일(예: package.json)
  2. LangGraph 애플리케이션 실행에 필요한 의존성을 명시하는 LangGraph 구성 파일의 dependencies 키
  3. 추가 바이너리나 시스템 라이브러리는 LangGraph 구성 파일의 dockerfile_lines 키를 사용하여 명시할 수 있습니다.

​
그래프

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

​
환경 변수

로컬에서 배포된 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