Adicionar ações do Google Agenda e do Gmail

A página a seguir descreve como configurar ações do Google Assistente para o Google Agenda e o Gmail.

Ações do Google Agenda

Quando as ações do Google Agenda estão ativadas, os usuários finais podem pedir ao assistente para criar eventos do Google Agenda.

Por exemplo, um usuário pode inserir "agendar uma reunião com user1@example.com às 15h de amanhã". O assistente pede mais detalhes, se necessário, e depois pede que o usuário confirme a criação do evento.

O Google Assistente pode ler e editar os seguintes campos do Google Agenda com 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 o Google Agenda

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

Ativar a API Google Agenda

No console Google Cloud , ative as seguintes APIs:

Criar um app OAuth e adicionar escopos

Se você não tiver um app OAuth, siga estas etapas. Se você já tiver um app OAuth, vá para Criar credenciais de cliente OAuth.

  1. Acesse Google Auth Platform / Visão geral.

  2. Clique em Primeiros passos.

  3. Insira um nome para o app OAuth.

  4. Insira um e-mail de suporte ao usuário.

  5. Selecione Interno.

  6. Insira os dados de contato do desenvolvedor.

  7. Clique em Criar.

Criar credenciais de cliente OAuth

Este procedimento descreve como criar um novo ID do cliente OAuth para ações do Google Cloud. Esse ID e essa chave secreta do cliente OAuth também podem ser usados para outras ações do Google Cloud. Se você já tiver um ID do cliente OAuth Google Cloud para ações Google Cloud, use esse ID e a chave secreta para ações do Google Agenda em vez de criar um novo ID do cliente.

  1. Acesse Google Auth Platform / Clientes.

  2. Clique em Criar cliente.

  3. Em Tipo de aplicativo, selecione Aplicativo da Web.

  4. Em Nome, insira um nome para o ID do cliente.

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

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

    • ID do cliente
    • Chave secreta do cliente

Adicionar uma ação do Google Agenda

Siga estas etapas para criar uma ação do Google Agenda usando o console ou a API:

Antes de começar

Antes de adicionar uma ação do Google Agenda, verifique se você tem os pré-requisitos necessários, incluindo um app e detalhes de autenticação.

  • Um administrador precisa primeiro concluir as etapas na seção Configurar autenticação e permissões para o Google Agenda e fornecer o ID e a chave secreta do cliente antes que você possa adicionar ações. Google Cloud

  • Você precisa ter um app do Gemini Enterprise conectado a um repositório de dados do Google Agenda. Para criar um novo app, consulte Criar um app.

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

Configurar ações do Google Agenda

Console

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

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

  4. Adicione uma ação:

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

    • Se você já criou ações, clique em Criar.

  5. Para o Google Agenda, clique em Conectar.

  6. Insira um nome para o conector de ação.

  7. Insira as informações de autorização do conector de ação:

    1. Em Novo ID do cliente e Nova chave secreta do cliente, digite o ID e a chave secreta criados pelo administrador na seção Criar credenciais do cliente OAuth.
    2. Clique em Verificar autenticação e conceda ao app Gemini Enterprise acesso ao seu Google Agenda.

  8. Selecione as ações que você quer ativar.

  9. Clique em Terminar a configuração. Sua ação é exibida na página Ações.

REST

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

  1. Crie um conector de ação para a ação do Google Agenda.

    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 em que você quer criar o conector de ação do Google Agenda.
    • LOCATION: a multirregião do seu conector de ação do Google Agenda: global, us ou eu.
    • CONNECTOR_ID: o ID do conector que você quer criar. Ele só pode conter letras minúsculas, dígitos, sublinhados e hífens.
    • CONNECTOR_DISPLAY_NAME: o nome de exibição do conector que você quer criar.
    • CLIENT_ID: o ID do cliente criado pelo administrador em Criar credenciais do cliente OAuth.
    • CLIENT_SECRET: a chave secreta do cliente criada pelo administrador em Criar credenciais do cliente OAuth.

  2. Vincule o conector de ação do Google Agenda criado a um 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 em que seu app e o conector de ações do Google Agenda estão localizados.
    • LOCATION: a multirregião do seu app e conector de ação: global, us ou eu.
    • APP_ID: o ID do app a que você quer anexar a ação.
    • CONNECTOR_ID: o ID do conector de ação do Google Agenda criado na etapa anterior.

Depois de adicionar ações, o assistente pode realizá-las em nome dos usuários finais no app. Na primeira vez que um usuário pede ao assistente para realizar uma ação do Google Agenda, ele precisa autorizar o acesso à conta do Google Agenda.

Ações do Gmail

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

Por exemplo, um usuário pode inserir "envie um e-mail para usuario1@example.com com o título 'Olá' e o conteúdo 'como você está?'". 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 Gmail 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 o Gmail

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

Ativar a API Gmail

No console Google Cloud , ative as seguintes APIs:

Criar um app OAuth e adicionar escopos

Se você não tiver um app OAuth, siga estas etapas. Se você já tiver um app OAuth, vá para Criar credenciais de cliente OAuth.

  1. Acesse Google Auth Platform / Visão geral.

  2. Clique em Primeiros passos.

  3. Insira um nome para o app OAuth.

  4. Insira um e-mail de suporte ao usuário.

  5. Selecione Interno.

  6. Insira os dados de contato do desenvolvedor.

  7. Clique em Criar.

Criar credenciais de cliente OAuth

Este procedimento descreve como criar um novo ID do cliente OAuth para ações do Google Cloud. Esse ID e essa chave secreta do cliente OAuth também podem ser usados para outras ações do Google Cloud. Se você já tiver um ID do cliente OAuth Google Cloud para ações Google Cloud, use esse ID e a chave secreta para ações do Google Agenda em vez de criar um novo ID do cliente.

  1. Acesse Google Auth Platform / Clientes.

  2. Clique em Criar cliente.

  3. Em Tipo de aplicativo, selecione Aplicativo da Web.

  4. Em Nome, insira um nome para o ID do cliente.

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

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

    • ID do cliente
    • Chave secreta do cliente

Adicionar uma ação do Gmail

Siga estas etapas para criar uma ação do Gmail usando o console ou a API:

Antes de começar

Antes de adicionar uma ação do Gmail, verifique se você tem os pré-requisitos necessários, incluindo um app e detalhes de autenticação.

  • Um administrador do Google Cloud precisa concluir as etapas na seção Configurar autenticação e permissões para o Gmail e fornecer o ID e o chave secreta do cliente antes que você possa adicionar ações.

  • Você precisa ter um app do Gemini Enterprise conectado a um repositório de dados do Gmail. Para criar um novo app, consulte Criar um app.

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

Configurar ações do Gmail

Console

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

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

  4. Adicione uma ação:

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

    • Se você já criou ações, clique em Criar.

  5. Para o Gmail, clique em Conectar.

  6. Insira um nome para o conector de ação.

  7. Insira as informações de autorização do conector de ação:

    1. Em Novo ID do cliente e Nova chave secreta do cliente, digite o ID e a chave secreta criados pelo administrador na seção Criar credenciais do cliente OAuth.
    2. Clique em Verificar autenticação e conceda ao app Gemini Enterprise acesso ao seu Gmail.

  8. Selecione as ações que você quer ativar.

  9. Clique em Terminar a configuração. Sua ação é exibida na página Ações.

REST

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

  1. Crie um conector de ação 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 em que você quer criar o conector de ação do Gmail.
    • LOCATION: a multirregião do seu conector de ações do Gmail: global, us ou eu.
    • CONNECTOR_ID: o ID do conector que você quer criar. Ele só pode conter letras minúsculas, dígitos, sublinhados e hífens.
    • CONNECTOR_DISPLAY_NAME: o nome de exibição do conector que você quer criar.
    • CLIENT_ID: o ID do cliente criado pelo administrador em Criar credenciais do cliente OAuth.
    • CLIENT_SECRET: a chave secreta do cliente criada pelo administrador em Criar credenciais do cliente OAuth.

  2. Vincule o conector de ação do Gmail que você criou a um 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 em que seu app e o conector de ações do Gmail 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.
    • CONNECTOR_ID: o ID do conector de ação do Gmail criado na etapa anterior.

Depois de adicionar ações, o assistente pode realizá-las em nome dos usuários finais no app. Na primeira vez que um usuário pede ao assistente para realizar uma ação do Gmail, ele precisa autorizar o acesso à conta do Gmail.

Vincular ações do Google Agenda e do Gmail a um app

A solicitação de API a seguir demonstra como vincular as ações do Google Agenda e do Gmail a um 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 em que seu app e os conectores de ações do Google Agenda e do Gmail estão localizados.
  • LOCATION: a multirregião do seu app e dos conectores: global, us ou eu.
  • APP_ID: o ID do app a que você quer anexar a ação.
  • CALENDAR_CONNECTOR_ID: o ID do conector de ação do Google Agenda criado na etapa anterior.
  • GMAIL_CONNECTOR_ID: o ID do conector de ação do Gmail criado na etapa anterior.

Depois de adicionar ações, o assistente pode realizá-las em nome dos usuários finais no app. Na primeira vez que um usuário pede ao assistente para realizar uma ação do Google Agenda ou do Gmail, ele precisa autorizar o acesso à conta.