[한영자막] Anthropic Claude Managed Agents: 두뇌와 손을 분리한 설계 (1부)

한 줄 핵심

Claude Managed Agents는 모델, 하네스, 샌드박스, 세션을 분리해 보안성과 장애 복원력을 높이고, 더 유연하게 에이전트를 운영하는 설계를 소개하는 워크숍이다.

시간별 요약

0:00
발표자 소개와 워크숍 안내 Anthropic에서 Claude managed agents를 만든 팀이 워크숍의 목적과 진행 방식을 소개한다. 이번 세션은 첫 managed agent를 직접 만들어 보는 실습과, 그 과정에서 얻은 설계 경험을 공유하는 데 초점이 맞춰져 있다.
0:45
에이전트와 하네스의 구성 에이전트는 모델이 도구를 반복 호출하는 루프이며, 하네스는 그 루프를 감싸서 실행을 조율하는 계층이다. 실습은 코드 작성 없이 콘솔에서 간단한 에이전트를 먼저 만들고, 이후 코드 기반으로 더 복잡한 에이전트를 확장하는 흐름으로 진행된다.
2:20
샌드박스와 보안 경계 하네스는 모델이 할 수 없는 부분을 메우면서 컨텍스트 관리와 도구 호출을 책임진다. 실제 작업은 샌드박스나 container에서 실행되며, 생산 환경에서는 에이전트가 작성한 코드가 신뢰할 수 없다는 전제 아래 격리와 제한된 blast radius가 중요하다.
4:24
에이전트 실행 구조 초기 아키텍처는 세션 로그, 하네스, 샌드박스 실행을 모두 container 안에 넣는 방식이었고, 이로 인해 디버깅과 장애 대응이 매우 어려웠다. 고객 데이터 접근, MCP 연결, 장애 복구 측면에서 한계가 드러나면서 단일한 묶음 구조가 운영상 취약하다는 문제가 확인됐다.
6:59
두뇌와 손을 분리한 설계 세션 로그, 하네스, 샌드박스를 분리해 두뇌와 손을 독립적인 인터페이스로 만들면 각 요소가 고장 나도 다시 띄워서 이어갈 수 있다. 자격 증명은 샌드박스에 직접 들어가지 않고 proxy를 통해 주입되며, append-only 이벤트 로그 덕분에 컨텍스트 압축 전략을 유연하게 바꿀 수 있다.
10:03
유연한 인터페이스 하나의 하네스가 여러 샌드박스, 고객 VPC, MCP server를 모두 향할 수 있어 구조가 훨씬 플러그인처럼 확장된다. 하네스가 품는 가정은 시간이 지나면 낡을 수 있으므로, 인터페이스를 오래 살아남는 형태로 설계하는 것이 핵심이다.
10:58
첫 에이전트 만들기 가장 단순한 예제로 농담을 들려주는 에이전트를 만들며, environment API로 샌드박스 환경과 네트워크·패키지 구성을 먼저 정의한다. 그다음 agent를 생성해 모델, system prompt, 기본 tool set을 지정하면 첫 에이전트의 뼈대가 완성된다.
12:32
세션과 이벤트 스트림 session은 agent ID와 environment ID를 묶어 만든 작업 단위이며, 이벤트를 보내기 전에는 idle 상태다. user.message, custom tool use, custom tool result, session.error 같은 이벤트 흐름을 통해 에이전트와 상호작용하고, interrupt로 세션을 중단할 수 있다.
13:46
콘솔 빠른 시작 콘솔의 managed agent 섹션에는 guided quick start가 있어 첫 에이전트를 바로 시작할 수 있다. 이후에는 multi-agent와 memory 같은 더 고급 기능도 이어서 다룰 수 있도록 안내한다.

실무 인사이트

에이전트 아키텍처는 모델 성능보다도 하네스와 상태 분리 설계가 운영 안정성과 디버깅 난이도를 좌우한다.
샌드박스와 자격 증명 주입 경로를 분리하면 prompt injection과 비밀 유출 위험을 크게 줄일 수 있다.
세션 로그를 append-only로 유지하면 나중에 컨텍스트 압축 전략이나 하네스 구현을 바꿔도 동일한 이벤트 이력을 기반으로 재현성과 유연성을 확보할 수 있다.