Adicione ações de email e calendário do Outlook

A página seguinte descreve como configurar ações para o email do Outlook e o calendário do Outlook.

Adicione ações de email do Outlook

Quando as ações de email do Outlook estão ativadas, os utilizadores finais podem pedir ao assistente para enviar emails por eles.

Por exemplo, um utilizador pode introduzir "envia um email para userA@example.com com o título 'Reunião de hoje' e o conteúdo 'Qual é a agenda?'". O assistente pede detalhes adicionais, se necessário, e, em seguida, pede ao utilizador para confirmar o envio do email.

O assistente pode ler e editar os seguintes campos do Outlook através de ações:

Campo Descrição
Para Obrigatório. Lista de emails dos destinatários.
Assunto Obrigatório. Assunto do email
Conteúdo Obrigatório. Conteúdo do email no formato Markdown.
CC Lista de CC do email.
BCC Lista de CCO do email.

Configure a autenticação e as autorizações para o email do Outlook

Antes de ativar as ações do Outlook, um administrador tem de configurar a autenticação e as autorizações para o Outlook.

O procedimento seguinte aplica-se às ações de email e calendário do Outlook. Se planear usar ações de email e de calendário, ative os âmbitos para ambas durante o procedimento de ativação de âmbitos.

Crie uma app OAuth e adicione âmbitos

  1. Inicie sessão em https://portal.azure.com/ e navegue para a página Registos de apps.

  2. Clique em Novo registo.

    1. Atribua um nome à app.
    2. Para o URI de redirecionamento:
      • No tipo de plataforma, selecione Web.
      • Adicione o seguinte URI de redirecionamento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. Em Certificados e segredos, crie um novo segredo do cliente. Tome nota do segredo do cliente. É apresentado apenas imediatamente após a criação.

Para ativar os âmbitos necessários:

  1. Aceda à página de definições Autorizações da API na sua app Azure.
  2. Clique em Adicionar uma autorização.
  3. Selecione Microsoft Graph.
  4. Selecione Autorizações delegadas.
  5. Adicione os seguintes âmbitos:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se forem necessárias ações do calendário)
    4. Mail.Send (se forem necessárias ações de email)

Consoante o tipo de definições organizacionais no Azure, este último passo de ativação de âmbitos pode ser omitido.

Configure uma ação de email do Outlook

Antes de começar, certifique-se de que um Google Cloud administrador concluiu os passos em Configure a autenticação e as autorizações para o email do Outlook e lhe forneceu o seguinte:

  • ID do cliente
  • Segredo do cliente
  • ID do inquilino (denominado ID da instância na API)

Configure ações de email do Outlook através da API

Para adicionar ações à sua app através da API, faça o seguinte.

Pode usar as seguintes instruções para configurar ações de email e de calendário do Outlook. Se já configurou as ações do calendário do Outlook, não tem de repetir estes passos.

  1. Se não tiver associado os seus dados do Outlook ao Gemini Enterprise, crie um conetor do Outlook. Se já tiver um conector do Outlook, avance para o passo seguinte.

    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",
  }
}'

    Substitua o seguinte:

    • PROJECT_NUMBER: o número do seu projeto Google Cloud .
    • COLLECTION_ID: o ID da coleção.
    • COLLECTION_DISPLAY_NAME: um nome a apresentar para a coleção.
    • CLIENT_ID: o ID de cliente criado pelo seu administrador na secção Crie uma app OAuth e adicione âmbitos.
    • CLIENT_SECRET: o segredo do cliente criado pelo seu administrador na secção Crie uma app OAuth e adicione âmbitos.

  2. Inclua configurações de ações no conetor do 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",
      }
    }
  }'

    Substitua o seguinte:

  3. Ative as ações do Outlook para o seu assistente. Omita a entrada para o calendário se precisar apenas da ação de 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"
          }
        ]
      }
    }
  }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde a sua app e o conector do Outlook estão localizados.
    • LOCATION: a multirregião da sua app e conector: global, us ou eu.
    • APP_ID: o ID da app à qual quer anexar a ação.
    • COLLECTION_ID: o ID do conector do Outlook criado no passo anterior.

Depois de adicionar ações, o assistente pode realizar essas ações em nome dos seus utilizadores finais na app. A primeira vez que um utilizador pede ao assistente para realizar uma ação do Outlook, é-lhe pedido que autorize o acesso à respetiva conta do Outlook. Para usar o assistente, os utilizadores têm de ter licenças do Gemini Enterprise Plus.

Adicione ações do calendário do Outlook

Quando as ações do calendário do Outlook estão ativadas, os utilizadores finais podem pedir ao assistente para criar eventos de calendário para eles.

Por exemplo, um utilizador pode introduzir "agendar uma reunião com userA@example.com às 11:00 de sexta-feira, 4 de novembro". O assistente pede detalhes adicionais, se necessário, e, em seguida, pede ao utilizador para confirmar a criação do evento.

O assistente pode ler e editar os seguintes campos do calendário do Outlook através de ações:

Campo Descrição
Participantes Obrigatório. Lista de endereços de email dos participantes. O utilizador que faz o pedido é adicionado automaticamente à lista.
Título Título da reunião.
Hora de início Hora de início da reunião.
Duração Duração da reunião. A predefinição é 30 minutos.
Fuso horário Fuso horário da reunião. Se não for indicado, é usado o fuso horário do utilizador.
Descrição Descrição da reunião.

Configure a autenticação e as autorizações para o calendário do Outlook

Antes de ativar as ações do Outlook, um administrador tem de configurar a autenticação e as autorizações para o Outlook.

O procedimento seguinte aplica-se às ações de email e calendário do Outlook. Se planear usar ações de email e de calendário, ative os âmbitos para ambas durante o procedimento de ativação de âmbitos.

Crie uma app OAuth e adicione âmbitos

  1. Inicie sessão em https://portal.azure.com/ e navegue para a página Registos de apps.

  2. Clique em Novo registo.

    1. Atribua um nome à app.
    2. Para o URI de redirecionamento:
      • No tipo de plataforma, selecione Web.
      • Adicione o seguinte URI de redirecionamento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. Em Certificados e segredos, crie um novo segredo do cliente. Tome nota do segredo do cliente. É apresentado apenas imediatamente após a criação.

Para ativar os âmbitos necessários:

  1. Aceda à página de definições Autorizações da API na sua app Azure.
  2. Clique em Adicionar uma autorização.
  3. Selecione Microsoft Graph.
  4. Selecione Autorizações delegadas.
  5. Adicione os seguintes âmbitos:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se forem necessárias ações do calendário)
    4. Mail.Send (se forem necessárias ações de email)

Consoante o tipo de definições organizacionais no Azure, este último passo de ativação de âmbitos pode ser omitido.

Configure uma ação do calendário do Outlook

Antes de começar, certifique-se de que um administrador do Microsoft Outlook concluiu os passos em Configurar a autenticação e as autorizações para o calendário do Outlook e lhe forneceu o seguinte:

  • ID do cliente
  • Segredo do cliente
  • ID do inquilino (denominado ID da instância na API)

Configure ações do calendário do Outlook através da API

Pode usar as seguintes instruções para configurar ações de email e de calendário do Outlook. Se já configurou as ações de email do Outlook, não tem de realizar estes passos novamente.

Para adicionar ações à sua app através da API, faça o seguinte.

  1. Se não tiver associado os seus dados do Outlook ao Gemini Enterprise, crie um conetor do Outlook. Se já tiver um conector do Outlook, avance para o passo seguinte.

    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",
  }
}'

    Substitua o seguinte:

    • PROJECT_NUMBER: o número do seu projeto Google Cloud .
    • COLLECTION_ID: o ID da coleção.
    • COLLECTION_DISPLAY_NAME: um nome a apresentar para a coleção.
    • CLIENT_ID: o ID de cliente criado pelo seu administrador na secção Crie uma app OAuth e adicione âmbitos.
    • CLIENT_SECRET: o segredo do cliente criado pelo seu administrador na secção Crie uma app OAuth e adicione âmbitos.

  2. Inclua configurações de ações no conetor do 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",
      }
    }
  }'

    Substitua o seguinte:

  3. Ative as ações do Outlook para o seu assistente.

    Pode associar o novo conetor de dados ao seu assistente na IU. Precisa do seguinte comando da API para ativar as ações do Outlook:

    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"
          }
        ]
      }
    }
  }'

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde a sua app e o conector do Outlook estão localizados.
    • APP_ID: o ID da app à qual quer anexar a ação.
    • COLLECTION_ID: o ID do conector do Outlook criado no passo anterior.

Depois de adicionar ações, o assistente pode realizar essas ações em nome dos seus utilizadores finais na app. A primeira vez que um utilizador pede ao assistente para realizar uma ação do Outlook, é-lhe pedido que autorize o acesso à respetiva conta do Outlook. Para usar o assistente, os utilizadores têm de ter licenças do Gemini Enterprise Plus.