Como conectar o MySQL a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o MySQL a um agente de IA, reúna os dados de acesso do banco, crie um usuário só de leitura e adicione o conector na tela Conectores. No DoubleX Agentes, você escolhe quais agentes usam a conexão e testa com uma pergunta simples ao banco.
Muitas equipes têm dados valiosos num banco MySQL ou MariaDB e dependem de alguém técnico para cada consulta. Conectar o banco a um agente de IA permite perguntar em linguagem natural, sem abrir o banco. O ponto central é fazer isso com segurança: acesso só de leitura e permissões claras para cada agente.
O que o conector MySQL permite fazer (e por que é somente leitura)?#
O conector MySQL permite que o agente consulte as tabelas de um banco MySQL ou MariaDB diretamente. Por padrão, a conexão é somente leitura: o agente lê os dados, mas não grava, altera nem apaga nada.
Conector é um sistema ligado à plataforma, cujas ferramentas os agentes passam a usar. No caso do banco, isso significa que o agente pode listar tabelas, ler colunas e responder perguntas com base nos registros. O modo somente leitura protege os dados de produção: mesmo um pedido mal formulado não consegue alterar um pedido, um cliente ou um saldo.
| Tarefa | Como o agente ajuda | Exemplo de tabela |
|---|---|---|
| Consultar números | Lê os registros e responde com o resultado | pedidos, clientes |
| Conferir dados | Compara o banco com uma planilha | estoque, cobranças |
| Gerar relatório | Consulta e entrega o resultado como artefato | vendas por período |
| Investigar um caso | Busca um registro específico | cadastro de um cliente |
O que preparar antes de conectar o banco MySQL ou MariaDB?#
Antes de conectar, você precisa de três coisas: os dados de acesso ao servidor, um usuário do banco com permissão apenas de leitura e a garantia de que o servidor aceita a conexão externa.
Use esta lista de verificação:
- Dados de acesso: endereço do servidor (host), porta, nome do banco, usuário e senha.
- Usuário exclusivo: crie um usuário do banco só para o agente, com permissão de leitura (SELECT) apenas nas tabelas necessárias. Assim, o limite de segurança existe também no próprio banco, e não só na plataforma.
- Acesso de rede: confirme com quem cuida da infraestrutura que o servidor está acessível de fora, se for o caso, e se há regra de firewall a liberar.
- Escopo: decida quais tabelas o agente precisa enxergar. Dados sensíveis que não são necessários ficam de fora.
Como adicionar o conector MySQL no DoubleX Agentes?#
Você adiciona o conector na tela Conectores, informando os dados de acesso do banco. As credenciais ficam criptografadas com AES-256-GCM.
Passo a passo no DoubleX Agentes:
- Crie a conta (grátis, sem cartão) ou entre na sua empresa. Se ainda não tem agentes, o diagnóstico mostra por onde começar e pode virar uma equipe de agentes com um clique.
- Abra a tela Conectores e escolha MySQL (o mesmo conector serve para MariaDB).
- Informe host, porta, nome do banco, usuário e senha do usuário somente leitura que você criou.
- Defina o alcance da conexão: pessoal, do time ou da empresa. Para um banco compartilhado, costuma fazer sentido a conexão do time ou da empresa.
- Salve e confirme que a conexão aparece como ativa.
Se quiser automatizar a criação de conexões por código, a documentação de Conectores descreve a API.
Como escolher quais agentes usam a conexão e quais ações podem executar?#
A conexão não vale automaticamente para todos os agentes. Para cada agente, a empresa escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar.
Na tela Agentes, abra o agente que vai consultar o banco, por exemplo um agente de Financeiro ou de Operações, e ative o conector MySQL só para ele. Agentes de outras áreas, como Atendimento, continuam sem acesso. Isso mantém o princípio do menor privilégio: cada agente enxerga só o que precisa.
Se o agente também trabalha com e-mail ou planilhas, as permissões de cada sistema são independentes. Você pode liberar a leitura do banco e manter qualquer ação de envio com confirmação.
Como testar com a primeira pergunta ao banco?#
Teste com uma pergunta simples, cuja resposta você já conhece. Assim você valida a conexão e a leitura dos dados antes de usar o agente em algo importante.
Abra uma conversa com o agente e experimente pedidos como estes:
- "Liste as tabelas que você consegue consultar neste banco."
- "Quantos pedidos foram feitos no mês passado? Mostre a consulta que você usou."
- "Mostre os 10 clientes com mais compras neste ano."
- "Descreva as colunas da tabela de clientes e diga o que cada uma parece guardar."
Compare a resposta com um número que você já sabe. Se bater, a conexão está correta. Se o agente não encontrar a tabela, revise o escopo do usuário do banco. Se der erro de conexão, confira host, porta e regras de firewall.
Para mais ideias de pedidos e rotinas, veja MySQL com agente de IA: exemplos de pedidos e rotinas. Se a equipe não escreve SQL, leia também Como consultar o banco de dados com IA sem escrever SQL.
Como o histórico da tarefa mostra cada consulta feita?#
Cada pedido ao agente vira uma tarefa na tela Tarefas, com histórico completo: o pedido, cada ferramenta que o agente usou e o resultado. Você vê quem pediu, o que foi consultado e quando.
Isso ajuda a auditar o uso do banco e a conferir como o agente chegou a um número. Se uma resposta parecer estranha, abra a tarefa e revise as consultas feitas. Para checagens recorrentes, como comparar o banco com uma planilha, veja Como conferir dados entre planilhas e sistemas com agente de IA.
Perguntas frequentes#
O conector MySQL funciona com MariaDB?#
Sim. O conector consulta bancos MySQL ou MariaDB diretamente, em modo somente leitura.
O agente pode alterar ou apagar dados do banco?#
Não com o conector MySQL, que é somente leitura por padrão. Recomendamos ainda usar um usuário do banco com permissão apenas de leitura.
Meus dados do banco são usados para treinar modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores de IA que não usam o que recebem para treinamento. Cada empresa tem o próprio banco de dados, separado das outras.
Preciso saber SQL para usar o agente com o banco?#
Não. Você descreve o que quer em linguagem natural e o agente monta a consulta. Você pode pedir que ele mostre a consulta usada e conferir no histórico da tarefa.
Posso limitar quais agentes acessam o banco?#
Sim. Para cada agente, a empresa escolhe quais sistemas ele usa e quais ações pode executar, então só os agentes autorizados enxergam o conector MySQL.