Como conectar o Supabase a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o Supabase a um agente de IA, abra a tela Conectores do DoubleX Agentes, escolha o Supabase e autorize o acesso com a conta que gerencia o projeto. Depois, vincule o conector ao agente, deixe só leitura e confirmação ativas e teste com uma consulta simples.
Ligar o Supabase a um agente de IA permite que a equipe consulte dados e acompanhe o projeto com pedidos em linguagem natural, sem abrir o painel a cada dúvida. O ponto de atenção é o controle: quem conecta, o que o agente pode fazer e como validar antes de liberar qualquer alteração. Este guia mostra o caminho completo no DoubleX Agentes, começando sempre pela leitura.
O que o conector do Supabase permite ao agente fazer?#
O conector do Supabase permite que o agente gerencie projetos, bancos, migrações e edge functions. Na prática, ele usa as ferramentas do Supabase para consultar informações e, se você liberar, executar ações no projeto.
O Supabase é uma plataforma de back-end baseada em Postgres, que reúne banco de dados, migrações e funções de borda (edge functions). O conector é a ligação entre esse sistema e a plataforma: os agentes usam as ferramentas dele, dentro das permissões que você definir.
| Tarefa | Como o agente ajuda | Parte do Supabase |
|---|---|---|
| Entender o que existe | Lista projetos e descreve as tabelas | Projetos e banco |
| Revisar mudanças de estrutura | Explica as migrações aplicadas | Migrações |
| Acompanhar funções | Consulta as edge functions do projeto | Edge functions |
| Responder dúvidas do time | Consulta dados e resume o resultado | Banco de dados |
O que preparar antes de conectar (conta, projeto e quem vai autorizar)?#
Antes de conectar, tenha uma conta no DoubleX Agentes, acesso ao projeto Supabase e definido quem vai autorizar a conexão. Quem autoriza empresta as próprias permissões do Supabase ao agente, então escolha com cuidado.
- Conta no DoubleX Agentes: criar a conta é grátis e não pede cartão. Se ainda não fez, o Início rápido mostra os primeiros passos.
- Acesso ao projeto: confirme que a pessoa que vai autorizar enxerga o projeto certo no Supabase.
- Escopo da conexão: uma conexão pode ser pessoal (vale só para a pessoa), do time ou da empresa. Para um banco com dados de clientes, prefira uma conexão do time ou de um responsável técnico, não de uma conta pessoal qualquer.
- Agente definido: decida qual agente vai usar o Supabase. Se ainda não existe, o diagnóstico de 5 a 10 minutos ajuda a montar a equipe de agentes.
Como conectar o Supabase na tela Conectores?#
Você conecta o Supabase na tela Conectores, escolhendo o Supabase na lista e autorizando o acesso. Depois, o conector precisa ser liberado para o agente que vai usá-lo.
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure o Supabase (categoria desenvolvimento) e inicie a conexão.
- Autorize o acesso com a conta que gerencia o projeto e escolha se a conexão será pessoal, do time ou da empresa.
- Abra a tela Agentes e selecione o agente que vai trabalhar com o Supabase. Se ainda não houver um, crie-o descrevendo o que precisa com as próprias palavras.
- Ative o Supabase entre os sistemas que esse agente pode usar.
- Defina as ações permitidas (próxima seção) antes de fazer o primeiro pedido.
As senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM. Para quem prefere automatizar a configuração, a documentação de Conectores da API descreve como gerenciá-los por código.
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. Deixe só as ações de leitura ligadas e mantenha desligadas as que alteram dados.
É a regra mais importante deste guia: um agente que só lê não consegue apagar uma tabela nem aplicar uma migração por engano.
| Tipo de ação | Exemplo no Supabase | Recomendação inicial |
|---|---|---|
| Leitura | Listar projetos, ver tabelas, consultar dados | Ligada |
| Alteração | Aplicar migração, mudar estrutura | Desligada |
| Publicação | Implantar uma edge function | Desligada |
Mesmo com ações liberadas, o agente pede confirmação antes de enviar, apagar ou alterar algo nos sistemas e mostra o passo a passo do que fez. Se for liberar escrita no futuro, faça isso aos poucos e só para o agente que precisa.
Como testar a conexão com um primeiro pedido?#
Teste com um pedido simples de leitura, que não altere nada. Se o agente responder com informações reais do projeto, a conexão e as permissões estão certas.
Abra uma conversa com o agente e experimente um destes pedidos:
- "Liste os projetos do Supabase aos quais você tem acesso."
- "Quais tabelas existem no banco do projeto de testes? Resuma o que cada uma parece guardar."
- "Mostre as últimas migrações aplicadas no projeto e explique o que mudou em cada uma."
- "Quais edge functions existem neste projeto?"
Se o agente disser que não tem acesso, volte à tela Agentes e confira se o Supabase está ativado para ele e se a conexão foi autorizada por quem tem permissão no projeto. Mais ideias de uso estão em Supabase com agente de IA: exemplos de pedidos e rotinas.
O que conferir no histórico da tarefa depois do teste?#
Depois do teste, abra a tarefa na tela Tarefas e confira o pedido, cada ferramenta usada e o resultado. Cada pedido vira uma tarefa com histórico completo, então dá para saber quem pediu, o que foi feito e quando.
Use este checklist:
- O agente usou só ferramentas de leitura?
- O projeto consultado era o esperado (teste ou produção)?
- A resposta bate com o que você vê no painel do Supabase?
- Alguma ação pediu confirmação que você não esperava?
Se tudo estiver correto, você pode ampliar o uso: agendar uma rotina de consulta ou liberar uma ação específica de escrita. Uma rotina roda com as permissões de quem a criou, por isso confira de novo quem é o responsável. Para disparos automáticos, veja a documentação de Gatilhos.
Perguntas frequentes#
Preciso saber programar para conectar o Supabase?#
Não. A conexão é feita na tela Conectores e o agente é montado a partir da descrição do que você precisa, sem escrever prompt. Quem quiser ir além tem API REST, CLI e servidor MCP.
O agente pode alterar meu banco de dados sem eu saber?#
Só se você liberar. Você escolhe as ações permitidas em cada sistema, pode manter tudo em leitura, e o agente pede confirmação antes de alterar algo. Tudo fica no histórico da tarefa.
Meus dados do Supabase 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 também tem o próprio banco de dados, separado das outras.
Posso usar a conexão só para mim ou para o time todo?#
Pode. Uma conexão pode ser pessoal, do time ou da empresa. Escolha conforme quem deve usar o Supabase e quem assume a responsabilidade pela autorização.
Existe um conector parecido para outros sistemas?#
Sim, há conectores para vários sistemas. O processo é semelhante ao de conectar o Jam a um agente de IA e ao de conectar o Box: conectar, definir permissões e testar com leitura.
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.