Adicione ações do Calendário Google e do Gmail

A página seguinte descreve como configurar ações do assistente para o Calendário Google e o Gmail.

Ações do Calendário Google

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

Por exemplo, um utilizador pode introduzir "agenda uma reunião com user1@example.com às 15:00 de amanhã". O assistente pede detalhes adicionais, se necessário, e, em seguida, pede ao utilizador que confirme a criação do evento.

O assistente pode ler e editar os seguintes campos do Calendário Google 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 Google

Antes de ativar as ações do Google Calendar, um Google Cloud administrador tem de ativar a API Google Calendar e configurar a autorização da seguinte forma.

Ative a API Google Calendar

Na Google Cloud consola, ative as seguintes APIs:

Crie uma app OAuth e adicione âmbitos

Se não tiver uma app OAuth, siga estes passos. Se já tiver uma app OAuth, avance para Criar credenciais de cliente OAuth.

  1. Aceda a Google Auth Platform / Vista geral.

  2. Clique em Começar.

  3. Introduza um nome para a sua app OAuth.

  4. Introduza um email de apoio técnico ao utilizador.

  5. Selecione Interno.

  6. Introduza as informações de contacto do programador.

  7. Clique em Criar.

Crie credenciais do cliente OAuth

Este procedimento descreve como criar um novo ID de cliente OAuth para Google Cloud ações. Este ID de cliente e segredo OAuth também podem ser usados para outras Google Cloud ações. Se tiver um Google Cloud ID de cliente OAuth para Google Cloudações, pode usar esse ID de cliente e segredo para ações do Calendário Google em vez de criar um novo ID de cliente.

  1. Aceda a Google Auth Platform / Clientes.

  2. Clique em Criar cliente.

  3. Para Tipo de aplicação, selecione Aplicação Web.

  4. Em Nome, introduza um nome para o ID de cliente.

  5. Na secção URIs de redirecionamento autorizados, clique em Adicionar URI e introduza o seguinte URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Clique em Criar e copie as seguintes informações:

    • ID do cliente
    • Segredo do cliente

Adicione uma ação do Calendário Google

Siga estes passos para criar uma ação do Calendário Google através da consola ou da API:

Antes de começar

Antes de poder adicionar uma ação do Google Calendar, certifique-se de que tem os pré-requisitos necessários, incluindo uma app existente e detalhes de autenticação.

  • Um Google Cloud administrador tem primeiro de concluir os passos na secção Configurar a autenticação e as autorizações para o Calendário Google e fornecer-lhe o ID de cliente e o segredo do cliente antes de poder adicionar ações.

  • Tem de ter uma app Gemini Enterprise existente que esteja ligada a um arquivo de dados do Calendário Google. Para criar uma nova app, consulte o artigo Crie uma app.

  • Se ativou recentemente a API Discovery Engine no seu Google Cloud projeto e criou uma app, aguarde, pelo menos, 15 minutos para que a configuração da app seja concluída antes de configurar as ações do Calendário Google.

Configure ações do Calendário Google

Consola

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

  1. No Gemini Enterprise, aceda à página do Gemini Enterprise.
  2. Escolha a sua app Gemini Enterprise.
  3. No menu de navegação, clique em Ações.

  4. Adicione uma ação:

    • Se esta for a sua primeira ação, clique em Adicionar ação.

    • Se tiver criado ações anteriormente, clique em Criar.

  5. Para o Calendário Google, clique em Associar.

  6. Introduza um nome para o conetor de ações.

  7. Introduza as informações de autorização para o conector de ações:

    1. Para Novo ID de cliente e Novo segredo do cliente, introduza o ID de cliente e o segredo do cliente criados pelo seu administrador na secção Criar credenciais do cliente OAuth.
    2. Clique em Validar autorização e conceda à app Gemini Enterprise acesso ao seu Calendário Google.

  8. Selecione as ações a ativar.

  9. Clique em Concluir configuração. A sua ação é apresentada na página Ações.

REST

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

  1. Crie um conetor de ações para a ação do Calendário Google.

    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: o ID do projeto onde quer criar o conector de ações do Calendário Google.
    • LOCATION: a multirregião do conector de ações do Calendário Google: global, us ou eu.
    • CONNECTOR_ID: o ID do conector que quer criar. Este ID só pode conter letras minúsculas, dígitos, sublinhados e travessões.
    • CONNECTOR_DISPLAY_NAME: o nome a apresentar do conector que quer criar.
    • CLIENT_ID: o ID do cliente criado pelo seu administrador, em Criar credenciais do cliente OAuth.
    • CLIENT_SECRET: o segredo do cliente criado pelo seu administrador em Criar credenciais do cliente OAuth.

  2. Associe o conector de ações do Calendário Google que criou a uma app existente.

    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: o ID do projeto onde a sua app e o conector de ações do Calendário Google estão localizados.
    • LOCATION: a região múltipla da sua app e o conector de ações: global, us ou eu.
    • APP_ID: o ID da app à qual quer anexar a ação.
    • CONNECTOR_ID: o ID do conector de ações do Calendário Google criado no passo anterior.

Depois de adicionar ações, o assistente pode realizar essas ações em nome dos seus utilizadores finais na app. Da primeira vez que um utilizador pede ao assistente para realizar uma ação do Calendário Google, é-lhe pedido que autorize o acesso à respetiva conta do Calendário Google.

Ações do Gmail

Quando as ações do Gmail 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 user1@example.com com o título 'Olá' e o conteúdo 'como estás?'". 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 Gmail 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 Gmail

Antes de ativar as ações do Gmail, um Google Cloud administrador tem de ativar a API Gmail e configurar a autorização.

Ative a API Gmail

Na Google Cloud consola, ative as seguintes APIs:

Crie uma app OAuth e adicione âmbitos

Se não tiver uma app OAuth, siga estes passos. Se já tiver uma app OAuth, avance para Criar credenciais de cliente OAuth.

  1. Aceda a Google Auth Platform / Vista geral.

  2. Clique em Começar.

  3. Introduza um nome para a sua app OAuth.

  4. Introduza um email de apoio técnico ao utilizador.

  5. Selecione Interno.

  6. Introduza as informações de contacto do programador.

  7. Clique em Criar.

Crie credenciais do cliente OAuth

Este procedimento descreve como criar um novo ID de cliente OAuth para Google Cloud ações. Este ID de cliente e segredo OAuth também podem ser usados para outras Google Cloud ações. Se tiver um Google Cloud ID de cliente OAuth para Google Cloudações, pode usar esse ID de cliente e segredo para ações do Calendário Google em vez de criar um novo ID de cliente.

  1. Aceda a Google Auth Platform / Clientes.

  2. Clique em Criar cliente.

  3. Para Tipo de aplicação, selecione Aplicação Web.

  4. Em Nome, introduza um nome para o ID de cliente.

  5. Na secção URIs de redirecionamento autorizados, clique em Adicionar URI e introduza o seguinte URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Clique em Criar e copie as seguintes informações:

    • ID do cliente
    • Segredo do cliente

Adicione uma ação do Gmail

Siga estes passos para criar uma ação do Gmail através da consola ou da API:

Antes de começar

Antes de poder adicionar uma ação do Gmail, certifique-se de que tem os pré-requisitos necessários, incluindo uma app existente e detalhes de autenticação.

  • Um Google Cloud administrador tem de concluir primeiro os passos na secção Configure a autenticação e as autorizações para o Gmail e fornecer-lhe o ID do cliente e o segredo do cliente antes de poder adicionar ações.

  • Tem de ter uma app Gemini Enterprise existente que esteja associada a um arquivo de dados do Gmail. Para criar uma nova app, consulte o artigo Crie uma app.

  • Se ativou recentemente a API Discovery Engine no seu Google Cloud projeto e criou uma app, aguarde, pelo menos, 15 minutos para que a configuração da app seja concluída antes de configurar as ações do Gmail.

Configure ações do Gmail

Consola

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

  1. No Gemini Enterprise, aceda à página do Gemini Enterprise.
  2. Escolha a sua app Gemini Enterprise.
  3. No menu de navegação, clique em Ações.

  4. Adicione uma ação:

    • Se esta for a sua primeira ação, clique em Adicionar ação.

    • Se tiver criado ações anteriormente, clique em Criar.

  5. Para o Gmail, clique em Associar.

  6. Introduza um nome para o conetor de ações.

  7. Introduza as informações de autorização para o conector de ações:

    1. Para Novo ID de cliente e Novo segredo do cliente, introduza o ID de cliente e o segredo do cliente criados pelo seu administrador na secção Criar credenciais do cliente OAuth.
    2. Clique em Validar autorização e conceda à app Gemini Enterprise acesso ao seu Gmail.

  8. Selecione as ações a ativar.

  9. Clique em Concluir configuração. A sua ação é apresentada na página Ações.

REST

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

  1. Crie um conetor de ações para a ação do 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: o ID do projeto onde quer criar o conetor de ações do Gmail.
    • LOCATION: a multirregião do conector de ações do Gmail: global, us ou eu.
    • CONNECTOR_ID: o ID do conector que quer criar. Este ID só pode conter letras minúsculas, dígitos, sublinhados e travessões.
    • CONNECTOR_DISPLAY_NAME: o nome a apresentar do conector que quer criar.
    • CLIENT_ID: o ID do cliente criado pelo seu administrador, em Criar credenciais do cliente OAuth.
    • CLIENT_SECRET: o segredo do cliente criado pelo seu administrador em Criar credenciais do cliente OAuth.

  2. Associe o conector de ações do Gmail que criou a uma app existente.

    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: o ID do projeto onde a sua app e o conector de ações do Gmail 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.
    • CONNECTOR_ID: o ID do conector de ações do Gmail criado no passo anterior.

Depois de adicionar ações, o assistente pode realizar essas ações em nome dos seus utilizadores finais na app. Da primeira vez que um utilizador pede ao assistente para realizar uma ação do Gmail, é-lhe pedido que autorize o acesso à respetiva conta do Gmail.

Associe ações do Calendário Google e do Gmail a uma app

O pedido de API seguinte demonstra como associar o Calendário Google e as ações do Gmail a uma app existente.

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: o ID do projeto onde a sua app e os conetores de ações do Calendário Google e do Gmail estão localizados.
  • LOCATION: a multirregião da sua app e conectores: global, us ou eu.
  • APP_ID: o ID da app à qual quer anexar a ação.
  • CALENDAR_CONNECTOR_ID: o ID do conector de ações do Calendário Google criado no passo anterior.
  • GMAIL_CONNECTOR_ID: o ID do conector de ações do Gmail criado no passo anterior.

Depois de adicionar ações, o assistente pode realizar essas ações em nome dos seus utilizadores finais na app. Da primeira vez que um utilizador pede ao assistente para realizar uma ação do Calendário Google ou do Gmail, é-lhe pedido que autorize o acesso à respetiva conta.