Anthropic 엔지니어, Claude 관리 에이전트 세션 소개
세션에서는 관리 에이전트의 역사적 발전, 설계의 일반적인 함정, 그리고 효율적인 구축을 위한 실제적인 접근 방식에 대해 다루었으며, 핸즈온 코딩에 중점을 두었습니다.
Anthropic의 Claude Managed Agents를 위한 새로운 아키텍처는 핵심 구성 요소를 분리하여 보안, 유연성 및 운영 효율성을 향상시킵니다.
세션에서는 관리 에이전트의 역사적 발전, 설계의 일반적인 함정, 그리고 효율적인 구축을 위한 실제적인 접근 방식에 대해 다루었으며, 핸즈온 코딩에 중점을 두었습니다.
프리얀카는 에이전트를 근본적으로 '도구를 사용하는 루프 안의 모델'이라고 설명하며, 모델이 다양한 도구를 호출하여 다음 동작을 지속적으로 결정하고 수행하는 반복적인 과정을 강조했습니다.
이러한 의사 결정 및 도구 호출 루프는 지정된 작업이 성공적으로 완료될 때까지 지속되며, 전체 구조는 모델 자체, 주변 하네스 및 샌드박스 또는 계산 환경으로 구성됩니다.
하네스는 Sonnet 45와 같은 모델에서 관찰되는 '컨텍스트 불안'과 같은 모델의 본질적인 한계 및 특정 동작을 사전에 보완하여 모델이 스스로 해결할 수 없는 부분을 채워줌으로써 Opus 45와 같은 최신 버전을 포함한 진화하는 모델 기능 전반에 걸쳐 에이전트 기능을 유지합니다.
에이전트는 생성된 코드를 실행하기 위해 샌드박스 또는 컴퓨팅 환경에 대한 접근이 필요합니다. 이 코드는 신뢰할 수 없거나 버그를 포함할 수 있으므로 강력한 격리가 필수적입니다.
위험을 완화하기 위해 Anthropic은 각 작업을 자체적인 별도 컨테이너 내에서 실행하도록 의무화하며, 이는 의도하지 않은 부작용을 방지하고 잠재적인 오류의 '피해 범위'를 단일 격리된 인스턴스로 효과적으로 제한하는 모범 사례입니다.
작년 12월 초기 관리 에이전트 아키텍처를 받은 초기 액세스 고객들의 피드백은 Anthropic이 접근 방식을 재평가하도록 촉발했습니다.
이 피드백은 세션 로그와 하네스를 포함한 모든 구성 요소를 단일 컨테이너에 통합했던 원래의 설계를 벗어나 완전히 새로운 아키텍처로 전략적 재평가 및 전환을 유도했습니다.
Claude Managed Agents의 초기 아키텍처 설정은 두뇌와 샌드박스 실행을 단일의 긴밀하게 결합된 컨테이너로 통합했으며, 이는 '펫(pet)' 비유를 사용하여 설명되었습니다.
쉽게 교체할 수 있는 일회용 '캐틀(cattle)' 인스턴스와 달리, '펫'은 고유하고 직접 관리되는 개체로, 실패할 경우 상당한 운영 오버헤드를 초래했으며, 이는 초기 모놀리식 설계의 경우와 같았습니다.
단일 컨테이너 내에서 실패 지점을 격리하기 어려웠던 점을 포함한 운영상의 난관은 원래 모놀리식 아키텍처의 디버깅 과정을 복잡하게 만들었습니다.
고객 데이터가 컨테이너에 직접 상주하여 보안 문제도 발생했으며, 네트워크 피어링 또는 소프트웨어 하네스를 고객 VPC(Virtual Private Cloud)로 배송하는 복잡성으로 인해 멀티 클라우드 공급자(MCP) 환경과의 통합은 비효율적이었습니다.
Claude Managed Agents를 위한 새로운 아키텍처 설계는 시스템을 세 가지 고유한 인터페이스(세션(이벤트 로그), 두뇌(하네스 및 Claude 모델 포함), 손(샌드박스 및 MCP 도구 호출 포함))로 근본적으로 분리합니다.
이러한 분리를 통해 각 구성 요소를 '캐틀'로 취급할 수 있습니다. 즉, 복구를 위해 필요에 따라 샌드박스를 생성하고 교체할 수 있으며, 하네스가 실패하면 시스템은 추가 전용 이벤트 로그를 다시 읽어 원활하게 작업을 재개할 수 있으므로 세션 로그만 중요하고 다른 요소는 교체 가능합니다.
이전 버전의 Claude Managed Agents는 샌드박스 내에서 자격 증명을 노출하여 모델이 민감한 토큰을 공개하도록 속이는 프롬프트 인젝션 공격에 취약했습니다.
재설계된 시스템은 이제 외부 API 호출에 필요한 경우에만 토큰을 안전하게 주입하기 위해 프록시를 사용하며, Claude 자체가 실제 자격 증명에 직접 접근하거나 처리하지 않도록 보장하여 토큰 노출 위험을 크게 완화합니다.
새로운 아키텍처는 압축하거나 버리지 않고 모든 상호 작용을 유지하는 영구적인 추가 전용 이벤트 로그를 통합하며, 별도의 압축 전략은 로그의 어떤 부분이 모델의 컨텍스트 창에 들어갈지 독립적으로 결정합니다.
이러한 아키텍처 변경은 또한 추론 성능을 극적으로 향상시켰는데, 특히 시작 지연 없이 온디맨드로 샌드박스를 생성할 수 있게 되어 첫 토큰까지의 시간을 90% 단축했습니다.
새로운 아키텍처는 모듈형 인터페이스로 설계되어 단일 '두뇌'가 VPC, MCP, 샌드박스와 같은 다양한 환경을 포괄하는 여러 '손'을 효과적으로 관리할 수 있습니다.
이러한 설계 철학은 인터페이스가 초기 하네스 설계에 종종 포함되는 초기 가정을 능가하고 적응할 수 있도록 보장하여 장기적인 유연성과 탄력성을 제공합니다.
모듈형 아키텍처를 통해 개발자는 압축 전략과 전체 하네스를 포함한 다양한 구성 요소를 핵심 인터페이스를 변경하지 않고도 쉽게 교체할 수 있습니다.
이러한 확장성은 시스템이 일반적이고 적응력을 유지하며, 미래의 기술 변화를 견뎌내고 보다 플러그형 운영 방식을 촉진하도록 보장합니다.
Anthropic의 새로운 에이전트 아키텍처의 견고성은 추가 전용 세션 로그, 교체 가능한 하네스, 샌드박스 도구 호출을 위한 일반 '손'이라는 세 가지 핵심 인터페이스에 달려 있습니다.
추가 전용 세션 로그는 모든 상호 작용을 세밀하게 기록하고, 교체 가능한 하네스는 실행 환경을 에이전트의 핵심 로직과 분리하며, '손'은 모델에 외부 기능에 대한 유연한 접근을 제공하여 시스템을 미래의 요구 사항에 더욱 일반적이고 확장 가능하게 만듭니다.
Claude Managed Agent 설정 프로세스는 샌드박스 네트워킹을 설정하고 패키지 설치를 관리하는 Environments API(v1/environments) 구성으로 시작됩니다.
두 번째 단계는 에이전트 자체를 생성하는 것으로, 이름 지정, Opus, Haiku 또는 Sonnet과 같은 적합한 모델 선택, 그리고 작동에 필요한 시스템 프롬프트 및 도구 세트를 정의하는 것을 포함합니다.
마지막으로 세 번째 단계는 이전에 정의된 에이전트 ID와 환경 ID를 활용하여 세션을 생성하는 것으로, 이는 에이전트의 기본적인 작업 단위로 사용됩니다.
사용자 지정 도구를 사용하면 개발자가 특정 기능을 정의하고 응답을 처리할 수 있습니다. 사용자 지정 도구가 호출되면 Claude는 '사용자 지정 도구 사용' 이벤트를 이벤트 스트림에 배치하고, 시스템은 이를 수신하고 처리하여 결과를 반환할 수 있습니다.
Claude Managed Agents는 이벤트 기반 아키텍처에서 작동하며, 메시지 전송과 같은 사용자 시작 이벤트는 이벤트 스트림을 통해 다시 전달되는 에이전트 응답을 트리거합니다.
이 상호 작용 모델을 통해 개발자는 특정 도구 사용 이벤트를 가로채고 처리한 다음 '도구 결과'를 Claude에 반환하여 분산 시스템 내에서 복잡하고 대화형 워크플로우를 촉진하는 사용자 지정 도구를 정의할 수 있습니다.
Claude Managed Agents는 실행 중에 오류가 발생했음을 나타내는 '세션 오류' 이벤트를 포함하여 다양한 세션 상태 및 오류를 고유한 시스템 이벤트를 통해 전달합니다.
'status idle' 이벤트는 세션이 비활성 상태이며 샌드박스에 연결되어 있지 않음을 나타내며, 'interrupt' 기능은 사용자가 세션을 강제로 종료하여 더 이상 필요하지 않을 때 진행 중인 작업을 중단할 수 있도록 합니다.
개발자는 platform.claude.ai로 이동하여 API 크레딧에 액세스하고 Claude Managed Agents 작업을 시작할 수 있습니다.
Anthropic 콘솔 내의 전용 'managed agent section'에는 '빠른 시작' 가이드가 포함되어 있으며, 이는 첫 AI 에이전트를 구축하려는 개발자를 위한 포괄적인 안내 투어를 제공합니다.
자막에서 근거가 되는 대목을 찾아 답합니다.
AI Engineer의 다음 글도 받아볼까요?
AI Engineer에 새 영상이 올라오면, 방금 읽으신 것처럼 정리해서 메일로 보내 드릴게요.
이 채널은 지난 7일 동안 96편 올렸어요.