이 페이지는 Claude Managed Agents에 대한 참조 자료를 모아 놓은 것입니다. 작업 중심 가이드는 각 섹션의 링크를 참조하세요. 세션 리소스에 대한 작업은 세션 작업을 참조하세요.
모든 Managed Agents API 요청에는 managed-agents-2026-04-01 베타 헤더가 필요합니다. SDK는 베타 헤더를 자동으로 설정합니다.
지속되는 이벤트 유형 문자열은 {domain}.{action} 명명 규칙을 따릅니다. 스트림 전용 이벤트 델타(Event deltas 탭 참조)는 예외입니다. 이벤트 전송, 스트리밍 및 나열에 대해서는 세션 이벤트 스트림을 참조하세요.
| 유형 | 설명 |
|---|---|
user.message | 텍스트 콘텐츠가 포함된 사용자 메시지입니다. |
user.interrupt | 실행 중인 에이전트를 중단합니다. |
user.custom_tool_result | 에이전트의 커스텀 도구 호출에 대한 응답입니다. |
user.tool_confirmation | 권한 정책이 확인을 요구할 때 에이전트 또는 MCP 도구 호출을 승인하거나 거부합니다. |
user.define_outcome | 에이전트가 달성하기 위해 작업할 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 외부의 경로에 접근할 수 있도록 허용합니다. |
--max-idle | 세션이 end_turn 중지 이유로 유휴 상태가 된 후 종료하기 전까지 대기할 시간입니다. 기본값은 60s입니다. |
--log-format | 로그 출력 형식입니다. 구조화된 로그 수집을 위해서는 json을 사용하세요. 기본값은 text입니다. |
Claude Managed Agents는 HTTP 엔드포인트를 노출하는 원격 MCP 서버에 연결하거나, MCP 터널을 통해 프라이빗 MCP 서버에 연결합니다. 서버는 MCP 프로토콜의 스트리밍 가능한 HTTP 전송을 지원해야 합니다. 에이전트에서 서버를 선언하는 방법은 MCP 커넥터를 참조하세요.
MCP 및 MCP 서버 구축에 대한 자세한 내용은 MCP 문서를 참조하세요.
Managed Agents 엔드포인트는 조직별로 속도 제한이 적용됩니다.
| 작업 | 제한 |
|---|---|
| 생성 엔드포인트(에이전트, 세션, 환경 등) | 분당 300개 요청 |
| 읽기 엔드포인트(조회, 나열, 스트림 등) | 분당 1,200개 요청 |
조직 수준의 지출 한도 및 사용량 등급 속도 제한도 적용됩니다.
Claude Managed Agents를 통합하는 파트너의 경우 Claude 브랜딩 사용은 선택 사항입니다. 제품에서 Claude를 언급할 때:
허용됨:
허용되지 않음:
제품은 자체 브랜딩을 유지해야 하며 Claude Code, Claude Cowork 또는 기타 Anthropic 제품처럼 보여서는 안 됩니다. 브랜딩 준수에 대한 질문은 Anthropic 영업팀에 문의하세요.
Was this page helpful?