자체 호스팅 Claude Managed Agents
Claude Managed Agents 서비스와 해당 샌드박스를 자체 인프라에서 호스팅하세요. 각 부분을 누가 호스팅하는지, 언제 이 옵션을 선택해야 하는지, 어디서부터 시작해야 하는지 알아보세요.
자체 호스팅 Claude Managed Agents는 자체 인프라에서 실행하는 Managed Agents이며, 인프라는 클라우드 계정일 수도 있고 온프레미스 데이터 센터일 수도 있습니다. 서비스와 샌드박스를 직접 호스팅합니다. 모델은 Anthropic 또는 사용자가 선택한 공급자에서 실행됩니다.
Managed Agents에는 사용자가 호스팅할 수 있는 두 가지 부분이 있습니다.
- 샌드박스: 에이전트의 도구가 명령을 실행하고 파일 작업을 하는 컨테이너, VM 또는 기타 격리된 작업 공간입니다. 자체 호스팅 샌드박스를 참조하세요.
- 서비스: API, 에이전트 루프, 그리고 에이전트, 세션, 세션 기록을 위한 스토리지입니다.
자체 호스팅 샌드박스는 첫 번째 부분을 사용자에게 옮깁니다. 자체 호스팅 Managed Agents는 이를 확장하여 서비스까지 직접 호스팅합니다. 각 옵션의 이름은 사용자가 호스팅하는 항목을 나타냅니다.
| 옵션 | 샌드박스 | 서비스 | 모델 |
|---|---|---|---|
| 클라우드 샌드박스(기본값) | Anthropic | Anthropic | Anthropic |
| 자체 호스팅 샌드박스 | 사용자 | Anthropic | Anthropic |
| 자체 호스팅 Managed Agents | 사용자 | 사용자 | Anthropic 또는 사용자가 선택한 공급자 |
이 페이지들에서 호스팅 서비스란 Anthropic이 운영하는 서비스를 의미하고, 사용자의 서버란 자체 데이터베이스와 함께 사용자가 운영하는 서비스를 의미합니다. 두 서비스는 동일한 API를 제공하므로 SDK와 ant CLI가 사용자의 서버와 함께 작동하며, 나머지 Managed Agents 문서도 그대로 적용됩니다. 호스팅 서비스와의 차이점에 예외 사항이 나열되어 있습니다.
Claude Managed Agents는 Claude를 자율 에이전트로 실행합니다. 에이전트를 정의하고, 세션을 시작하고, 에이전트가 작업하는 동안 에이전트와 이벤트를 주고받습니다. 핵심 개념에서 에이전트, 환경, 세션, 이벤트를 설명합니다. 호스팅 서비스를 먼저 사용할 필요는 없습니다.
자체 호스팅 Managed Agents를 선택해야 하는 경우
다음 중 하나가 필요한 경우 자체 호스팅 Managed Agents를 선택하세요.
- 사용자 인프라에 저장: 에이전트, 세션, 세션 기록을 직접 저장해야 하는 경우.
- 추론 공급자 선택: 모델 호출이 Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry 또는 자체 모델 게이트웨이로 전달되어야 하는 경우. 추론 제공자를 참조하세요.
도구만 자체 인프라에서 실행하면 되는 경우 Anthropic이 서비스를 운영하는 자체 호스팅 샌드박스를 사용하세요. 에이전트 환경 선택하기를 참조하세요.
자체 호스팅 Managed Agents를 사용하면 서버, 해당 데이터베이스, 샌드박스를 직접 운영하고 보호해야 하며, 각 릴리스도 사용자가 직접 설치합니다. 일부 기능은 호스팅 서비스에만 있으므로 결정하기 전에 호스팅 서비스와의 차이점을 확인하세요.
각 구성 요소가 실행되는 위치
하나 이상의 서버, 해당 데이터베이스, 사용자의 샌드박스가 하나의 배포를 구성합니다.
- 서버 (
cma-server): API를 제공하고, 에이전트 루프를 실행하며, 에이전트, 세션, 각 세션의 기록을 저장합니다. 에이전트가 모델을 필요로 할 때마다 추론 공급자를 호출합니다. 서버는 에이전트의 셸 또는 파일 도구를 절대 실행하지 않습니다. - 데이터베이스: PostgreSQL 16 이상. 데이터베이스가 없으면 서버는 데이터를 메모리에 보관하며, 재시작하면 데이터가 삭제됩니다.
- 워커: 서버에서 작업을 받아 사용자의 샌드박스에서 에이전트의 셸 및 파일 도구를 실행하는 프로그램입니다. 워커는
ant beta:worker명령 또는 SDK 워커입니다. - 사용자 애플리케이션: SDK 또는
antCLI를 사용하여 서버에 접근하는 사용자의 코드와 스크립트입니다. - 서버의 콘솔: 서버 주소에 있는 웹 페이지로, 사용자는 ID 공급자를 통해 로그인하여 에이전트를 생성하고 세션을 실행합니다. 서버에서 콘솔 사용하기를 참조하세요.
- 관리자 CLI (
cma-server-admin): 환경과 해당 환경 키를 생성합니다. Linux(x86-64 및 Arm)와 Apple silicon 기반 macOS에서 실행됩니다.
사용자의 보안 책임
자체 호스팅 샌드박스의 보안 모델은 여기에 적용되지만, 두 가지 차이점이 있습니다. 해당 페이지에서 Anthropic이 담당하는 것으로 설명한 사항은 서버 보안, 메모리 스토어 호스팅, 비정상적인 사용 감지를 포함하여 모두 직접 책임져야 합니다. 또한 해당 페이지는 신뢰 경계마다 별도의 워크스페이스와 환경을 사용할 것을 제안합니다. 여기서는 멀티테넌시에서 설명하는 것처럼 신뢰 수준마다 별도의 배포가 필요합니다.
세 가지 자격 증명
| 자격 증명 | 보유자 | 인증 대상 |
|---|---|---|
| 서버 API 키 | 사용자 애플리케이션, ant CLI, 관리자 CLI | 서버에 대한 요청. 설정 과정에서 이 키가 생성됩니다. 호스팅 서비스에서 Claude API 키가 하는 역할을 합니다. |
| 추론 자격 증명 | 서버 | 서버가 추론 공급자로 보내는 모델 호출. 예를 들어 Claude API 키, 클라우드 공급자의 자격 증명 또는 모델 게이트웨이가 허용하는 토큰일 수 있습니다. 애플리케이션과 워커에는 이 자격 증명이 필요하지 않습니다. |
| 환경 키 | 서버를 폴링하는 사용자의 워커 | 한 환경의 작업 큐와 해당 환경의 세션. |
네트워크 외부로 나가는 데이터
각 모델 호출마다 서버는 도구 입력과 도구 결과를 포함하여 지금까지의 대화를 추론 공급자로 전송합니다. 기본적으로 이는 Claude API입니다. Claude API에 대한 호출에는 해당 세션의 ID와 그 세션의 에이전트 및 환경의 ID도 함께 포함됩니다. 자체 호스팅 Claude Managed Agents의 데이터 및 접근에는 서버가 만드는 모든 연결이 나열되어 있습니다. 또한 로그가 어디로 전송되는지, 누가 서버에 접근할 수 있는지도 설명합니다.
시작 위치
다운로드에 대한 접근 권한을 요청하려면 Anthropic 계정 팀에 문의하세요. 그런 다음 자체 호스팅 Claude Managed Agents 시작하기를 따라 서버를 시작하고 첫 세션을 실행하세요.
각 릴리스의 아카이브에는 해당 버전의 운영자 가이드인 operator-guide.md가 포함되어 있습니다. Claude가 이 파일을 읽도록 하면 Claude가 서버를 구성하고 실행하는 작업과 서버에 연결하는 코드를 작성하는 작업을 도와줄 수 있습니다.
이 페이지가 도움이 되었나요?