Aggiungere azioni di Google Calendar e Gmail

La pagina seguente descrive come configurare le azioni dell'assistente per Google Calendar e Gmail.

Azioni di Google Calendar

Quando le azioni di Google Calendar sono attive, gli utenti finali possono chiedere all'assistente di creare eventi di Google Calendar per loro.

Ad esempio, un utente potrebbe inserire "pianifica una riunione con utente1@example.com alle 15:00 di domani". L'assistente chiede ulteriori dettagli, se necessario, e poi chiede all'utente di confermare la creazione dell'evento.

L'assistente può leggere e modificare i seguenti campi di Google Calendar tramite le azioni:

Campo Descrizione
Partecipanti Obbligatorio. Elenco degli indirizzi email dei partecipanti. L'utente che ha richiesto l'accesso viene aggiunto automaticamente all'elenco.
Titolo Il titolo della riunione.
Ora di inizio Ora di inizio della riunione.
Durata Durata della riunione. Il valore predefinito è 30 minuti.
Fuso orario Il fuso orario della riunione. Se non viene specificato, viene utilizzato il fuso orario dell'utente.
Descrizione Descrizione della riunione.

Configura l'autenticazione e le autorizzazioni per Google Calendar

Prima di attivare le azioni di Google Calendar, un Google Cloud amministratore deve attivare l'API Google Calendar e configurare l'autorizzazione come segue.

Abilita l'API Google Calendar

Nella console Google Cloud , abilita le seguenti API:

Crea un'app OAuth e aggiungi ambiti

Se non hai un'app OAuth, segui questi passaggi. Se hai già un'app OAuth, vai a Crea le credenziali di un client OAuth.

  1. Vai a Google Auth Platform/Panoramica.

  2. Fai clic su Inizia.

  3. Inserisci un nome per l'app OAuth.

  4. Inserisci un'email di assistenza utenti.

  5. Seleziona Interno.

  6. Inserisci i dati di contatto dello sviluppatore.

  7. Fai clic su Crea.

Crea le credenziali client OAuth

Questa procedura descrive come creare un nuovo ID client OAuth per le azioni di Google Cloud. Questo ID client OAuth e il client secret possono essere utilizzati anche per altre Google Cloud azioni. Se hai un ID client OAuth Google Cloud esistente per le Google Cloud azioni, puoi utilizzare questo ID client e il relativo secret per le azioni di Google Calendar anziché crearne uno nuovo.

  1. Vai a Google Auth Platform/Client.

  2. Fai clic su Crea cliente.

  3. Per Tipo di applicazione, seleziona Applicazione web.

  4. In Nome, inserisci un nome per l'ID client.

  5. Nella sezione URI di reindirizzamento autorizzati, fai clic su Aggiungi URI e inserisci il seguente URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Fai clic su Crea e copia le seguenti informazioni:

    • ID client
    • Client secret

Aggiungere un'azione di Google Calendar

Segui questi passaggi per creare un'azione di Google Calendar utilizzando la console o l'API:

Prima di iniziare

Prima di poter aggiungere un'azione di Google Calendar, assicurati di disporre dei prerequisiti necessari, inclusi un'app esistente e i dettagli di autenticazione.

  • Un amministratore Google Cloud deve prima completare i passaggi descritti nella sezione Configurare l'autenticazione e le autorizzazioni per Google Calendar e fornirti l'ID client e il client secret prima che tu possa aggiungere azioni.

  • Devi disporre di un'app Gemini Enterprise esistente collegata a un datastore Google Calendar. Per creare una nuova app, consulta Creare un'app.

  • Se di recente hai abilitato l'API Discovery Engine nel tuo progetto Google Cloud e hai creato un'app, attendi almeno 15 minuti prima che la configurazione dell'app venga completata prima di configurare le azioni di Google Calendar.

Configurare le azioni di Google Calendar

Console

Per aggiungere azioni alla tua app utilizzando la console:

  1. In Gemini Enterprise, vai alla pagina Gemini Enterprise.
  2. Scegli l'app Gemini Enterprise.
  3. Nel menu di navigazione, fai clic su Azioni.

  4. Aggiungi un'azione:

    • Se questa è la tua prima azione, fai clic su Aggiungi azione.

    • Se hai già creato azioni, fai clic su Crea.

  5. Per Google Calendar, fai clic su Connetti.

  6. Inserisci un nome per il connettore di azioni.

  7. Inserisci le informazioni di autorizzazione per il connettore di azioni:

    1. Per Nuovo ID client e Nuovo client secret, inserisci l'ID client e il client secret creati dall'amministratore nella sezione Crea credenziali client OAuth.
    2. Fai clic su Verifica autenticazione e concedi all'app Gemini Enterprise l'accesso al tuo Google Calendar.

  8. Seleziona le azioni da attivare.

  9. Fai clic su Termina configurazione. La tua azione viene visualizzata nella pagina Azioni.

REST

Per aggiungere azioni alla tua app utilizzando l'API, procedi nel seguente modo.

  1. Crea un connettore di azioni per l'azione Google Calendar.

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"google_calendar",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'
    • PROJECT_ID: l'ID del progetto in cui vuoi creare il connettore di azioni Google Calendar.
    • LOCATION: la regione multipla del connettore di azioni di Google Calendar:global, us o eu.
    • CONNECTOR_ID: l'ID del connettore che vuoi creare. Questo ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
    • CONNECTOR_DISPLAY_NAME: il nome visualizzato del connettore che vuoi creare.
    • CLIENT_ID: l'ID client creato dall'amministratore in Crea credenziali client OAuth.
    • CLIENT_SECRET: il client secret creato dall'amministratore in Crea credenziali client OAuth.

  2. Collega il connettore di azioni di Google Calendar che hai creato a un'app esistente.

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "create_calendar_event",
          "tool_display_name": "Create Calendar Event"
        }
      ]
    }
  }
}'
    • PROJECT_ID: l'ID del progetto in cui si trovano l'app e il connettore di azioni di Google Calendar.
    • LOCATION: la multiregione del connettore di app e azioni: global, us o eu.
    • APP_ID: l'ID dell'app a cui vuoi allegare l'azione.
    • CONNECTOR_ID: l'ID del connettore di azioni di Google Calendar creato nel passaggio precedente.

Dopo aver aggiunto le azioni, l'assistente può eseguirle per conto degli utenti finali nell'app. La prima volta che un utente chiede all'assistente di eseguire un'azione di Google Calendar, gli viene chiesto di autorizzare l'accesso al proprio account Google Calendar.

Azioni di Gmail

Quando le azioni di Gmail sono attive, gli utenti finali possono chiedere all'assistente di inviare email per loro.

Ad esempio, un utente potrebbe inserire "invia un'email a utente1@example.com con titolo 'Ciao' e contenuti 'come stai?'". Se necessario, l'assistente chiede ulteriori dettagli, quindi chiede all'utente di confermare l'invio dell'email.

L'assistente può leggere e modificare i seguenti campi di Gmail tramite le azioni:

Campo Descrizione
A Obbligatorio. Elenco email dei destinatari.
Oggetto Obbligatorio. Oggetto dell'email
Contenuti Obbligatorio. Contenuto dell'email in formato Markdown.
Cc Elenco dei destinatari in Cc dell'email.
Ccn Elenco Ccn dell'email.

Configurare l'autenticazione e le autorizzazioni per Gmail

Prima di attivare le azioni di Gmail, un Google Cloud amministratore deve attivare l'API Gmail e configurare l'autorizzazione.

Abilitare l'API Gmail

Nella console Google Cloud , abilita le seguenti API:

Crea un'app OAuth e aggiungi ambiti

Se non hai un'app OAuth, segui questi passaggi. Se hai già un'app OAuth, vai a Crea le credenziali di un client OAuth.

  1. Vai a Google Auth Platform/Panoramica.

  2. Fai clic su Inizia.

  3. Inserisci un nome per l'app OAuth.

  4. Inserisci un'email di assistenza utenti.

  5. Seleziona Interno.

  6. Inserisci i dati di contatto dello sviluppatore.

  7. Fai clic su Crea.

Crea le credenziali client OAuth

Questa procedura descrive come creare un nuovo ID client OAuth per le azioni di Google Cloud. Questo ID client OAuth e il client secret possono essere utilizzati anche per altre Google Cloud azioni. Se hai un ID client OAuth Google Cloud esistente per le Google Cloud azioni, puoi utilizzare questo ID client e il relativo secret per le azioni di Google Calendar anziché crearne uno nuovo.

  1. Vai a Google Auth Platform/Client.

  2. Fai clic su Crea cliente.

  3. Per Tipo di applicazione, seleziona Applicazione web.

  4. In Nome, inserisci un nome per l'ID client.

  5. Nella sezione URI di reindirizzamento autorizzati, fai clic su Aggiungi URI e inserisci il seguente URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Fai clic su Crea e copia le seguenti informazioni:

    • ID client
    • Client secret

Aggiungere un'azione Gmail

Segui questi passaggi per creare un'azione Gmail utilizzando la console o l'API:

Prima di iniziare

Prima di poter aggiungere un'azione Gmail, assicurati di disporre dei prerequisiti necessari, inclusi un'app esistente e i dettagli di autenticazione.

  • Un amministratore Google Cloud deve prima completare i passaggi descritti nella sezione Configurare l'autenticazione e le autorizzazioni per Gmail e fornirti l'ID client e il client secret prima che tu possa aggiungere azioni.

  • Devi disporre di un'app Gemini Enterprise esistente collegata a un datastore Gmail. Per creare una nuova app, consulta Creare un'app.

  • Se di recente hai abilitato l'API Discovery Engine nel tuo Google Cloud progetto e hai creato un'app, attendi almeno 15 minuti per il completamento della configurazione dell'app prima di configurare le azioni di Gmail.

Configurare le azioni di Gmail

Console

Per aggiungere azioni alla tua app utilizzando la console:

  1. In Gemini Enterprise, vai alla pagina Gemini Enterprise.
  2. Scegli l'app Gemini Enterprise.
  3. Nel menu di navigazione, fai clic su Azioni.

  4. Aggiungi un'azione:

    • Se questa è la tua prima azione, fai clic su Aggiungi azione.

    • Se hai già creato azioni, fai clic su Crea.

  5. Per Gmail, fai clic su Connetti.

  6. Inserisci un nome per il connettore di azioni.

  7. Inserisci le informazioni di autorizzazione per il connettore di azioni:

    1. Per Nuovo ID client e Nuovo client secret, inserisci l'ID client e il client secret creati dall'amministratore nella sezione Crea credenziali client OAuth.
    2. Fai clic su Verifica autenticazione e concedi all'app Gemini Enterprise l'accesso al tuo account Gmail.

  8. Seleziona le azioni da attivare.

  9. Fai clic su Termina configurazione. La tua azione viene visualizzata nella pagina Azioni.

REST

Per aggiungere azioni alla tua app utilizzando l'API, procedi nel seguente modo.

  1. Crea un connettore di azioni per l'azione Gmail.

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"gmail",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'
    • PROJECT_ID: l'ID del progetto in cui vuoi creare il connettore di azioni Gmail.
    • LOCATION: la regione multipla del connettore dell'azione Gmail: global, us o eu.
    • CONNECTOR_ID: l'ID del connettore che vuoi creare. Questo ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
    • CONNECTOR_DISPLAY_NAME: il nome visualizzato del connettore che vuoi creare.
    • CLIENT_ID: l'ID client creato dall'amministratore in Crea credenziali client OAuth.
    • CLIENT_SECRET: il client secret creato dall'amministratore in Crea credenziali client OAuth.

  2. Collega il connettore di azioni Gmail che hai creato a un'app esistente.

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "send_email",
          "tool_display_name": "Send Email"
        }
      ]
    }
  }
}'
    • PROJECT_ID: l'ID del progetto in cui si trovano l'app e il connettore di azioni Gmail.
    • LOCATION: la multiregione dell'app e del connettore: global, us o eu.
    • APP_ID: l'ID dell'app a cui vuoi allegare l'azione.
    • CONNECTOR_ID: l'ID del connettore di azioni Gmail creato nel passaggio precedente.

Dopo aver aggiunto le azioni, l'assistente può eseguirle per conto degli utenti finali nell'app. La prima volta che un utente chiede all'assistente di eseguire un'azione di Gmail, gli viene chiesto di autorizzare l'accesso al proprio account Gmail.

Collegare le azioni di Google Calendar e Gmail a un'app

La seguente richiesta API mostra come collegare le azioni di Google Calendar e Gmail a un'app esistente.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'
  • PROJECT_ID: l'ID del progetto in cui si trovano l'app e i connettori di azioni di Google Calendar e Gmail.
  • LOCATION: la multiregione della tua app e dei tuoi connettori: global, us o eu.
  • APP_ID: l'ID dell'app a cui vuoi allegare l'azione.
  • CALENDAR_CONNECTOR_ID: l'ID del connettore di azioni di Google Calendar creato nel passaggio precedente.
  • GMAIL_CONNECTOR_ID: l'ID del connettore di azioni Gmail creato nel passaggio precedente.

Dopo aver aggiunto le azioni, l'assistente può eseguirle per conto degli utenti finali nell'app. La prima volta che un utente chiede all'assistente di eseguire un'azione di Google Calendar o Gmail, gli viene chiesto di autorizzare l'accesso al proprio account.