Adicionar ações de e-mail e calendário do Outlook

A página a seguir descreve como configurar ações para e-mail e calendário do Outlook.

Adicionar ações de e-mail do Outlook

Quando as ações de e-mail do Outlook estão ativadas, os usuários finais podem pedir ao assistente para enviar e-mails em nome deles.

Por exemplo, um usuário pode inserir "envie um e-mail para usuarioA@example.com com o título 'Reunião de hoje' e o conteúdo 'Qual é a pauta?'". O assistente pede mais detalhes, se necessário, e depois pede que o usuário confirme o envio do e-mail.

O assistente pode ler e editar os seguintes campos do Outlook por ações:

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

Configurar autenticação e permissões para e-mail do Outlook

Antes de ativar as ações do Outlook, um administrador precisa configurar a autenticação e as permissões do Outlook.

O procedimento a seguir se aplica às ações de e-mail e agenda do Outlook. Se você planeja usar ações de e-mail e de agenda, ative os escopos para ambos durante o procedimento de ativação de escopo.

Criar um app OAuth e adicionar escopos

  1. Faça login em https://portal.azure.com/ e acesse a página Registros de aplicativos.

  2. Clique em New registration.

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

  3. Em Certificados e chaves secretas, crie uma nova chave secreta do cliente. Anote a chave secreta do cliente. Ele só é mostrado imediatamente após a criação.

Para ativar os escopos necessários:

  1. Acesse a página de configurações Permissões da API no app do Azure.
  2. Clique em Adicionar uma permissão.
  3. Selecione Microsoft Graph.
  4. Selecione Permissões delegadas.
  5. Adicione os seguintes escopos:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se forem necessárias ações na agenda)
    4. Mail.Send (se forem necessárias ações de e-mail)

Dependendo do tipo de configurações organizacionais no Azure, a última etapa de ativação dos escopos pode ser omitida.

Configurar uma ação de e-mail do Outlook

Antes de começar, verifique se um administrador Google Cloud concluiu as etapas em Configurar autenticação e permissões para e-mail do Outlook e forneceu o seguinte:

  • ID do cliente
  • Chave secreta do cliente
  • ID do locatário (chamado de ID da instância na API)

Configurar ações de e-mail do Outlook usando a API

Para adicionar ações ao seu app usando a API, faça o seguinte:

As instruções a seguir podem ser usadas para configurar ações de e-mail e calendário do Outlook. Se você já configurou ações do calendário do Outlook, não precisa repetir essas etapas.

  1. Se você não tiver conectado seus dados do Outlook ao Gemini Enterprise, crie um conector do Outlook. Se você já tiver um conector do Outlook, vá para a próxima etapa.

    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:

    • PROJECT_NUMBER: o número do seu projeto Google Cloud .
    • COLLECTION_ID: o ID da coleção.
    • COLLECTION_DISPLAY_NAME: um nome de exibição para a coleção.
    • CLIENT_ID: o ID do cliente criado pelo seu administrador na seção Criar um app OAuth e adicionar escopos.
    • CLIENT_SECRET: a chave secreta do cliente criada pelo administrador na seção Criar um app OAuth e adicionar escopos.

  2. Inclua configurações de ação no conector 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:

  3. Ative as ações do Outlook para seu assistente. Não inclua a entrada do calendário se você só precisar da ação de e-mail.

    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:

    • PROJECT_ID: o ID do projeto em que seu app e o conector do Outlook estão localizados.
    • LOCATION: a multirregião do seu app e conector: global, us ou eu.
    • APP_ID: o ID do app a que você quer anexar a ação.
    • COLLECTION_ID: o ID do conector do Outlook criado na etapa anterior.

Depois de adicionar ações, o Google Assistente pode realizá-las em nome dos usuários finais no app. Na primeira vez que um usuário pede ao Google Assistente para realizar uma ação do Outlook, ele precisa autorizar o acesso à conta do Outlook. Para usar o assistente, os usuários precisam ter licenças do Gemini Enterprise Enterprise Plus.

Adicionar ações do Calendário do Outlook

Quando as ações do Calendário do Outlook estão ativadas, os usuários finais podem pedir ao assistente para criar eventos na agenda.

Por exemplo, um usuário pode inserir "agendar uma reunião com userA@example.com às 11h de sexta-feira, 4 de novembro". O assistente pede mais detalhes, se necessário, e solicita que o usuário confirme a criação do evento.

O assistente pode ler e editar os seguintes campos do calendário do Outlook usando ações:

Campo Descrição
Participantes Obrigatório. Lista de endereços de e-mail dos participantes. O usuário solicitante é adicionado automaticamente à lista.
Título Título da reunião.
Horário de início Horário de início da reunião.
Duração Duração da reunião. O padrão é 30 minutos.
Fuso horário Fuso horário da reunião. Se não for fornecido, o fuso horário do usuário será usado.
Descrição Descrição da reunião.

Configurar autenticação e permissões para a Agenda do Outlook

Antes de ativar as ações do Outlook, um administrador precisa configurar a autenticação e as permissões do Outlook.

O procedimento a seguir se aplica às ações de e-mail e agenda do Outlook. Se você planeja usar ações de e-mail e de agenda, ative os escopos para ambos durante o procedimento de ativação de escopo.

Criar um app OAuth e adicionar escopos

  1. Faça login em https://portal.azure.com/ e acesse a página Registros de aplicativos.

  2. Clique em New registration.

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

  3. Em Certificados e chaves secretas, crie uma nova chave secreta do cliente. Anote a chave secreta do cliente. Ele só é mostrado imediatamente após a criação.

Para ativar os escopos necessários:

  1. Acesse a página de configurações Permissões da API no app do Azure.
  2. Clique em Adicionar uma permissão.
  3. Selecione Microsoft Graph.
  4. Selecione Permissões delegadas.
  5. Adicione os seguintes escopos:
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (se forem necessárias ações na agenda)
    4. Mail.Send (se forem necessárias ações de e-mail)

Dependendo do tipo de configurações organizacionais no Azure, a última etapa de ativação dos escopos pode ser omitida.

Configurar uma ação do Calendário do Outlook

Antes de começar, verifique se um administrador do Microsoft Outlook concluiu as etapas em Configurar autenticação e permissões para o calendário do Outlook e forneceu o seguinte:

  • ID do cliente
  • Chave secreta do cliente
  • ID do locatário (chamado de ID da instância na API)

Configurar ações do calendário do Outlook usando a API

As instruções a seguir podem ser usadas para configurar ações de e-mail e calendário do Outlook. Se você já configurou as ações de e-mail do Outlook, não precisa repetir essas etapas.

Para adicionar ações ao seu app usando a API, faça o seguinte:

  1. Se você não tiver conectado seus dados do Outlook ao Gemini Enterprise, crie um conector do Outlook. Se você já tiver um conector do Outlook, vá para a próxima etapa.

    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:

    • PROJECT_NUMBER: o número do seu projeto Google Cloud .
    • COLLECTION_ID: o ID da coleção.
    • COLLECTION_DISPLAY_NAME: um nome de exibição para a coleção.
    • CLIENT_ID: o ID do cliente criado pelo seu administrador na seção Criar um app OAuth e adicionar escopos.
    • CLIENT_SECRET: a chave secreta do cliente criada pelo administrador na seção Criar um app OAuth e adicionar escopos.

  2. Inclua configurações de ação no conector 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:

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

    Você pode associar o novo conector de dados ao seu assistente na UI. Você precisa do seguinte comando de 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:

    • PROJECT_ID: o ID do projeto em que seu app e o conector do Outlook estão localizados.
    • APP_ID: o ID do app a que você quer anexar a ação.
    • COLLECTION_ID: o ID do conector do Outlook criado na etapa anterior.

Depois de adicionar ações, o Google Assistente pode realizá-las em nome dos usuários finais no app. Na primeira vez que um usuário pede ao Google Assistente para realizar uma ação do Outlook, ele precisa autorizar o acesso à conta do Outlook. Para usar o assistente, os usuários precisam ter licenças do Gemini Enterprise Enterprise Plus.