Claude Managed Agents auto-hospedado

O Claude Managed Agents auto-hospedado é o Managed Agents na sua própria infraestrutura, que pode ser uma conta de nuvem ou um data center on-premise. Você hospeda o serviço e os sandboxes. O modelo é executado na Anthropic ou em um provedor que você escolher.

O Managed Agents tem duas partes que você pode hospedar:

• Sandboxes: Os contêineres, VMs ou outros espaços de trabalho isolados onde as ferramentas de um agente executam comandos e trabalham com arquivos. Consulte Sandboxes auto-hospedados.
• O serviço: A API, o loop do agente e o armazenamento de agentes, sessões e histórico de sessões.

Os sandboxes auto-hospedados passam a primeira parte para você. O Managed Agents auto-hospedado estende isso: você também hospeda o serviço. O nome de cada opção diz o que você hospeda:

Nestas páginas, o serviço hospedado é o serviço executado pela Anthropic, e o seu servidor é o serviço executado por você, com o seu próprio banco de dados. Ambos têm a mesma API, então o SDK e a CLI ant funcionam com o seu servidor, e o restante da documentação do Managed Agents se aplica. Diferenças em relação ao serviço hospedado lista as exceções.

Quando escolher o Managed Agents auto-hospedado

Escolha o Managed Agents auto-hospedado quando você precisar de um dos seguintes itens:

• Armazenamento na sua infraestrutura: Você precisa armazenar agentes, sessões e histórico de sessões por conta própria.
• Sua escolha de provedor de inferência: As chamadas ao modelo precisam ir para o Amazon Bedrock, o Claude Models on Google Cloud (Google managed), o Microsoft Foundry ou o seu próprio gateway de modelos. Consulte Provedor de inferência.

Se você só precisa que as ferramentas sejam executadas na sua infraestrutura, use os sandboxes auto-hospedados, nos quais a Anthropic executa o serviço. Consulte Escolhendo um ambiente de agente.

Com o Managed Agents auto-hospedado, você executa e protege um servidor, o banco de dados dele e os seus sandboxes, e instala cada versão por conta própria. Alguns recursos existem apenas no serviço hospedado, então consulte Diferenças em relação ao serviço hospedado antes de decidir.

O que é executado onde

Um ou mais servidores, o banco de dados deles e os seus sandboxes formam uma implantação.

• Servidor (cma-server): Atende a API, executa o loop do agente e armazena agentes, sessões e o histórico de cada sessão. Ele chama o seu provedor de inferência sempre que o agente precisa do modelo. O servidor nunca executa as ferramentas de shell ou de arquivos de um agente.
• Banco de dados: PostgreSQL 16 ou posterior. Sem um banco de dados, o servidor mantém seus dados na memória, e uma reinicialização os apaga.
• Workers: Programas que recebem trabalho do servidor e executam as ferramentas de shell e de arquivos do agente nos seus sandboxes. Um worker é um comando ant beta:worker ou um worker do SDK.
• Suas aplicações: Seu próprio código e scripts, que acessam o servidor com o SDK ou a CLI ant.
• Console do seu servidor: Uma página web no endereço do servidor, onde as pessoas fazem login pelo seu provedor de identidade para criar agentes e executar sessões. Consulte Usar o console no seu servidor.
• CLI de administração (cma-server-admin): Cria ambientes e as chaves de ambiente deles. Ela é executada no Linux (x86-64 e Arm) e no macOS em Apple silicon.

Suas responsabilidades de segurança

O Modelo de segurança dos sandboxes auto-hospedados se aplica aqui, com duas diferenças. O que essa página atribui à Anthropic é responsabilidade sua, incluindo proteger o servidor, hospedar os memory stores e detectar uso incomum. Essa página também sugere um workspace e um ambiente separados para cada fronteira de confiança. Aqui, cada nível de confiança precisa de sua própria implantação, como explica Multilocação.

As três credenciais

O que sai da sua rede

Para cada chamada ao modelo, o servidor envia a conversa até o momento, incluindo entradas e resultados de ferramentas, ao seu provedor de inferência. Por padrão, esse provedor é a Claude API. Uma chamada à Claude API também carrega os IDs da sessão dela e do agente e do ambiente dessa sessão. Dados e acesso no Claude Managed Agents auto-hospedado lista cada conexão que o servidor faz. Também diz para onde vão os logs e quem pode acessar o servidor.

Por onde começar

Para solicitar acesso ao download, entre em contato com a equipe da sua conta na Anthropic. Em seguida, siga Comece a usar o Claude Managed Agents auto-hospedado para iniciar um servidor e executar uma primeira sessão.

O arquivo de cada versão inclui um guia do operador para essa versão, operator-guide.md. Peça ao Claude para ler esse arquivo, para que o Claude possa ajudar você a configurar e executar o seu servidor e a escrever código que se conecte a ele.