Conecte Supabase aos Agentes de Voz de Conversational AI da ElevenLabs

Acesso ao banco de dados em tempo real

• Chamadas diretas à API do Supabase durante conversas ao vivo
• Recuperação instantânea de dados com resposta em menos de um segundo
• Suporte a consultas SQL complexas e joins
• Cache integrado para dados acessados com frequência

Autenticação e autorização seguras

• Autenticação baseada em JWT com Supabase Auth
• Segurança em nível de linha para acesso a dados específicos do usuário
• Gestão de chaves de API com permissões por função
• Transmissão de dados criptografada para informações sensíveis

Integração com Edge Functions

• Execução de lógica serverless personalizada durante as chamadas
• Operações em múltiplas tabelas e chamadas de APIs externas
• Suporte a TypeScript/JavaScript para fluxos de trabalho complexos
• Implantação global para latência mínima

Suporte a dados multilíngues

• Interações por voz em mais de 31 idiomas
• Consultas unificadas ao banco de dados, independente do idioma de entrada
• Tradução em tempo real
• Preservação do contexto cultural nas respostas

Sincronização de dados em tempo real

• Atualizações ao vivo no banco de dados durante conversas ativas
• Suporte a webhooks para notificações proativas
• Respostas baseadas em eventos para mudanças nos dados
• Integração fluida com fluxos de trabalho existentes

Passo 1: Prepare o acesso ao Supabase

Reúna as credenciais do seu projeto Supabase

• Acesse seu painel Supabase em app.supabase.com
• Selecione seu projeto ou crie um novo
• Vá em Configurações e depois em API no menu lateral
• Copie a URL do seu projeto, que se parece com https://your-project.supabase.co
• Copie sua Service Role Key para operações no servidor
• Anote sua Anon Key se precisar de acesso público

Configure a segurança em nível de linha

• Vá em Autenticação e depois em Políticas no Supabase
• Configure as políticas de RLS adequadas para as tabelas que seu agente irá acessar
• Garanta que a service role key tenha as permissões necessárias
• Teste as políticas com consultas de exemplo no Editor SQL

Passo 2: Configure o agente ElevenLabs

Armazene as credenciais do Supabase com segurança

• Acesse o painel de Conversational AI da ElevenLabs
• Vá em Configurações e depois em Gerenciador de Segredos
• Crie um novo segredo chamado SUPABASE_SERVICE_KEY
• Cole sua service role key do Supabase como valor
• Crie outro segredo chamado SUPABASE_URL com a URL do seu projeto

Acesse a configuração de ferramentas

• Selecione seu agente de voz no painel
• Vá para a seção Ferramentas
• Clique em Adicionar nova ferramenta para criar integrações com banco de dados

Passo 3: Defina as ferramentas de banco de dados

Ferramenta de consulta ao banco de dados

• Nome: query_database
• Descrição: Recupera dados do banco de dados Supabase
• Método: GET
• URL: Insira a URL do seu projeto Supabase seguida de /rest/v1/nome_da_tabela
• Adicione o header apikey e selecione SUPABASE_SERVICE_KEY dos segredos armazenados
• Adicione o header Authorization e selecione a opção Bearer token com SUPABASE_SERVICE_KEY
• Adicione o header Content-Type com valor application/json

Ferramenta de inserção de registro

• Nome: insert_record
• Descrição: Cria novos registros no banco de dados Supabase
• Método: POST
• URL: Insira a URL do seu projeto Supabase seguida de /rest/v1/nome_da_tabela
• Adicione o header apikey e selecione SUPABASE_SERVICE_KEY dos segredos armazenados
• Adicione o header Authorization e selecione a opção Bearer token com SUPABASE_SERVICE_KEY
• Adicione o header Content-Type com valor application/json
• Adicione o header Prefer com valor return=representation

Ferramenta de atualização de registro

• Nome: update_record
• Descrição: Atualiza registros existentes no Supabase
• Método: PATCH
• URL: Insira a URL do seu projeto Supabase seguida de /rest/v1/nome_da_tabela
• Adicione o header apikey e selecione SUPABASE_SERVICE_KEY dos segredos armazenados
• Adicione o header Authorization e selecione a opção Bearer token com SUPABASE_SERVICE_KEY
• Adicione o header Content-Type com valor application/json
• Configure os parâmetros de consulta para seleção de registros

Ferramenta de exclusão de registro

• Nome: delete_record
• Descrição: Remove registros do banco de dados Supabase
• Método: DELETE
• URL: Insira a URL do seu projeto Supabase seguida de /rest/v1/nome_da_tabela
• Adicione o header apikey e selecione SUPABASE_SERVICE_KEY dos segredos armazenados
• Adicione o header Authorization e selecione a opção Bearer token com SUPABASE_SERVICE_KEY
• Configure os parâmetros de consulta para seleção de registros

Passo 4: Configure os prompts do agente

Atualize o prompt do sistema

Adicione instruções de acesso ao banco de dados no prompt do sistema do seu agente:

Você tem acesso a um banco de dados Supabase com as seguintes ferramentas:

• query_database: Use para buscar informações quando os usuários perguntarem sobre dados
• insert_record: Use para criar novos registros com base no que o usuário informar
• update_record: Use para modificar dados existentes quando solicitado
• delete_record: Use para remover registros quando autorizado

Sempre confirme alterações de dados com os usuários antes de executar operações de inserção, atualização ou exclusão. Ao buscar dados, apresente-os de forma natural e conversacional.

Configure as descrições das ferramentas

Para cada ferramenta, forneça descrições claras para ajudar o agente a entender quando usá-las:

• Ferramenta de consulta: Acionada por perguntas sobre dados existentes, buscas ou pesquisas
• Ferramenta de inserção: Ativada quando o usuário quer adicionar informações ou criar registros
• Ferramenta de atualização: Usada quando o usuário solicita alterações em dados existentes
• Ferramenta de exclusão: Usada com cuidado quando o usuário precisa remover informações

Configure o tratamento de respostas

Treine seu agente para lidar corretamente com as respostas do banco de dados:

• Interprete os dados retornados e apresente de forma conversacional
• Lide com resultados vazios de forma amigável, com mensagens úteis
• Confirme inserções e atualizações bem-sucedidas
• Forneça mensagens de erro em linguagem acessível