Vai alla navigazione
ConfigurazioneIntegrazioni

Google Calendar

Collega i tuoi agenti ElevenLabs alla pianificazione di Google Calendar

Panoramica

Collega i tuoi agenti IA di ElevenLabs a Google Calendar per gestire la pianificazione e gli appuntamenti del calendario. Questa integrazione consente ai tuoi agenti di verificare la disponibilità, creare, aggiornare ed eliminare eventi con partecipanti e videoconferenze Google Meet facoltative, elencare i prossimi eventi e individuare i calendari accessibili tramite conversazioni naturali.

Funzionalità

FunzionalitàSupporto
Modalità zero retention (ZRM)Non supportata
Allegati negli strumentiNon supportati — gli strumenti operano solo sul testo

Avviso di sicurezza

Avviso di sicurezza: google_calendar_update_event e google_calendar_delete_event sono strumenti con privilegi. Vengono eseguiti con l’accesso completo al calendario dell’account Google collegato, non solo agli eventi creati dal tuo agente. Chiunque possa parlare con l’agente può modificare o annullare qualsiasi evento in quel calendario, inclusi gli eventi che non ha creato, perché l’agente può cercare gli ID degli eventi con google_calendar_list_events. Una conferma nel prompt di sistema è un suggerimento per il modello, non un controllo di sicurezza.

Abilita questi strumenti solo per agenti con autenticazione abilitata oppure quando l’ID dell’evento proviene da una fonte affidabile. Non aggiungerli ad agenti pubblici. I partecipanti ricevono sempre una notifica quando un evento viene aggiornato o eliminato.

Configurazione

Questa integrazione usa Google OAuth 2.0 per l’autenticazione. Autorizzi ElevenLabs ad accedere al tuo Google Calendar per tuo conto.

1

Fai clic su Connetti in ElevenLabs

Nella configurazione dell’integrazione ElevenLabs, fai clic su Connetti. Verrai reindirizzato a Google per autorizzare l’accesso.

2

Seleziona il tuo account Google

Scegli l’account Google ai cui dati del calendario deve accedere il tuo agente. Se nel browser hai effettuato l’accesso a più account Google, seleziona quello corretto.

3

Autorizza l'accesso al calendario

Esamina le autorizzazioni richieste e fai clic su Consenti. L’integrazione richiede l’accesso per gestire gli eventi nei calendari di tua proprietà, visualizzare l’elenco dei calendari e verificare le informazioni libero/occupato.

Scope OAuth

L’integrazione richiede i seguenti scope Google OAuth 2.0:

ScopeScopo
calendar.events.ownedCreare, leggere, aggiornare ed eliminare eventi nei calendari di tua proprietà.
calendar.calendarlist.readonlyVisualizzare l’elenco dei calendari accessibili al tuo account (nomi e ID).
calendar.freebusyVerificare la disponibilità libero/occupato tra i calendari senza esporre i dettagli degli eventi.

Come funziona

L’agente pianifica le riunioni usando chiamate di strumenti per seguire il processo di prenotazione. Le schede seguenti mostrano un riepilogo generale e un prompt di sistema dettagliato.

1

Individua i calendari

L’agente elenca i calendari accessibili per identificare quello corretto per la pianificazione. Per la maggior parte degli utenti, si tratta del calendario principale.

2

Verifica la disponibilità

L’agente verifica la disponibilità libero/occupato:

  • Usa lo strumento google_calendar_check_availability per interrogare gli intervalli di tempo occupati.
  • Verifica se l’orario richiesto è libero.
  • Suggerisce alternative se l’orario richiesto è in conflitto con un evento esistente.
  • Conferma l’orario selezionato con il chiamante.
3

Raccogli i dati dei partecipanti

Una volta concordato un orario, l’agente:

  • Raccoglie nome completo e indirizzo email del partecipante.
  • Conferma l’email rileggendola al chiamante.
  • Verifica le informazioni sul fuso orario.
4

Crea l'evento

L’agente:

  • Chiama lo strumento google_calendar_create_event con i dettagli confermati.
  • Aggiunge facoltativamente un link Google Meet se viene richiesta una videoconferenza.
  • Conferma la creazione dell’evento e informa il partecipante che riceverà un invito del calendario.

Strumenti dell’agente

Quando aggiungi gli strumenti Google Calendar a un agente, sono disponibili i seguenti strumenti integrati:

StrumentoDescrizione
google_calendar_check_availabilityVerifica la disponibilità libero/occupato per uno o più calendari in un intervallo di tempo. Restituisce gli intervalli di tempo occupati affinché l’agente possa trovare fasce libere. Usalo prima di creare eventi per evitare conflitti.
google_calendar_create_eventCrea un nuovo evento in un Google Calendar con partecipanti, luogo e videoconferenza Google Meet facoltativi. Invia notifiche email a tutti i partecipanti.
google_calendar_list_eventsElenca i prossimi eventi di un calendario in un intervallo di tempo, ordinati per ora di inizio. Supporta la ricerca a testo libero tra riepiloghi, descrizioni, luoghi e dettagli dei partecipanti degli eventi.
google_calendar_update_eventCon privilegi. Aggiorna qualsiasi evento nel calendario, ad esempio per riprogrammarlo o modificarne il titolo, il luogo o i partecipanti. Vengono modificati solo i campi forniti. I partecipanti ricevono una notifica.
google_calendar_delete_eventCon privilegi. Elimina qualsiasi evento nel calendario, annullandolo per tutti i partecipanti. Usa prima l’elenco degli eventi per trovare l’ID dell’evento. Per gli eventi ricorrenti, usa l’ID di un’occorrenza o il relativo recurringEventId (l’intera serie).
google_calendar_list_calendarsElenca tutti i calendari accessibili all’account Google collegato. Restituisce nomi e ID dei calendari. Usalo per individuare il calendario di destinazione prima di verificare la disponibilità o creare eventi.