Agent Server: LangGraph 배포의 실행 런타임 개요

Agent Server: LangGraph 배포의 실행 런타임 개요

LangSmith Deployment의 핵심 실행 계층이 Agent Server입니다. 쉽게 말해 "내 그래프를 받아서, 배포하고, API로 서빙해 주는 서버"라고 생각하면 됩니다. 이 런타임 위에서 에이전트는 세 가지 프리미티브로 동작합니다. assistants(설정), threads(상태), runs(워크로드). 아래 페이지들은 Agent Server가 제공하는 역량, 애플리케이션을 구조화하는 법, 서버를 보호(auth)하고 커스터마이즈하는 법을 다룹니다.

출처: Agent Server 공식 문서

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 / 셀프호스트 / 스탠드얼론)도 같은 허브의 관련 가이드에서 이어집니다.