Aggiungere azioni di calendario ed email di Outlook

La pagina seguente descrive come configurare le azioni per le email di Outlook e il calendario di Outlook.

Aggiungere azioni email di Outlook

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

Ad esempio, un utente potrebbe inserire "invia un'email a utenteA@example.com con titolo'Riunione di oggi' e contenuti 'Qual è l'agenda?'". L'assistente chiede ulteriori dettagli, se necessario, e poi chiede all'utente di confermare l'invio dell'email.

L'assistente può leggere e modificare i seguenti campi di Outlook 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 le email di Outlook

Prima di attivare le azioni di Outlook, un amministratore deve configurare l'autenticazione e le autorizzazioni per Outlook.

La seguente procedura si applica sia alle azioni di posta di Outlook sia a quelle del calendario di Outlook. Se prevedi di utilizzare sia le azioni email che quelle del calendario, attiva gli ambiti per entrambi durante la procedura di attivazione degli ambiti.

Crea un'app OAuth e aggiungi ambiti

  1. Accedi a https://portal.azure.com/ e vai alla pagina Registrazioni app.

  2. Fai clic su Nuova registrazione.

    1. Assegna un nome all'app.
    2. Per l'URI di reindirizzamento:
      • Per il tipo di piattaforma, seleziona Web.
      • Aggiungi il seguente URI di reindirizzamento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. Nella sezione Certificati e secret, crea un nuovo client secret. Prendi nota del client secret. Viene visualizzato solo subito dopo la creazione.

Per abilitare gli ambiti richiesti:

  1. Vai alla pagina delle impostazioni Autorizzazioni API nella tua app Azure.
  2. Fai clic su Aggiungi un'autorizzazione.
  3. Seleziona Microsoft Graph.
  4. Seleziona Autorizzazioni delegate.
  5. Aggiungi i seguenti ambiti:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se sono necessarie azioni del calendario)
    4. Mail.Send (se sono necessarie azioni email)

A seconda del tipo di impostazioni dell'organizzazione in Azure, quest'ultimo passaggio di attivazione degli ambiti potrebbe essere omesso.

Configurare un'azione email di Outlook

Prima di iniziare, assicurati che un Google Cloud amministratore abbia completato i passaggi descritti in Configurare l'autenticazione e le autorizzazioni per l'email di Outlook e ti abbia fornito quanto segue:

  • ID client
  • Client secret
  • ID tenant (denominato ID istanza nell'API)

Configurare le azioni email di Outlook utilizzando l'API

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

Le seguenti istruzioni possono essere utilizzate per configurare le azioni di email e calendario di Outlook. Se hai già configurato le azioni del calendario di Outlook, non è necessario ripetere questi passaggi.

  1. Se non hai collegato i tuoi dati di Outlook a Gemini Enterprise, crea un connettore Outlook. Se hai già un connettore Outlook, vai al passaggio successivo.

    SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

    Sostituisci quanto segue:

    • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
    • COLLECTION_ID: l'ID della raccolta.
    • COLLECTION_DISPLAY_NAME: un nome visualizzato per la raccolta.
    • CLIENT_ID: l'ID client creato dall'amministratore nella sezione Creare un'app OAuth e aggiungere ambiti.
    • CLIENT_SECRET: il client secret creato dall'amministratore nella sezione Crea un'app OAuth e aggiungi ambiti.

  2. Includi le configurazioni delle azioni nel connettore Outlook:

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

    Sostituisci quanto segue:

  3. Attiva le azioni di Outlook per l'assistente. Ometti la voce per il calendario se ti serve solo l'azione email.

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui si trovano l'app e il connettore Outlook.
    • LOCATION: la multiregione dell'app e del connettore: global, us o eu.
    • APP_ID: l'ID dell'app a cui vuoi allegare l'azione.
    • COLLECTION_ID: l'ID del connettore Outlook 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 Outlook, gli viene chiesto di autorizzare l'accesso al proprio account Outlook. Per utilizzare l'assistente, gli utenti devono disporre di licenze Gemini Enterprise Enterprise Plus.

Aggiungere azioni del calendario Outlook

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

Ad esempio, un utente potrebbe inserire "pianifica una riunione con utenteA@example.com alle 11:00 di venerdì 4 novembre". L'assistente chiede ulteriori dettagli se necessario, poi chiede all'utente di confermare la creazione dell'evento.

L'assistente può leggere e modificare i seguenti campi del calendario di Outlook tramite azioni:

Campo Descrizione
Partecipanti Obbligatorio. Elenco degli indirizzi email dei partecipanti. L'utente richiedente 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 fornito, viene utilizzato il fuso orario dell'utente.
Descrizione Descrizione della riunione.

Configura l'autenticazione e le autorizzazioni per il calendario di Outlook

Prima di attivare le azioni di Outlook, un amministratore deve configurare l'autenticazione e le autorizzazioni per Outlook.

La seguente procedura si applica sia alle azioni di posta di Outlook sia a quelle del calendario di Outlook. Se prevedi di utilizzare sia le azioni email che quelle del calendario, attiva gli ambiti per entrambi durante la procedura di attivazione degli ambiti.

Crea un'app OAuth e aggiungi ambiti

  1. Accedi a https://portal.azure.com/ e vai alla pagina Registrazioni app.

  2. Fai clic su Nuova registrazione.

    1. Assegna un nome all'app.
    2. Per l'URI di reindirizzamento:
      • Per il tipo di piattaforma, seleziona Web.
      • Aggiungi il seguente URI di reindirizzamento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. Nella sezione Certificati e secret, crea un nuovo client secret. Prendi nota del client secret. Viene visualizzato solo subito dopo la creazione.

Per abilitare gli ambiti richiesti:

  1. Vai alla pagina delle impostazioni Autorizzazioni API nella tua app Azure.
  2. Fai clic su Aggiungi un'autorizzazione.
  3. Seleziona Microsoft Graph.
  4. Seleziona Autorizzazioni delegate.
  5. Aggiungi i seguenti ambiti:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se sono necessarie azioni del calendario)
    4. Mail.Send (se sono necessarie azioni email)

A seconda del tipo di impostazioni dell'organizzazione in Azure, quest'ultimo passaggio di attivazione degli ambiti potrebbe essere omesso.

Configurare un'azione del calendario Outlook

Prima di iniziare, assicurati che un amministratore di Microsoft Outlook abbia completato i passaggi descritti in Configurare l'autenticazione e le autorizzazioni per il calendario di Outlook e ti abbia fornito quanto segue:

  • ID client
  • Client secret
  • ID tenant (denominato ID istanza nell'API)

Configurare le azioni del calendario di Outlook utilizzando l'API

Le seguenti istruzioni possono essere utilizzate per configurare le azioni di email e calendario di Outlook. Se hai già configurato le azioni email di Outlook, non è necessario ripetere questi passaggi.

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

  1. Se non hai collegato i tuoi dati di Outlook a Gemini Enterprise, crea un connettore Outlook. Se hai già un connettore Outlook, vai al passaggio successivo.

    SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

    Sostituisci quanto segue:

    • PROJECT_NUMBER: il numero del tuo Google Cloud progetto.
    • COLLECTION_ID: l'ID della raccolta.
    • COLLECTION_DISPLAY_NAME: un nome visualizzato per la raccolta.
    • CLIENT_ID: l'ID client creato dall'amministratore nella sezione Creare un'app OAuth e aggiungere ambiti.
    • CLIENT_SECRET: il client secret creato dall'amministratore nella sezione Crea un'app OAuth e aggiungi ambiti.

  2. Includi le configurazioni delle azioni nel connettore Outlook:

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

    Sostituisci quanto segue:

  3. Attiva le azioni di Outlook per l'assistente.

    Puoi associare il nuovo connettore dati al tuo assistente nell'interfaccia utente. Per abilitare le azioni di Outlook, devi utilizzare il seguente comando API:

    SERVER=https://discoveryengine.googleapis.com
PROJECT_NUMBER={YOUR PROJECT_NUMBER}
ENGINE_ID="{YOUR ENGINE ID}"
CONNECTOR_ID="{THE CONNECTOR'S COLLECTION ID YOU GENERATED IN PREVIOUS STEP}"

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui si trovano l'app e il connettore Outlook.
    • APP_ID: l'ID dell'app a cui vuoi allegare l'azione.
    • COLLECTION_ID: l'ID del connettore Outlook 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 Outlook, gli viene chiesto di autorizzare l'accesso al proprio account Outlook. Per utilizzare l'assistente, gli utenti devono disporre di licenze Gemini Enterprise Enterprise Plus.