레퍼런스
Claude Managed Agents의 이벤트 유형, 자체 호스팅 워커 CLI 플래그, 지원되는 MCP 서버 유형, 속도 제한 및 브랜딩 가이드라인.
이 페이지는 Claude Managed Agents에 대한 레퍼런스 자료를 모아 놓은 것입니다. 작업 중심 가이드는 각 섹션의 링크를 따라가세요. 세션 리소스에 대한 작업은 세션 작업을 참조하세요.
이벤트 유형
영구 저장되는 이벤트 유형 문자열은 {domain}.{action} 명명 규칙을 따릅니다. 스트림 전용 이벤트 델타(이벤트 델타 탭 참조)는 예외입니다. 이벤트 전송, 스트리밍 및 목록 조회에 대해서는 세션 이벤트 스트림을 참조하세요. 웹훅 이벤트 유형은 웹훅 구독에 별도로 나열되어 있으며, 일부 이름은 스트림의 이름과 다릅니다(예: session.status_idle이 아닌 session.status_idled).
| 유형 | 설명 |
|---|---|
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 외부 경로를 읽고 쓸 수 있도록 허용합니다. workdir 검사는 파일 도구에만 적용되는 가드레일이며 샌드박스가 아닙니다. bash를 제한하지 않습니다. |
--max-idle | 세션이 end_turn 중지 이유로 유휴 상태가 된 후 종료하기 전까지 대기하는 시간입니다. 기본값은 60s입니다. |
--log-format | 로그 출력 형식입니다. 구조화된 로그 수집에는 json을 사용하세요. 기본값은 text입니다. |
CLI 워커는 메모리 저장소를 마운트하지 않습니다. 메모리 저장소를 연결한 세션은 여전히 실행되지만, 에이전트는 저장소의 mount_path에서 아무것도 찾지 못하며 변경 사항이 저장소로 다시 동기화되지 않습니다. 자체 호스팅 환경의 세션에서 메모리 저장소를 사용하려면 대신 SDK 워커를 실행하세요. 메모리 저장소 사용을 참조하세요.
지원되는 MCP 서버 유형
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 Agent"(드롭다운 메뉴에 권장)
- "Claude"(이미 "Agents"라고 표시된 메뉴 내에 있는 경우)
- "{YourAgentName} Powered by Claude"(기존 에이전트 이름이 있는 경우)
허용되지 않음:
- "Claude Code" 또는 "Claude Code Agent"
- "Claude Cowork" 또는 "Claude Cowork Agent"
- Claude Code 브랜드의 ASCII 아트 또는 Claude Code를 모방하는 시각적 요소
제품은 자체 브랜딩을 유지해야 하며 Claude Code, Claude Cowork 또는 기타 Anthropic 제품처럼 보여서는 안 됩니다. 브랜딩 준수에 관한 질문은 Anthropic 영업팀에 문의하세요.
Was this page helpful?