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. 실제 활용 사례 (기업)
| 기업 | 활용 내용 |
|---|---|
| Notion | Custom Agents 알파 — 코드 배포, 웹사이트·프레젠테이션 병렬 제작 |
| Rakuten | 전사 에이전트 Slack/Teams 통합 (제품·영업·마케팅·재무·HR), 에이전트 1주 내 배포 |
| Asana | AI 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_sha256precondition으로 낙관적 동시성 제어를 구현할 수 있는가? - SSE 스트림을 열고 이벤트 타입별로 처리하는 코드를 쓸 수 있는가?
Related
- 2026-04-11-claude-managed-agents-deep-dive — 허브/개요
- 2026-04-11-claude-managed-agents-fundamentals — 핵심 개념과 빠른 시작
- 2026-04-11-claude-managed-agents-multi-agent-memory — 멀티 에이전트와 메모리