Decoupling the Brain from the Hands: Claude Managed Agents (Part 1 of 4) — Anthropic

한 줄 핵심

Claude Managed Agents의 핵심 아키텍처를 설명하며, 모델·하네스·샌드박스를 분리하고 인터페이스를 고정해 에이전트를 더 안전하고 유연하게 운영하는 방법을 소개하는 영상이다.

시간별 요약

1. 0:00
   환영 및 소개 Anthropic에서 Claude managed agents를 만든 팀이 나와, 첫 managed agent를 만드는 데 필요한 배경과 경험을 공유하는 자리다.
2. 0:58
   워크숍 진행 순서 먼저 managed agents의 진화와 시행착오를 설명한 뒤, 콘솔로 간단한 에이전트를 만들고 코드로 더 복잡한 에이전트를 구현하는 순서로 진행된다.
3. 2:05
   에이전트가 작동하는 방식 에이전트는 모델이 도구를 반복 호출하는 루프 구조이며, 작업이 끝날 때까지 다음 행동을 결정하고 실행하는 것이 핵심이다.
4. 3:06
   하네스와 모델 가정 하네스는 모델 주위를 감싸 도구 호출과 컨텍스트 관리를 맡는 계층이며, 각 모델의 약점을 가정하고 보완하는 로직을 담아야 한다.
5. 4:16
   샌드박스와 피해 범위 제한 에이전트가 실행하는 코드는 샌드박스나 컨테이너 안에 격리해야 하며, 작업마다 별도 실행 환경을 써서 실패나 오염의 영향을 최소화해야 한다.
6. 5:10
   첫 번째 아키텍처: 하나의 컨테이너에 모두 넣기 초기 설계는 세션 로그, 하네스, 실행 환경을 모두 한 컨테이너에 넣어 단순했지만, 서비스 경계가 없어 운영과 디버깅에서 큰 제약이 생겼다.
7. 6:05
   애완동물과 가축 문제 하나의 컨테이너에 의존하면 장애가 나도 대체하기 어려운 ‘애완동물’ 구조가 되며, 실제 운영에서는 교체 가능한 여러 인스턴스로 이루어진 ‘가축’ 구조가 더 적합하다.
8. 7:45
   뇌와 손의 분리 세션 로그, 하네스, 샌드박스와 MCP 도구 호출을 분리해 각 구성요소를 교체 가능하게 만들면, 장애가 나도 마지막 이벤트부터 작업을 재개할 수 있다.
9. 9:05
   자격 증명을 샌드박스 밖에 두기 토큰과 권한 정보는 샌드박스에 넣지 않고 프록시가 주입하게 만들어, 모델이 자격 증명에 직접 접근하거나 유출을 유도당하는 위험을 줄인다.
10. 9:49
    유연한 압축과 더 빠른 첫 토큰 append-only 이벤트 로그를 유지하면 압축 전략을 자유롭게 바꿀 수 있고, 샌드박스 준비를 기다리지 않아 첫 토큰 응답 지연도 크게 줄일 수 있다.
11. 10:49
    하나의 뇌, 여러 개의 손 하나의 하네스가 여러 샌드박스, 고객 VPC, MCP 서버를 손처럼 호출할 수 있어, 에이전트 아키텍처가 훨씬 범용적이고 확장 가능해진다.
12. 11:09
    인터페이스는 가정을 넘어선다 하네스에 들어간 가정은 쉽게 낡기 때문에, 세션 로그·하네스·손이라는 인터페이스를 안정적으로 설계해 모델과 구현이 바뀌어도 구조를 유지해야 한다.
13. 11:39
    API 크레딧 받기 실습을 위해 API 크레딧을 받고 플랫폼 계정에 로그인하거나 새 계정을 만들어야 하며, 이후 실습 환경에서 직접 에이전트를 만들어 볼 수 있다.
14. 12:24
    세 가지 핵심 인터페이스에 대한 질의응답 핵심은 append-only 세션 로그, 교체 가능한 하네스, 그리고 샌드박스·도구 호출을 담는 손이라는 세 가지 인터페이스이며, 이 조합이 확장성과 범용성을 만든다.
15. 13:49
    농담을 말하는 에이전트 만들기 간단한 에이전트를 만들기 위해 환경 API로 샌드박스 설정을 정의하고, 모델과 시스템 프롬프트, 기본 도구 세트를 묶어 joke teller 에이전트를 구성한다.
16. 15:18
    세션과 이벤트 스트림 세션은 agent ID와 environment ID로 생성되는 작업 단위이며, 사용자 메시지와 tool use, 에러, 중단 같은 이벤트가 오가는 스트림으로 상호작용이 관리된다.
17. 16:33
    콘솔 빠른 시작 콘솔의 managed agent 빠른 시작 가이드를 통해 첫 에이전트를 바로 만들어 볼 수 있으며, 이후에는 multi-agent와 memory 같은 고급 기능으로 확장할 수 있다.

실무 인사이트

• 에이전트 운영의 핵심은 모델 성능보다도 세션 로그, 하네스, 실행 환경을 어떻게 분리해 교체 가능하게 설계하느냐에 있다.
• 자격 증명 분리와 append-only 이벤트 로그는 보안과 디버깅을 동시에 개선하는 실전 패턴이다.
• 첫 구현은 단순해도 되지만, 운영 단계에서는 컨테이너를 ‘상태 없는 부품’처럼 다루는 구조로 빨리 전환하는 것이 좋다.