Collega Supabase agli agenti vocali IA conversazionali di ElevenLabs

Accesso al database in tempo reale

• Chiamate API dirette a Supabase durante le conversazioni live
• Recupero dati istantaneo con tempi di risposta inferiori al secondo
• Supporto per query SQL complesse e join
• Caching integrato per dati consultati frequentemente

Autenticazione e autorizzazione sicure

• Autenticazione basata su JWT con Supabase Auth
• Row-level security per accesso ai dati specifici dell'utente
• Gestione delle API key con permessi basati sui ruoli
• Trasmissione dati criptata per informazioni sensibili

Integrazione Edge Function

• Esecuzione di logiche serverless personalizzate durante le chiamate
• Operazioni multi-tabella e chiamate API esterne
• Supporto TypeScript/JavaScript per workflow complessi
• Distribuzione globale per latenza minima

Supporto dati multilingue

• Interazioni vocali in oltre 31 lingue
• Query unificate al database indipendentemente dalla lingua di input
• Traduzione in tempo reale
• Risposte che mantengono il contesto culturale

Sincronizzazione dati in tempo reale

• Aggiornamenti live al database durante le conversazioni attive
• Supporto webhook per notifiche proattive
• Risposte guidate da eventi ai cambiamenti dei dati
• Integrazione fluida con i workflow esistenti

Passo 1: Prepara l'accesso a Supabase

Recupera le credenziali del tuo progetto Supabase

• Accedi alla dashboard Supabase su app.supabase.com
• Seleziona il tuo progetto o creane uno nuovo
• Vai su Impostazioni e poi su API nella barra laterale sinistra
• Copia l'URL del progetto, che sarà simile a https://your-project.supabase.co
• Copia la Service Role Key per le operazioni server-side
• Annota la tua Anon Key se ti serve accesso pubblico

Configura la Row Level Security

• Vai su Authentication e poi su Policies in Supabase
• Imposta le policy RLS appropriate per le tabelle a cui l'agente accederà
• Assicurati che la service role key abbia i permessi necessari
• Testa le policy con query di esempio nell'SQL Editor

Passo 2: Configura l'agente ElevenLabs

Conserva le credenziali Supabase in modo sicuro

• Accedi alla dashboard IA Conversazionale ElevenLabs
• Vai su Impostazioni e poi su Secrets Manager
• Crea un nuovo secret chiamato SUPABASE_SERVICE_KEY
• Incolla la tua service role key Supabase come valore
• Crea un altro secret chiamato SUPABASE_URL con l'URL del progetto

Accedi alla configurazione degli strumenti

• Seleziona il tuo agente vocale dalla dashboard
• Vai alla sezione Tools
• Clicca su Aggiungi nuovo tool per creare integrazioni database

Passo 3: Definisci gli strumenti database

Strumento Query Database

• Nome: query_database
• Descrizione: Recupera dati dal database Supabase
• Metodo: GET
• URL: Inserisci l'URL del progetto Supabase seguito da /rest/v1/table_name
• Aggiungi header chiamato apikey e seleziona SUPABASE_SERVICE_KEY dai secret salvati in modo sicuro
• Aggiungi header Authorization e seleziona l'opzione Bearer token con SUPABASE_SERVICE_KEY
• Aggiungi header Content-Type con valore application/json

Strumento Insert Record

• Nome: insert_record
• Descrizione: Crea nuovi record nel database Supabase
• Metodo: POST
• URL: Inserisci l'URL del progetto Supabase seguito da /rest/v1/table_name
• Aggiungi header chiamato apikey e seleziona SUPABASE_SERVICE_KEY dai secret salvati in modo sicuro
• Aggiungi header Authorization e seleziona l'opzione Bearer token con SUPABASE_SERVICE_KEY
• Aggiungi header Content-Type con valore application/json
• Aggiungi header Prefer con valore return=representation

Strumento Update Record

• Nome: update_record
• Descrizione: Aggiorna record esistenti in Supabase
• Metodo: PATCH
• URL: Inserisci l'URL del progetto Supabase seguito da /rest/v1/table_name
• Aggiungi header chiamato apikey e seleziona SUPABASE_SERVICE_KEY dai secret salvati in modo sicuro
• Aggiungi header Authorization e seleziona l'opzione Bearer token con SUPABASE_SERVICE_KEY
• Aggiungi header Content-Type con valore application/json
• Configura i parametri di query per selezionare i record

Strumento Delete Record

• Nome: delete_record
• Descrizione: Rimuove record dal database Supabase
• Metodo: DELETE
• URL: Inserisci l'URL del progetto Supabase seguito da /rest/v1/table_name
• Aggiungi header chiamato apikey e seleziona SUPABASE_SERVICE_KEY dai secret salvati in modo sicuro
• Aggiungi header Authorization e seleziona l'opzione Bearer token con SUPABASE_SERVICE_KEY
• Configura i parametri di query per selezionare i record

Passo 4: Configura i prompt dell'agente

Aggiorna il System Prompt

Aggiungi istruzioni di accesso al database nel system prompt dell'agente:

Hai accesso a un database Supabase con i seguenti strumenti:

• query_database: Usalo per recuperare informazioni quando gli utenti chiedono dati
• insert_record: Usalo per creare nuove voci in base all'input dell'utente
• update_record: Usalo per modificare dati esistenti su richiesta
• delete_record: Usalo per rimuovere record quando autorizzato

Conferma sempre le modifiche ai dati con gli utenti prima di eseguire operazioni di inserimento, aggiornamento o eliminazione. Quando recuperi dati, presentali in modo naturale e conversazionale.

Configura le descrizioni degli strumenti

Per ogni strumento, fornisci descrizioni chiare che aiutino l'agente a capire quando usarli:

• Strumento Query: Attivato da domande su dati esistenti, ricerche o consultazioni
• Strumento Insert: Attivato quando gli utenti vogliono aggiungere nuove informazioni o creare record
• Strumento Update: Usato quando gli utenti richiedono modifiche a dati esistenti
• Strumento Delete: Usato con attenzione quando gli utenti devono rimuovere informazioni

Configura la gestione delle risposte

Addestra l'agente a gestire correttamente le risposte del database:

• Analizza i dati restituiti e presentali in modo conversazionale
• Gestisci i risultati vuoti con messaggi utili
• Conferma inserimenti e aggiornamenti riusciti
• Fornisci messaggi di errore in un linguaggio comprensibile