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.

TarefaComo o agente ajudaParte do Supabase
Entender o que existeLista projetos e descreve as tabelasProjetos e banco
Revisar mudanças de estruturaExplica as migrações aplicadasMigrações
Acompanhar funçõesConsulta as edge functions do projetoEdge functions
Responder dúvidas do timeConsulta dados e resume o resultadoBanco 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.

  1. Entre no DoubleX Agentes e abra a tela Conectores.
  2. Procure o Supabase (categoria desenvolvimento) e inicie a conexão.
  3. Autorize o acesso com a conta que gerencia o projeto e escolha se a conexão será pessoal, do time ou da empresa.
  4. 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.
  5. Ative o Supabase entre os sistemas que esse agente pode usar.
  6. 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çãoExemplo no SupabaseRecomendação inicial
LeituraListar projetos, ver tabelas, consultar dadosLigada
AlteraçãoAplicar migração, mudar estruturaDesligada
PublicaçãoImplantar uma edge functionDesligada

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

Mais guias de Supabase