Assistants를 사용하면 graph의 핵심 로직과 별도로 구성(prompt, LLM 선택, tool 등)을 관리할 수 있어, graph 아키텍처를 변경하지 않고도 신속한 변경이 가능합니다. 이는 구조적 변경이 아닌 구성 변경을 통해 서로 다른 사용 사례에 최적화된 동일한 graph 아키텍처의 여러 특수 버전을 만드는 방법입니다. 예를 들어, 공통 graph 아키텍처를 기반으로 구축된 범용 작성 agent를 생각해 보세요. 구조는 동일하게 유지되지만, 블로그 게시물과 트윗과 같은 서로 다른 작성 스타일은 성능을 최적화하기 위해 맞춤형 구성이 필요합니다. 이러한 변형을 지원하기 위해 기본 graph를 공유하지만 model 선택과 system prompt가 다른 여러 assistant(예: 블로그용 하나, 트윗용 하나)를 만들 수 있습니다. assistant versions LangGraph API는 assistant와 해당 버전을 생성하고 관리하기 위한 여러 endpoint를 제공합니다. 자세한 내용은 API reference를 참조하세요.
Assistants는 LangSmith 개념입니다. 오픈 소스 LangGraph 라이브러리에서는 사용할 수 없습니다.

​
Configuration

Assistants는 LangGraph 오픈 소스의 configuration 개념을 기반으로 합니다. Configuration은 오픈 소스 LangGraph 라이브러리에서 사용할 수 있지만, assistant는 LangSmith에만 존재합니다. 이는 assistant가 배포된 graph와 긴밀하게 결합되어 있기 때문입니다. 배포 시 LangGraph Server는 graph의 기본 configuration 설정을 사용하여 각 graph에 대한 기본 assistant를 자동으로 생성합니다. 실제로 assistant는 특정 configuration을 가진 graph의 _인스턴스_일 뿐입니다. 따라서 여러 assistant가 동일한 graph를 참조할 수 있지만 서로 다른 configuration(예: prompt, model, tool)을 포함할 수 있습니다. LangGraph Server API는 assistant를 생성하고 관리하기 위한 여러 endpoint를 제공합니다. assistant를 생성하는 방법에 대한 자세한 내용은 API reference와 이 how-to를 참조하세요.

​
Versioning

Assistants는 시간 경과에 따른 변경 사항을 추적하기 위해 버전 관리를 지원합니다. Assistant를 생성한 후 해당 assistant에 대한 후속 편집은 새 버전을 생성합니다. assistant 버전을 관리하는 방법에 대한 자세한 내용은 이 how-to를 참조하세요.

​
Execution

Run은 assistant의 호출입니다. 각 run은 자체 input, configuration, metadata를 가질 수 있으며, 이는 기본 graph의 실행 및 output에 영향을 줄 수 있습니다. Run은 선택적으로 thread에서 실행될 수 있습니다. LangSmith API는 run을 생성하고 관리하기 위한 여러 endpoint를 제공합니다. 자세한 내용은 API reference를 참조하세요.

​
Video guide

Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I