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.

TarefaComo o agente ajudaExemplo de tabela
Consultar númerosLê os registros e responde com o resultadopedidos, clientes
Conferir dadosCompara o banco com uma planilhaestoque, cobranças
Gerar relatórioConsulta e entrega o resultado como artefatovendas por período
Investigar um casoBusca um registro específicocadastro 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:

  1. 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.
  2. Abra a tela Conectores e escolha MySQL (o mesmo conector serve para MariaDB).
  3. Informe host, porta, nome do banco, usuário e senha do usuário somente leitura que você criou.
  4. 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.
  5. 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.