랭체인 매니지드 딥 에이전트 정리: 에이전트 배포에 필요한 런타임·샌드박스·컨텍스트 허브

핵심 메시지

• 발표자는 에이전트를 세 층으로 나눈다. 프롬프트·스킬·도구·서브에이전트로 이뤄진 비즈니스 로직, 컨텍스트를 관리하고 모델 호출을 반복하는 하네스, 그리고 이를 실제로 돌리는 인프라다. 이 중 비즈니스 로직만은 어떤 프레임워크도 대신 만들어 줄 수 없다.
• 로컬에서 돌던 에이전트를 프로덕션으로 옮기는 순간 필요한 것이 한꺼번에 늘어난다. 중간에 실패해도 처음부터 다시 시작하지 않는 지속 실행과 장애 복구, 스트리밍, 트래픽이 몰릴 때의 큐잉·실행 취소·롤백, 샌드박스, 인증, 평가, 사용자 인터페이스, 메모리가 모두 필요하다.
• 매니지드 딥 에이전트는 오픈소스 하네스인 딥 에이전트에 이 인프라를 묶어, 사용자가 비즈니스 로직만 얹으면 바로 배포되는 형태를 지향한다.
• 지시문과 스킬 같은 컨텍스트는 코드에 두지 않고 컨텍스트 허브에 저장된다. UI에서 고치면 재배포 없이 곧바로 반영되며, 개발자가 아닌 팀원도 편집하고 감사할 수 있다.
• 프로젝트는 파일 시스템 구조로 정의된다. 에이전트 정의, 접근 권한, 시스템 프롬프트, 의존성, 샌드박스 설정이 각각 파일로 분리되고 CLI 하나로 초기화·로컬 실행·배포가 이어진다.

쉽게 이해하기

랭체인이 매니지드 딥 에이전트를 공개하며 내놓은 소개 영상은 제품 설명보다 문제 정의에 절반가량을 쓴다. 발표자는 먼저 에이전트를 세 층으로 나눈다. 맨 아래는 프롬프트·스킬·도구·서브에이전트로 이뤄진 비즈니스 로직인데, 이것이 에이전트마다 다른 부분이고 모델도 프레임워크도 대신 채워 줄 수 없는 영역이다. 그 위에 컨텍스트를 정리해 모델에 넘기고 응답을 받아 반복하는 하네스가 있고, 다시 그 위에 실제로 서비스를 굴리는 인프라가 있다. 발표의 초점은 이 세 번째 층이다. 노트북에서 잘 돌던 에이전트를 웹 서버에 올려 실제 트래픽을 받게 하는 순간 요구사항이 한꺼번에 늘어난다. 실행이 중간에 실패해도 처음부터 다시 시작하지 않는 지속 실행과 장애 복구, 프런트엔드가 이어 받을 수 있는 이벤트 스트리밍, 트래픽이 몰릴 때의 큐잉과 실행 취소·롤백이 필요하다. 요즘 에이전트 상당수가 신뢰할 수 없는 코드를 직접 작성하고 실행하기 때문에 격리된 샌드박스도 필요해진다.

여기에 발표자가 '가장 저평가돼 있다'고 표현한 문제들이 더해진다. 누가 에이전트를 호출했고 그 사람이 무엇을 볼 권한이 있는지 확인하는 인증, 모델이나 프롬프트를 바꿀 때 성능을 비교할 평가, 만들어 놓은 에이전트를 사용자에게 어떻게 내보일지의 UX, 그리고 실행이 끝난 뒤 무엇을 기억하고 어떻게 다시 꺼내 쓸지의 메모리다. 매니지드 딥 에이전트는 이 목록을 오픈소스 하네스와 한 묶음으로 제공해, 사용자가 비즈니스 로직만 얹으면 되도록 만드는 것을 목표로 한다.

설계에서 가장 눈에 띄는 선택은 컨텍스트를 코드 밖으로 뺀 것이다. 지시문과 스킬은 배포된 코드 안이 아니라 컨텍스트 허브에 저장되고, 웹 UI에서 고치면 재배포 없이 바로 반영된다. 영상에서는 배포된 에이전트의 지시문을 '이탈리아어로 답하라'로 고쳐 저장한 뒤, 다시 대화를 걸자 곧바로 이탈리아어로 답하는 장면을 보여준다. 메모리도 같은 곳에 쌓여 무엇이 기록됐는지 확인할 수 있다.

프로젝트 구조 자체도 파일 시스템으로 표현된다. CLI로 프로젝트를 만들면 에이전트를 정의하는 파일, 누가 접근할 수 있는지 정하는 파일, 시스템 프롬프트가 담긴 마크다운, 의존성 설정, 샌드박스 설정이 따로 생긴다. 샌드박스는 기본적으로 대화 스레드마다 새로 뜨지만, 에이전트 전체가 하나를 공유하도록 범위를 바꾸거나 아예 끌 수도 있다. 예제에서는 검색 도구를 파일 하나로 추가하고 에이전트 정의에 넘겨주는 것으로 기능 확장을 마친 뒤, 로컬 서버로 동작을 확인하고 명령 한 줄로 배포까지 진행한다.

외부 연결과 노출 방식도 함께 묶였다. MCP로 슬랙·노션·리니어 같은 원격 서버에 연결하고, 에이전트를 별도 웹앱이 아니라 사용자가 이미 쓰고 있는 곳으로 내보내는 '채널' 개념이 도입됐다. 첫 채널은 슬랙이다. 크론처럼 정해진 시각에 에이전트를 깨우는 스케줄도 들어가는데, 발표자는 앞으로 에이전트가 사람의 요청을 기다리기보다 배경에서 먼저 움직이는 방향으로 갈 것이라는 전망을 그 근거로 든다. 파이썬과 타입스크립트를 지원하며, 시작하려면 LangSmith API 키와 모델 제공자 키가 필요하다.

주요 인사이트

• 프레임워크 경쟁의 축이 옮겨가고 있다. 예전에는 어떤 하네스가 컨텍스트를 잘 관리하느냐가 관건이었다면, 이 발표에서 핵심 논점은 배포·격리·인증·평가 같은 운영 인프라 쪽에 있다.
• 컨텍스트를 코드에서 분리한 결정은 배포 편의보다 협업 구조의 문제로 읽힌다. 발표자는 지시문을 손볼 최적임자가 개발자가 아닐 때가 많다는 점을 이유로 든다.
• 샌드박스 범위를 스레드 단위로 둘지 에이전트 단위로 둘지가 선택지로 열려 있다. 스레드마다 격리하면 안전하지만 작업 상태를 이어가려면 공유가 필요해, 격리와 연속성 사이의 트레이드오프가 설정값 하나로 드러난다.
• 슬랙을 첫 채널로 삼은 것은 UX를 새로 만들지 않겠다는 선언에 가깝다. 에이전트를 쓰게 만드는 비용의 상당 부분이 인터페이스 자체가 아니라 '사람들을 새 인터페이스로 데려오는 일'에 있다는 판단이다.
• 이 영상은 개념 소개와 빠른 시작까지만 다루고, 세부 기능은 별도 영상으로 미뤘다. 실제 도입을 검토한다면 인증 연동과 평가 구성처럼 영상에서 짧게 지나간 부분을 따로 확인해야 한다.

자주 묻는 질문

관련 AI 소식