Saltar para o conteúdo principal
A integração com banco de dados SQL (compatível com PostgreSQL) conecta um banco de dados ao seu chat. O Attlas lê a estrutura das tabelas que você escolhe compartilhar e escreve consultas somente leitura para responder às perguntas dos visitantes com dados em tempo real. Funciona com qualquer banco de dados PostgreSQL, e o Supabase é o lugar mais fácil para começar.

🛠️ Como conectar

  1. Vá para Configurações do Chat > Integrações > Banco de dados SQL.
  2. Clique em Conectar e preencha os detalhes do seu banco de dados:
    • Nome e descrição: Um nome amigável e uma descrição para ajudar a IA a entender que dados estão contidos.
    • Moeda (opcional): A moeda principal usada para valores monetários em suas tabelas, auxiliando a IA a formatar e interpretar dados financeiros.
    • Host e porta: O endereço do servidor de banco de dados e a porta (o padrão é 5432 para PostgreSQL).
    • Banco de dados: O nome do seu banco de dados.
    • Usuário e senha: Suas credenciais do banco de dados (de preferência, somente leitura).
    • Modo SSL: Selecione require ou disable.
  3. Clique em Testar para verificar as credenciais e ver quantas tabelas foram encontradas.
  4. Clique em Salvar para concluir.

Conectar um banco de dados Supabase

O Supabase mostra dois tipos de detalhes de conexão. Use o de pooler.
O host de conexão direta (db.<project-ref>.supabase.co) só funciona sobre IPv6, e o Attlas se conecta via IPv4. Ele falha com um erro ENETUNREACH.
  1. No seu projeto Supabase, clique em Conectar no topo do painel.
  2. Abra a guia Session pooler.
  3. Copie os valores para o formulário:
Se você vir “Tenant or user not found”, verifique se o seu usuário inclui a referência do projeto. Se você esqueceu a senha, redefina-a na mesma página do Supabase.

Preencha os detalhes da conexão

Clique no botão Conectar para abrir o formulário e preencher os seguintes campos:

⚙️ Gerenciando sua integração

Clique em Configurações no cartão do seu Banco de dados SQL ativo para gerenciar o seguinte:
  • Selecionar tabelas para compartilhar: Escolha quais tabelas ou views o Attlas pode ler. O Attlas verifica esta lista a cada consulta e bloqueia qualquer tabela que você não compartilhou, independentemente do que seu usuário de banco de dados tem permissão para ler.
  • Instruções: Escreva as regras que o Attlas deve seguir com seus dados (veja abaixo).
  • Atualizar schema: Após adicionar ou alterar tabelas ou colunas, clique em Atualizar para sincronizá-las.
  • Desativar temporariamente: Ative ou desative a integração com o botão de alternância.
  • Desconectar: Remova a conexão com o banco de dados.

Instruções

A descrição diz o que o seu banco de dados contém. As instruções dizem como usá-lo. Escreva uma regra por linha, até 1.000 caracteres:
Use instruções para ocultar rascunhos, explicar unidades ou nomear a coluna que seus clientes usam para encontrar um item.

Esquemas

O Attlas lê todos os esquemas do seu banco de dados, não apenas o public. Tabelas fora do public aparecem como schema.tabela, por exemplo cms.projects. Os esquemas internos do Supabase (auth, storage, realtime, vault e similares) nunca são lidos.
Conexões existentes só veem novos esquemas após você clicar em Atualizar schema. Sua seleção atual de tabelas permanece inalterada.

💡 Boas práticas para o schema do banco de dados

Para ajudar o Attlas a escrever consultas precisas e realizar cálculos exatos, considere estas dicas de design de schema:
  • Use tipos de coluna precisos: Se você deseja que o chat realize cálculos, como somas, médias ou proporções, em dados numéricos, garanta que essas colunas usem um tipo numérico, como numeric, decimal, integer ou float. Evite armazenar números como texto, como varchar ou text, pois isso torna os cálculos mais difíceis e menos precisos.
  • Adicione comentários nas colunas: Use comentários de banco de dados em suas tabelas e colunas. Adicionar uma breve descrição diretamente a uma coluna, por exemplo COMMENT ON COLUMN users.status IS 'Active statuses: active, suspended, pending', fornece contexto crucial que orienta o Attlas a escrever as consultas SQL corretas.

🔒 Boas práticas de segurança

Para manter seus dados seguros, recomendamos fortemente:
  • Compartilhe apenas o necessário: O Attlas rejeita qualquer consulta que acesse uma tabela que você não compartilhou. Mantenha desmarcadas as tabelas com dados pessoais ou credenciais.
  • Views precisam de suas tabelas de origem: Uma view que você compartilha lê de outras tabelas. Essas tabelas também devem ser compartilhadas.
  • Use um usuário somente leitura: Crie um usuário de banco de dados com apenas permissões SELECT. O Attlas só envia consultas de leitura, e um usuário somente leitura adiciona uma segunda camada de proteção.
  • Mantenha o SSL ativado: Defina sslmode como require para criptografar os dados em trânsito.
Última modificação em 30 de setembro de 2026