Como conectar a Cloudflare a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar a Cloudflare a um agente de IA, crie a conta no DoubleX Agentes, abra a tela Conectores, adicione a Cloudflare e autorize o acesso. Depois, escolha se a conexão é pessoal, do time ou da empresa e limite o agente a ações de leitura antes do primeiro teste.
Quem cuida de DNS, Workers e outros recursos da Cloudflare costuma repetir as mesmas consultas: conferir um registro, listar o que foi publicado, revisar uma configuração. Um agente de IA pode fazer essas consultas por você, desde que a conexão seja feita com cuidado. Este guia cobre só a conexão e como começar com segurança, em modo leitura.
O que o conector da Cloudflare permite ao agente fazer?#
O conector da Cloudflare permite que o agente gerencie a conta, o DNS, os Workers e outros recursos da Cloudflare. Conector é um sistema ligado à plataforma cujas ferramentas os agentes passam a usar.
Isso não significa que o agente possa tudo. Você escolhe quais ações ele executa, e pode deixá-lo apenas consultando. Para exemplos de pedidos de DNS e Workers, veja o guia Cloudflare com agente de IA: DNS, Workers e exemplos de pedidos.
O que preparar antes de conectar?#
Antes de conectar, tenha em mãos a conta da Cloudflare com o acesso que você pretende usar e defina quem vai usar o agente. Também ajuda decidir de antemão que o primeiro teste será só de leitura.
- Uma conta no DoubleX Agentes (criar a conta é grátis, sem cartão).
- Acesso à conta da Cloudflare que você quer conectar.
- Um agente para usar a conexão. Se ainda não tem, o diagnóstico monta uma equipe de agentes a partir de uma conversa de 5 a 10 minutos sobre a rotina da empresa.
- A decisão de quem poderá usar a conexão: só você, o time ou a empresa.
Como adicionar o conector Cloudflare na tela Conectores?#
Você adiciona o conector na tela Conectores, escolhendo a Cloudflare na lista e autorizando o acesso. O passo a passo no DoubleX Agentes é este:
- Crie a conta e, se quiser, faça o diagnóstico para ter um agente pronto para testar. Veja o Início rápido para o fluxo geral.
- Abra a tela Conectores e procure a Cloudflare, na categoria de desenvolvimento.
- Adicione o conector e conclua a autorização com a conta da Cloudflare que você preparou.
- Escolha o tipo de conexão: pessoal, do time ou da empresa (veja a próxima seção).
- Abra o agente na tela Agentes e habilite a Cloudflare entre os sistemas que ele pode usar.
- Defina as ações permitidas e deixe só as de leitura ligadas.
Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM. Se você prefere automatizar a configuração por código, a documentação de Conectores descreve a API.
Conexão pessoal, do time ou da empresa: qual escolher?#
Escolha pessoal se só você vai usar, do time se uma equipe técnica compartilha o acesso e da empresa se vários times dependem dela. Uma conexão pessoal só vale para a pessoa que a criou.
| Tipo de conexão | Quem usa | Quando faz sentido |
|---|---|---|
| Pessoal | Só você | Testes iniciais e consultas do dia a dia |
| Do time | Pessoas do time | Infraestrutura ou desenvolvimento compartilhando a mesma conta |
| Da empresa | Toda a empresa | Consultas que vários times precisam, com permissões bem definidas |
Para começar, a conexão pessoal ou do time costuma bastar. Os papéis de dono, administrador e membro ajudam a controlar quem pode alterar a conexão.
Como limitar o agente a ações de leitura e exigir confirmação?#
Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados podem ficar desligadas, deixando o agente só em leitura.
- Mantenha desligadas as ações que criam, alteram ou apagam recursos.
- Dê a cada agente só a Cloudflare de que ele precisa. Um agente de suporte, por exemplo, não precisa dela.
- Lembre que, antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez.
Como testar a conexão com um primeiro pedido e conferir o histórico da tarefa?#
Faça um pedido de leitura simples e depois abra a tarefa na tela Tarefas. Cada pedido vira uma tarefa com o histórico completo: o que foi pedido, cada ferramenta usada e o resultado.
Exemplos de pedidos para o primeiro teste:
- "Liste os registros DNS do domínio exemplo.com.br."
- "Mostre quais Workers existem na minha conta da Cloudflare."
- "Resuma as configurações da conta e aponte o que eu devo revisar."
- "Confira se existe algum registro DNS apontando para um endereço antigo."
Na tela Tarefas, confirme que o agente usou as ferramentas da Cloudflare e só ações de leitura. Se algo saiu diferente do esperado, ajuste as permissões e teste de novo. Quando a rotina estiver estável, você pode agendar a consulta, usando Gatilhos.
Perguntas frequentes#
Preciso programar para conectar a Cloudflare?#
Não. Você adiciona o conector na tela Conectores e define as permissões pela interface. Quem quiser ir além pode usar a API REST, a CLI ou o servidor MCP.
O agente pode alterar meu DNS?#
Só se você permitir. Dá para deixar as ações que alteram dados desligadas, e o agente pede confirmação antes de alterar algo nos sistemas.
Meus dados da Cloudflare treinam modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores que não usam o que recebem para treinamento. Há também a opção de retenção zero na tela Modelos.
Como saber o que o agente fez na minha conta?#
Tudo fica registrado. Cada tarefa mostra quem pediu, o que o agente fez em cada ferramenta e o resultado.
Posso usar o mesmo conector com mais de um agente?#
Sim. Para cada agente você escolhe quais sistemas ele usa e quais ações pode executar, então dá para ter um agente só de leitura e outro com mais permissões.
Guias relacionados
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.