Diferenças em relação ao serviço hospedado

Um servidor auto-hospedado do Claude Managed Agents tem a mesma API do serviço hospedado Managed Agents da Anthropic, exceto pelas diferenças desta página. As tabelas dizem o que fazer em cada caso. Consulte-as antes de mover uma aplicação para o seu servidor. Nada é copiado do serviço hospedado, incluindo o histórico de sessões. Crie novamente seus agentes, skills, credenciais de vault e memory stores no seu servidor.

Recursos que só o seu servidor tem

Recursos que não estão disponíveis

Recursos que se comportam de forma diferente

Recursos que precisam de uma configuração do servidor

Cada um desses recursos fica desativado, ou recusa todos os hosts, até que você altere o arquivo de configurações do servidor.

Servidores MCP precisam de uma entrada na allowlist

O servidor se conecta apenas a servidores MCP cujos hosts você lista em mcp.allowed_hostnames no arquivo de configurações dele:

mcp:
  allowed_hostnames:
    - mcp.example.com

Os hosts correspondem exatamente, sem curingas e sem subdomínios, e a lista fica vazia por padrão. Até que o host de um servidor MCP esteja na lista, seu servidor se recusa a salvar um agente que o mencione.

Um servidor MCP dentro da sua rede privada não precisa de um túnel MCP. Coloque a URL dele na definição do agente, como descreve o Conector MCP, e adicione o host dele à allowlist. Duas regras se aplicam à URL:

• Ela deve usar https, a menos que o servidor MCP esteja no endereço de loopback.
• Se o host dela for um nome que resolve apenas para endereços privados ou reservados, seu servidor se recusa a se conectar por padrão. Escolha a correção adequada ao seu caso:

Repositórios Git precisam de uma entrada na allowlist

No serviço hospedado, sessões que usam sandboxes auto-hospedados não podem ter recursos github_repository. No seu servidor, elas podem. O servidor rejeita esses recursos até que você liste os hosts Git deles no arquivo de configurações dele. Os agentes podem fazer push apenas para os branches que você lista:

git:
  allowed_hostnames:
    - github.com
  allowed_push_refs:
    - refs/heads/agent/

Observe estes pontos:

• URL: O host não precisa ser github.com, mas a URL deve usar HTTPS.
• Token: O token que seu cliente envia nunca chega ao sandbox, porque o tráfego Git passa pelo seu servidor, que adiciona o token.
• Branches: Os agentes não são informados da lista de branches, então nomeie um branch no seu prompt.
• Force pushes: O servidor não recusa force pushes, então um agente pode sobrescrever qualquer branch que você lista. Para recusar force pushes, proteja o branch no seu host Git.

Acessar o GitHub mostra a requisição e como fazer a rotação de um token. Se um clone falhar, a sessão recebe um evento session.error que informa a causa. Para verificar um push, procure o branch no seu host Git. O log do servidor diz ok mesmo para um push que o seu host recusou.

Ferramentas web precisam de uma configuração do servidor

As ferramentas web_search e web_fetch ficam desativadas por padrão. Para ativá-las, adicione isto ao arquivo de configurações do servidor:

web_tools:
  enabled: true

Apenas com essa configuração, as próprias listas de domínios e o próprio limite de conteúdo de cada agente se aplicam, como no serviço hospedado.

Para limitar as ferramentas para todos os agentes, defina web_tools.allowed_domains, web_tools.blocked_domains ou web_tools.max_content_tokens. Cada uma dessas configurações também ativa as ferramentas. O servidor se recusa a salvar um agente que peça mais do que essas configurações permitem. Por exemplo, ele recusa um agente que permita um domínio fora de web_tools.allowed_domains ou que defina um limite de conteúdo maior. Se esse agente já existir, ele não poderá iniciar uma sessão até que você o atualize.

Enquanto as ferramentas estiverem desativadas, o que acontece com um agente depende das entradas web_search e web_fetch no conjunto de ferramentas dele:

Quais ferramentas web existem também depende do seu provedor de inferência.

Diferenças que dependem do seu provedor de inferência

Alguns recursos funcionam apenas com alguns valores da configuração inference.provider do servidor. A tabela mostra o que acontece com os outros valores. Alguns desses casos não retornam nenhum erro.

As linhas de web_search e web_fetch se aplicam depois que você ativa as ferramentas web. Até lá, nenhuma das duas ferramentas funciona com nenhum provedor.

Com anthropic, o servidor solicita por padrão o fallback do lado do servidor da Claude API. Quando um classificador de segurança recusa uma requisição, outro modelo Claude, possivelmente menos capaz, pode então respondê-la. A Anthropic escolhe o modelo, e nenhum evento informa a troca, mas uma leitura da sessão mostra o ID desse modelo. Para desativar o fallback, defina inference.model_fallback: false. Com os outros provedores, uma requisição desse tipo encerra o turno com uma recusa.

A documentação do seu provedor informa quais modelos e regiões oferecem suporte a cada recurso. Ferramentas personalizadas, ferramentas MCP e as ferramentas que o seu worker executa são as mesmas em todos os provedores.

Modelos que aceitam o modo rápido

Por padrão, o catálogo de modelos do servidor lista quatro modelos como modelos que aceitam o modo rápido: Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8 e Claude Opus 4.6. No Claude Opus 4.6, a Claude API aceita a requisição, mas a executa na velocidade padrão. Estes valores de inference.provider são exceções:

• foundry: O catálogo lista apenas o Claude Opus 5.5.
• gateway com format: vertex-raw-predict: O catálogo não lista nenhum modelo.
• vertex: O catálogo não lista nenhum modelo, e nenhuma configuração altera isso.

Para alterar o que o catálogo lista, consulte Entradas de modelo.

Se você já executa sandboxes auto-hospedados

O software do worker é o mesmo, então seus workers podem se conectar ao seu servidor. Executar os seus próprios workers lista os três valores para o processo que faz polling e o que alterar primeiro. Um worker que é iniciado por um webhook não funciona aqui.