Anthropic SDK에 Managed Agents 등장: 멀티에이전트 공식 지원

안녕하세요, Tom입니다.

Anthropic SDK에 꽤 의미 있는 업데이트가 나왔어요. 5월 6일과 7일에 걸쳐 TypeScript SDK v0.95.0과 Python SDK v0.100.0이 릴리즈됐는데, 핵심은 Managed Agents예요. 멀티에이전트 오케스트레이션이 SDK 레벨에서 공식 지원되기 시작한 거예요.

그동안 멀티에이전트 시스템을 구현하려면 LangGraph, CrewAI 같은 서드파티 프레임워크를 쓰거나, 직접 오케스트레이션 로직을 짜야 했어요. 이번 업데이트로 Anthropic이 자체 SDK에서 이걸 직접 지원하겠다고 선언한 거예요. 방향성 자체가 중요한 릴리즈라고 생각해요.

Managed Agents: 멀티에이전트와 Outcomes

이번 릴리즈의 가장 큰 변화는 Managed Agents예요. 여러 에이전트를 API를 통해 관리하고, 각 에이전트의 실행 결과(Outcomes)를 추적할 수 있어요.

기존에 Claude API로 에이전트를 만들면, 하나의 대화 세션 안에서 도구 호출을 반복하는 구조였어요. 에이전트가 하나일 때는 괜찮은데, 여러 에이전트가 협업해야 하는 시나리오에서는 한계가 있었죠. 에이전트 간 상태 공유, 작업 위임, 결과 수집 같은 걸 전부 개발자가 직접 구현해야 했어요.

Managed Agents는 이 문제를 SDK 레벨에서 해결하려는 시도예요. 에이전트를 생성하고, 작업을 할당하고, 그 결과를 체계적으로 수집하는 구조를 API가 제공해요. 특히 Outcomes 지원이 눈에 띄는데, 각 에이전트가 어떤 결과를 냈는지를 구조화된 형태로 받아볼 수 있다는 거예요.

실무에서 이게 어떤 의미인지 생각해보면, 예를 들어 코드 리뷰 파이프라인을 만든다고 해요. 보안 검토 에이전트, 성능 분석 에이전트, 스타일 가이드 점검 에이전트를 각각 띄워서 동시에 돌리고, 각각의 결과를 종합하는 구조를 SDK 레벨에서 지원받을 수 있게 되는 거예요. 이전에는 이 구조를 짜려면 상당한 보일러플레이트가 필요했어요.

웹훅: 이벤트 기반 통합

웹훅 기능도 새로 추가됐어요. 에이전트의 실행 완료, 상태 변경 같은 이벤트를 외부 시스템으로 전달할 수 있어요.

이게 Managed Agents와 결합되면 꽤 강력해져요. 에이전트가 작업을 완료했을 때 Slack으로 알림을 보내거나, CI/CD 파이프라인의 다음 단계를 트리거하거나, 결과를 데이터베이스에 기록하는 식의 워크플로우를 이벤트 기반으로 구성할 수 있어요.

폴링 방식으로 에이전트 상태를 계속 확인하는 것보다 훨씬 효율적이고 깔끔해요. 서버리스 환경에서 에이전트를 운영할 때 특히 유용할 거예요.

Vault 검증: 크레덴셜 관리

Vault validation도 눈에 띄는 추가 기능이에요. 에이전트가 외부 서비스에 접근할 때 필요한 인증 정보를 안전하게 관리하는 구조예요.

에이전트가 실제 업무를 자동화하려면 결국 외부 API를 호출해야 하는데, 그때마다 API 키를 에이전트에게 직접 넘기는 건 보안상 좋지 않아요. Vault를 통해 크레덴셜을 중앙에서 관리하고, 에이전트별로 접근 권한을 제어할 수 있다면 훨씬 안전해지죠. 프로덕션 환경에서 에이전트를 운영하려는 팀에게 반가운 기능이에요.

이전 버전 맥락: OIDC Federation

참고로 바로 이전 버전인 v0.94.0에서는 OIDC federation token exchange가 워크스페이스 단위로 추가됐었어요. 기업 환경에서 기존 인증 시스템과 Anthropic API를 연결할 수 있게 해주는 기능이에요.

이걸 이번 업데이트와 연결해서 보면, Anthropic이 엔터프라이즈 환경에서의 에이전트 운영을 체계적으로 준비하고 있다는 그림이 보여요. 인증(OIDC) - 크레덴셜 관리(Vault) - 에이전트 오케스트레이션(Managed Agents) - 이벤트 통합(Webhooks)으로 이어지는 스택이에요.

TypeScript와 Python 동시 릴리즈

TypeScript SDK v0.95.0과 Python SDK v0.100.0이 같은 기능을 거의 동시에 릴리즈했어요. 버전 번호는 다르지만 기능 세트는 동일해요. 이전에는 TypeScript SDK가 먼저 나오고 Python이 따라오는 패턴이 있었는데, 이번에는 동시 릴리즈로 맞춘 점이 인상적이에요.

두 언어 SDK를 동시에 릴리즈한다는 건, 내부적으로 SDK 코드 생성이나 API 스펙 관리가 성숙했다는 신호이기도 해요.

개발자 관점에서 보면

솔직히 말하면, Managed Agents가 실제로 얼마나 편한지는 직접 써봐야 알 수 있어요. API 설계가 어떤지, 에이전트 간 상태 공유가 얼마나 유연한지, 에러 핸들링은 어떤지 같은 디테일이 중요하거든요.

그래도 방향 자체는 맞다고 봐요. 지금까지 멀티에이전트 시스템의 가장 큰 문제는 프레임워크가 너무 많고, 각각의 추상화 수준이 다르고, 모델 제공사의 API와 따로 놀았다는 거예요. 모델을 만든 회사가 직접 오케스트레이션까지 SDK에서 지원하면, 적어도 "이 모델에 최적화된 에이전트 패턴"이라는 보장이 있어요.

OpenAI도 Agents SDK를 내놨고, Google도 ADK를 발표했고, 이제 Anthropic도 공식적으로 멀티에이전트를 SDK에 넣었어요. 흥미로운 건 OpenAI는 오케스트레이션 레이어와 샌드박스 실행 환경을 분리하는 방향으로 갔는데, Anthropic은 이번에 Managed Agents와 Outcomes 추적부터 손댔다는 점이에요. 같은 멀티에이전트 지원이라도 출발점이 다른 거죠. 2026년은 에이전트 오케스트레이션이 모델 제공사의 기본 제공 기능이 되는 해가 될 것 같아요. 서드파티 프레임워크들이 어떻게 차별화할지가 다음 관전 포인트가 될 거예요.

개인적으로 한국 개발자 입장에서 가장 반가운 부분은 TypeScript와 Python SDK가 동시에, 같은 기능 세트로 나왔다는 점인 것 같아요. 국내 팀들은 프론트엔드/풀스택은 TypeScript, 데이터/백엔드는 Python으로 스택이 갈리는 경우가 많은데, 어느 쪽으로 에이전트를 짜든 같은 Managed Agents API를 쓸 수 있다는 게 도입 부담을 꽤 줄여줄 것 같아요.

---

원문: Anthropic SDK TypeScript v0.95.0