Escolhendo um ambiente de agente
Decida se as ferramentas e o código do Claude Managed Agents são executados em um ambiente em nuvem gerenciado pela Anthropic ou em um sandbox auto-hospedado, e veja o que muda se você alternar.
Um ambiente define onde as ferramentas e o código do seu agente são executados. Eles são executados em um sandbox. Um sandbox é um espaço de trabalho isolado, como um contêiner, onde o agente executa comandos e trabalha com arquivos. Você tem duas opções:
- Ambiente em nuvem: A Anthropic executa o sandbox para você. Cada sessão recebe seu próprio contêiner Linux novo em uma infraestrutura gerenciada pela Anthropic, com linguagens, bancos de dados e utilitários comuns já instalados. Você escolhe as regras de rede e quaisquer pacotes extras a serem instalados.
- Sandbox auto-hospedado: Você executa o sandbox em sua própria infraestrutura. Claude continua sendo executado no lado da Anthropic e determina qual ferramenta chamar em seguida. Um programa que você executa, chamado “worker” (processo de trabalho), realiza as chamadas das ferramentas de bash e de arquivos do agente em suas máquinas e envia cada resultado de volta. Ele também pode servir ferramentas personalizadas.
A definição do agente é a mesma, qualquer que seja a sua escolha. Você define o modelo, o prompt e as ferramentas no agente, não no ambiente.
Começar com um ambiente em nuvem
Se você não tem certeza de qual escolher, ou se é novo no Claude Managed Agents, comece com um ambiente em nuvem, como faz o início rápido. A Anthropic executa um contêiner isolado para cada sessão, com linguagens e ferramentas comuns já instaladas, então não há nada para você hospedar. Escolha um sandbox auto-hospedado somente se as ferramentas precisarem ser executadas em uma infraestrutura que você controla.
Comparar as opções
A tabela compara as duas opções.
| Ambiente em nuvem (padrão) | Sandbox auto-hospedado | |
|---|---|---|
| Onde as ferramentas e o código são executados | Um sandbox gerenciado pela Anthropic | Seu worker, na sua infraestrutura |
| O que chega à Anthropic | O histórico da conversa, os resultados de ferramentas, os arquivos e o estado do sandbox, skills e memory stores | O histórico da conversa, os resultados de ferramentas, skills e memory stores. Os arquivos e processos do sandbox permanecem no seu worker. |
| O que você opera | Nada | Os hosts do worker, o hardening deles, os limites de rede deles e a chave de ambiente com a qual seu worker se autentica |
| Alcance de rede | Regras de rede que você define no ambiente | Sua própria política de rede |
| Montagem de arquivos e repositórios do GitHub | Gerenciada pela Anthropic | Gerenciada por você |
| Memory stores | Montados pela Anthropic em /mnt/memory/ | Baixados para /mnt/memory/ e sincronizados pelo worker |
| Ciclo de vida do sandbox | Gerenciado pela Anthropic | Gerenciado por você |
| Escolha quando | O padrão. Você não precisa que as ferramentas sejam executadas na sua própria infraestrutura. | As ferramentas precisam ser executadas em uma infraestrutura que você controla. |
Quando escolher um sandbox auto-hospedado
Um sandbox auto-hospedado é adequado quando o agente precisa fazer uma das seguintes coisas:
- Trabalhar com dados que não podem sair da sua rede: Os arquivos e processos do agente permanecem no seu worker. O que uma ferramenta retorna ao modelo ainda chega ao serviço Managed Agents.
- Acessar serviços internos que não são roteáveis publicamente: As ferramentas de bash e de arquivos do agente, e quaisquer ferramentas personalizadas que seu worker sirva, são executadas dentro da sua rede. É a Anthropic, e não o seu worker, que se conecta aos servidores MCP do agente. Um servidor privado pode estar na frente do seu sistema interno de tickets ou da wiki da empresa. Para acessá-lo, você pode usar um túnel MCP com qualquer uma das opções. Os túneis MCP estão em prévia de pesquisa e exigem uma solicitação de acesso. Consulte Sandboxes auto-hospedados e túneis MCP.
- Operar sob os próprios controles de conformidade e auditoria da sua organização: As ferramentas são executadas em hosts que você configura, registra e audita.
O que um sandbox auto-hospedado não muda
Com qualquer uma das opções, o histórico da conversa e os resultados de ferramentas vão para o serviço Managed Agents, que a Anthropic opera. É assim que o modelo recebe o resultado de cada chamada de ferramenta. As ferramentas de pesquisa na web e web fetch também são executadas do lado da Anthropic, não no sandbox. Consulte Restringir domínios de pesquisa na web e web fetch. Nenhuma das opções altera a cobertura de conformidade do Managed Agents nem por quanto tempo ele mantém o histórico da conversa. Consulte API e retenção de dados.
O que você assume e do que abre mão com um sandbox auto-hospedado
Um sandbox auto-hospedado torna você o operador dos hosts do worker. Você faz o hardening da imagem do sandbox, controla o tráfego de saída da rede, armazena e rotaciona a chave de ambiente e isola as sessões umas das outras. A página Modelo de segurança tem os detalhes.
Você também abre mão destes recursos do ambiente em nuvem:
- Recursos de sessão
fileegithub_repository. Você prepara os arquivos de entrada por conta própria e também é responsável por montar seu próprio repositório do GitHub. - Descoberta de skills em repositórios.
- Credenciais de variáveis de ambiente em vaults.
- Os runtimes e pacotes pré-instalados de um sandbox em nuvem. Um sandbox auto-hospedado tem o que quer que seu worker forneça.
Diferenças no Claude Platform on AWS
Se você usa o Claude Managed Agents por meio do Claude Platform on AWS, a Anthropic ainda opera o serviço. Lá, um sandbox auto-hospedado não pode usar memory stores, os workers não usam uma chave de ambiente e os túneis MCP não estão disponíveis. Consulte Claude Managed Agents no Claude Platform on AWS e Recursos não suportados.
Diferenças no Claude Models on Google Cloud (Anthropic managed)
Se você usa o Claude Managed Agents por meio do Claude Models on Google Cloud (Anthropic managed), a Anthropic ainda opera o serviço. Lá, os memory stores não estão disponíveis em um sandbox auto-hospedado, e os túneis MCP não estão disponíveis. Os workers se autenticam com credenciais do Google Cloud, não com uma chave de ambiente. Você escreve o seu próprio worker, porque os workers pré-construídos na CLI ant e nos SDKs de Python, TypeScript e Go não funcionam lá. Consulte Suporte a recursos no guia do Claude Models on Google Cloud (Anthropic managed).
Mudar de um ambiente em nuvem para um sandbox auto-hospedado
Para mudar para um sandbox auto-hospedado, você mantém o agente, cria um ambiente self_hosted e referencia o ID dele em novas sessões e implantações.
- O que é mantido: A definição do agente, a chave de API, as credenciais do Google Cloud ou as credenciais da AWS que sua aplicação usa, suas skills, seus servidores MCP e seus armazenamentos de memória.
- O que é novo: Um ambiente
self_hosted, uma chave de ambiente que você gera no Claude Console e um worker que você executa. O início rápido de sandboxes auto-hospedados aborda os três. - O que deixa de funcionar: Os recursos listados em O que você assume e do que abre mão com um sandbox auto-hospedado.
No Claude Platform on AWS, os memory stores não são mantidos em um sandbox auto-hospedado, e o worker não usa uma chave de ambiente. Consulte Diferenças no Claude Platform on AWS.
No Claude Models on Google Cloud (Anthropic managed), os memory stores não estão disponíveis em um sandbox auto-hospedado, e você escreve seu próprio worker, que não usa uma chave de ambiente. Consulte Diferenças no Claude Models on Google Cloud (Anthropic managed).
Esta página foi útil?