Claude Managed Agents — 레퍼런스와 활용 사례

Managed Agents 심층 학습 노트의 참고 편. 이벤트 타입, Rate Limit, 브랜딩 가이드, 베타 상태, 기업 활용 사례, 학습 체크리스트를 모았다.


10. 이벤트 타입 참고

타입방향설명
user.message앱 → 에이전트사용자 메시지 전송
agent.message에이전트 → 앱에이전트 텍스트 응답
agent.tool_use에이전트 → 앱도구 사용 이벤트
user.tool_confirmation앱 → 에이전트도구 사용 허가/거부
user.custom_tool_result앱 → 에이전트커스텀 도구 실행 결과 반환
session.status_idle에이전트 → 앱에이전트 작업 완료
session.thread_created에이전트 → 앱멀티에이전트: 새 스레드 생성
session.thread_idle에이전트 → 앱멀티에이전트: 스레드 작업 완료

11. API Rate Limits

작업제한
Create 엔드포인트 (agents, sessions, environments 생성 등)분당 60 요청
Read 엔드포인트 (retrieve, list, stream 등)분당 600 요청
  • 조직 수준의 지출 한도 및 티어 기반 Rate Limit도 별도 적용.

12. 브랜딩 가이드라인 (파트너용)

허용불허
”Claude Agent""Claude Code” 또는 “Claude Code Agent"
"Claude” (에이전트 메뉴 내부)“Claude Cowork"
"{제품명} Powered by Claude”Claude Code 스타일 ASCII 아트

13. 베타 상태 및 연구 프리뷰

기능상태
기본 에이전트/세션/환경공개 베타 (모든 API 계정 기본 활성화)
Outcomes (결과 정의)Research Preview — 접근 요청 필요
Multi-agent (다중 에이전트)Research Preview — 접근 요청 필요
Memory (메모리)Research Preview — 접근 요청 필요

14. 실제 활용 사례 (기업)

기업활용 내용
NotionCustom Agents 알파 — 코드 배포, 웹사이트·프레젠테이션 병렬 제작
Rakuten전사 에이전트 Slack/Teams 통합 (제품·영업·마케팅·재무·HR), 에이전트 1주 내 배포
AsanaAI Teammates — 인간과 협업하는 에이전트를 프로젝트 내 통합
Sentry디버깅 에이전트 Seer + 패치 작성 에이전트 → 버그 탐지→PR 생성 자동화

15. 학습 체크리스트

  • Agent, Environment, Session, Events 4대 개념 설명 가능한가?
  • Messages API와 Managed Agents의 차이를 언제 어느 것을 쓸지 설명 가능한가?
  • agent_toolset_20260401로 도구를 화이트리스트/블랙리스트 방식으로 설정 가능한가?
  • 커스텀 도구 정의 시 좋은 description을 작성할 수 있는가?
  • Multi-agent의 Thread 개념과 1단계 위임 제한을 이해하는가?
  • Memory Store를 생성하고 세션에 연결하는 코드를 쓸 수 있는가?
  • content_sha256 precondition으로 낙관적 동시성 제어를 구현할 수 있는가?
  • SSE 스트림을 열고 이벤트 타입별로 처리하는 코드를 쓸 수 있는가?