Agent Server: LangGraph 배포의 실행 런타임 개요
Agent Server: LangGraph 배포의 실행 런타임 개요
LangSmith Deployment의 핵심 실행 계층이 Agent Server입니다. 쉽게 말해 "내 그래프를 받아서, 배포하고, API로 서빙해 주는 서버"라고 생각하면 됩니다. 이 런타임 위에서 에이전트는 세 가지 프리미티브로 동작합니다. assistants(설정), threads(상태), runs(워크로드). 아래 페이지들은 Agent Server가 제공하는 역량, 애플리케이션을 구조화하는 법, 서버를 보호(auth)하고 커스터마이즈하는 법을 다룹니다.
Agent Server가 제공하는 것
- 애플리케이션 개발 — 앱을 어떻게 구조화하는지, Python·JavaScript·모노레포 의존성 설정, RemoteGraph·시맨틱 검색·TTL·CI/CD로 에이전트 연결하기.
- Agent Server 런타임 — assistants, threads, runs, cron jobs를 다루고, 사용자에게 스트리밍, 인간 검토를 위한 일시정지, 동시 입력 처리, MCP·A2A 연결까지.
- 인증 & 접근 제어 — 사용자 인증, 리소스 단위 접근 통제, 외부 OAuth2 ID 제공자 연결.
- 서버 커스터마이즈 — 캐싱, 커스텀 store·checkpointer, 수명주기 훅(lifespan hooks), 미들웨어, 커스텀 라우트, 암호화, 설정 가능한 헤더·로그.
- REST API — assistants·threads·runs·crons·store·A2A·MCP·시스템 엔드포인트를 위한 전체 REST API 레퍼런스.
튜토리얼
- Agent Server runs에 대한 사용자 피드백 수집하기
- 기타 프레임워크(Strands, CrewAI 등) 배포하기 — Functional API로 감싸 배포
- LangGraph로 생성형 유저 인터페이스 구현 — React 클라이언트로 UI 요소 스트리밍
- CI/CD 파이프라인 구현 — GitHub Actions로 테스트·평가·배포 자동화
서버 보호와 커스터마이즈
- 커스텀 인증 — 인증과 멀티테넌트 접근 제어
- 서버 커스터마이즈 — 커스텀 라우트, 미들웨어, 수명주기 훅, 암호화
운영
- CI/CD 파이프라인
- 상태와 스레드 관리를 위한 TTL 설정
- 시맨틱 검색
더 알아보기 (Learn more)
- Agent Server의 내부 구조(그래프 로딩, 지속성, 태스크 큐, 컨테이너 아키텍처)는 같은 허브의 Agent Server 런타임 문서를 참고하세요.
- 배포 방법(Cloud / 셀프호스트 / 스탠드얼론)도 같은 허브의 관련 가이드에서 이어집니다.