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 na sua própria infraestrutura. Claude continua sendo executado do lado da Anthropic e decide qual ferramenta chamar em seguida. Um programa que você executa, chamado de worker, realiza as chamadas de ferramentas de bash e de arquivos do agente nas 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 de busca na web também são executadas do lado da Anthropic, não no sandbox. Consulte Restringir domínios de pesquisa na web e busca na web. 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.
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 ou as credenciais da AWS que sua aplicação usa, suas skills, seus servidores MCP e seus memory stores.
- 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.
Was this page helpful?