이 페이지는 Claude Managed Agents에 대한 참조 자료를 모아놓은 것입니다. 작업 중심 가이드는 각 섹션의 링크를 따라가세요. 세션 리소스에 대한 작업은 세션 작업을 참조하세요.
Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요하지만, 메모리 스토어 엔드포인트는 예외로 agent-memory-2026-07-22를 대신 사용합니다. SDK는 올바른 베타 헤더를 자동으로 설정합니다. 베타 헤더를 참조하세요.
영구 저장되는 이벤트 유형 문자열은 {domain}.{action} 명명 규칙을 따릅니다. 스트림 전용 이벤트 델타(이벤트 델타 탭 참조)는 예외입니다. 이벤트 전송, 스트리밍 및 목록 조회에 대해서는 세션 이벤트 스트림을 참조하세요.
| 유형 | 설명 |
|---|---|
user.message | 텍스트, 이미지 또는 문서 콘텐츠가 포함된 사용자 메시지입니다. |
user.interrupt | 실행 중인 에이전트를 중지합니다. |
user.custom_tool_result | 에이전트의 커스텀 도구 호출에 대한 응답입니다. |
user.tool_confirmation | 권한 정책이 확인을 요구할 때 에이전트 또는 MCP 도구 호출을 승인하거나 거부합니다. |
user.define_outcome | 에이전트가 달성해야 할 결과를 정의합니다. |
user.tool_result | self_hosted 환경을 사용하는 세션에서만 해당되며, 통합 코드가 agent_toolset 결과를 제공할 책임이 있습니다. SDK 헬퍼와 CLI는 이를 자동으로 수행합니다. |
다음은 self_hosted 환경을 구동하는 사전 구축된 워커를 위한 ant beta:worker CLI 플래그입니다. 환경 설정, 워커 실행 및 SDK 헬퍼 옵션에 대해서는 자체 호스팅 샌드박스를 참조하세요.
| 플래그 | 설명 |
|---|---|
--environment-id | 작업을 폴링할 환경입니다. ANTHROPIC_ENVIRONMENT_ID에서도 읽습니다. |
--environment-key | 이 환경으로 워커를 인증합니다. ANTHROPIC_ENVIRONMENT_KEY에서도 읽습니다. |
--workdir | 스킬이 다운로드되고 도구가 파일을 읽고 쓰는 디렉터리입니다. 기본값은 .(현재 디렉터리)이며, 시스템 기본 작업 디렉터리는 /workspace입니다. |
--on-work | 도구를 인프로세스로 실행하는 대신 각 클레임된 작업 항목에 대해 호출할 스크립트입니다. 세션 세부 정보를 환경 변수로 받습니다. |
--unrestricted-paths | 파일 도구가 --workdir 외부의 경로를 읽고 쓸 수 있도록 허용합니다. workdir 검사는 파일 도구에 대한 가드레일일 뿐 샌드박스가 아니며, bash를 제한하지 않습니다. |
--max-idle | 세션이 end_turn 중지 이유로 유휴 상태가 된 후 종료하기 전까지 대기하는 시간입니다. 기본값은 60s입니다. |
--log-format | 로그 출력 형식입니다. 구조화된 로그 수집을 위해서는 json을 사용하세요. 기본값은 text입니다. |
Claude Managed Agents는 HTTP 엔드포인트를 노출하는 원격 MCP 서버에 연결하거나, MCP 터널을 통해 프라이빗 MCP 서버에 연결합니다. 서버는 MCP 프로토콜의 스트리밍 가능한 HTTP 전송을 지원해야 합니다. 더 이상 사용되지 않는 SSE 전송만 지원하는 서버도 자동 폴백을 통해 계속 작동합니다. 에이전트에 서버를 선언하는 방법은 MCP 커넥터를 참조하세요.
MCP 및 MCP 서버 구축에 대한 자세한 내용은 MCP 문서를 참조하세요.
Managed Agents 엔드포인트는 조직별로 속도 제한이 적용됩니다:
| 작업 | 제한 |
|---|---|
| 생성 엔드포인트(에이전트, 세션, 환경 등) | 분당 300개 요청 |
| 읽기 엔드포인트(조회, 목록, 스트림 등) | 분당 1,200개 요청 |
조직 수준의 지출 한도 및 사용량 등급 속도 제한도 적용됩니다.
Claude Managed Agents를 통합하는 파트너의 경우 Claude 브랜딩 사용은 선택 사항입니다. 제품에서 Claude를 언급할 때:
허용:
허용되지 않음:
제품은 자체 브랜딩을 유지해야 하며 Claude Code, Claude Cowork 또는 기타 Anthropic 제품으로 보여서는 안 됩니다. 브랜딩 준수에 대한 질문은 Anthropic 영업팀에 문의하세요.
Was this page helpful?