Agrega acciones de Calendario de Google y Gmail

En la siguiente página, se describe cómo configurar acciones del asistente para el Calendario de Google y Gmail.

Acciones del Calendario de Google

Cuando se activan las acciones de Calendario de Google, los usuarios finales pueden pedirle al asistente que cree eventos de Calendario de Google para ellos.

Por ejemplo, un usuario podría ingresar "Programa una reunión con usuario1@example.com a las 3 p.m. de mañana". El asistente solicita detalles adicionales si es necesario y, luego, le pide al usuario que confirme la creación del evento.

El asistente puede leer y editar los siguientes campos del Calendario de Google a través de acciones:

Campo Descripción
Participantes Obligatorio. Lista de direcciones de correo electrónico de los asistentes. El usuario solicitante se agrega automáticamente a la lista.
Título Título de la reunión
Hora de inicio Es la hora de inicio de la reunión.
Duración Duración de la reunión El valor predeterminado es de 30 minutos.
Zona horaria Zona horaria de la reunión. Si no se proporciona, se usa la zona horaria del usuario.
Descripción Descripción de la reunión.

Configura la autenticación y los permisos para el Calendario de Google

Antes de activar las acciones de Google Calendar, un Google Cloud administrador debe habilitar la API de Google Calendar y configurar la autorización de la siguiente manera.

Habilita la API de Calendario de Google

En la consola de Google Cloud , habilita las siguientes APIs:

Crea una app de OAuth y agrega permisos

Si no tienes una app de OAuth, sigue estos pasos. Si ya tienes una app de OAuth, ve a Crea credenciales de cliente de OAuth.

  1. Ve a Google Auth Platform / Overview.

  2. Haz clic en Comenzar.

  3. Ingresa un nombre para tu app de OAuth.

  4. Ingresa un correo electrónico de asistencia al usuario.

  5. Selecciona Interno.

  6. Ingresa la información de contacto del desarrollador.

  7. Haz clic en Crear.

Crea credenciales de cliente de OAuth

En este procedimiento, se describe cómo crear un nuevo ID de cliente de OAuth para las acciones de Google Cloud. Este ID y secreto del cliente de OAuth también se pueden usar para otras acciones de Google Cloud. Si tienes un ID de cliente de OAuth Google Cloud existente para las acciones de Google Cloud, puedes usar ese ID de cliente y secreto para las acciones de Calendario de Google en lugar de crear un ID de cliente nuevo.

  1. Ve a Google Auth Platform / Clients.

  2. Haz clic en Crear cliente.

  3. En Tipo de aplicación, selecciona Aplicación web.

  4. En Nombre, ingresa un nombre para tu ID de cliente.

  5. En la sección URI de redireccionamiento autorizados, haz clic en Agregar URI y, luego, ingresa el siguiente URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Haz clic en Crear y copia la siguiente información:

    • ID de cliente
    • Secreto del cliente

Agrega una acción del Calendario de Google

Sigue estos pasos para crear una acción de Calendario de Google con la consola o la API:

Antes de comenzar

Antes de agregar una acción de Calendario de Google, asegúrate de cumplir con los requisitos previos necesarios, como tener una app existente y detalles de autenticación.

  • Un administrador Google Cloud primero debe completar los pasos de la sección Configura la autenticación y los permisos para el Calendario de Google y proporcionarte el ID y el secreto del cliente para que puedas agregar acciones.

  • Debes tener una app de Gemini Enterprise existente que esté conectada a un almacén de datos de Calendario de Google. Para crear una app nueva, consulta Crea una app.

  • Si recientemente habilitaste la API de Discovery Engine en tu proyecto Google Cloud y creaste una app, espera al menos 15 minutos para que se complete la configuración de la app antes de configurar las acciones de Google Calendar.

Configura acciones del Calendario de Google

Console

Para agregar acciones a tu app con la consola, haz lo siguiente:

  1. En Gemini Enterprise, ve a la página de Gemini Enterprise.
  2. Elige tu app de Gemini Enterprise.
  3. En el menú de navegación, haz clic en Acciones.

  4. Agrega una acción:

    • Si esta es la primera acción, haz clic en Agregar acción.

    • Si ya creaste acciones, haz clic en Crear.

  5. En Calendario de Google, haz clic en Conectar.

  6. Ingresa un nombre para tu conector de acciones.

  7. Ingresa la información de autorización para tu conector de acción:

    1. En Nuevo ID de cliente y Nuevo secreto de cliente, ingresa el ID de cliente y el secreto del cliente que creó tu administrador en la sección Crea credenciales de cliente de OAuth.
    2. Haz clic en Verify Auth y otorga acceso a la app de Gemini Enterprise a tu Calendario de Google.

  8. Selecciona las acciones que quieres habilitar.

  9. Haz clic en Finalizar la configuración. Tu acción se muestra en la página Acciones.

REST

Para agregar acciones a tu app con la API, haz lo siguiente.

  1. Crea un conector de acción para la acción del Calendario de 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: Es el ID del proyecto en el que deseas crear el conector de acción de Calendario de Google.
    • LOCATION: Es la región múltiple del conector de acción del Calendario de Google: global, us o eu.
    • CONNECTOR_ID: Es el ID del conector que deseas crear. Este ID solo puede contener letras en minúscula, dígitos, guiones bajos y guiones.
    • CONNECTOR_DISPLAY_NAME: Es el nombre visible del conector que deseas crear.
    • CLIENT_ID: Es el ID de cliente que creó tu administrador en Create OAuth client credentials.
    • CLIENT_SECRET: Es el secreto del cliente que creó tu administrador en Create OAuth client credentials.

  2. Vincula el conector de acción del Calendario de Google que creaste a una 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: Es el ID del proyecto en el que se encuentran tu app y el conector de acciones de Google Calendar.
    • LOCATION: Es la multirregión de tu app y conector de acciones: global, us o eu.
    • APP_ID: Es el ID de la app a la que deseas adjuntar la acción.
    • CONNECTOR_ID: Es el ID del conector de acción de Calendario de Google que creaste en el paso anterior.

Después de agregar acciones, el asistente puede realizarlas en nombre de los usuarios finales en la app. La primera vez que un usuario le pide al asistente que realice una acción de Calendario de Google, se le solicita que autorice el acceso a su cuenta de Calendario de Google.

Acciones de Gmail

Cuando las acciones de Gmail están activadas, los usuarios finales pueden pedirle al asistente que envíe correos electrónicos por ellos.

Por ejemplo, un usuario podría ingresar "envía un correo electrónico a usuario1@example.com con el título "Hola" y el contenido "¿Cómo estás?". Si es necesario, el asistente solicita detalles adicionales y, luego, le pide al usuario que confirme el envío del correo electrónico.

El asistente puede leer y editar los siguientes campos de Gmail a través de acciones:

Campo Descripción
A Obligatorio. Lista de correos electrónicos de los destinatarios.
Asunto Obligatorio. Asunto del correo electrónico
Contenido Obligatorio. Es el contenido del correo electrónico en formato Markdown.
CC Lista de CC del correo electrónico.
BCC Lista de Cco del correo electrónico.

Configura la autenticación y los permisos para Gmail

Antes de activar las acciones de Gmail, un Google Cloud administrador debe habilitar la API de Gmail y configurar la autorización.

Habilita la API de Gmail

En la consola de Google Cloud , habilita las siguientes APIs:

Crea una app de OAuth y agrega permisos

Si no tienes una app de OAuth, sigue estos pasos. Si ya tienes una app de OAuth, ve a Crea credenciales de cliente de OAuth.

  1. Ve a Google Auth Platform / Overview.

  2. Haz clic en Comenzar.

  3. Ingresa un nombre para tu app de OAuth.

  4. Ingresa un correo electrónico de asistencia al usuario.

  5. Selecciona Interno.

  6. Ingresa la información de contacto del desarrollador.

  7. Haz clic en Crear.

Crea credenciales de cliente de OAuth

En este procedimiento, se describe cómo crear un nuevo ID de cliente de OAuth para las acciones de Google Cloud. Este ID y secreto del cliente de OAuth también se pueden usar para otras acciones de Google Cloud. Si tienes un ID de cliente de OAuth Google Cloud existente para las acciones de Google Cloud, puedes usar ese ID de cliente y secreto para las acciones de Calendario de Google en lugar de crear un ID de cliente nuevo.

  1. Ve a Google Auth Platform / Clients.

  2. Haz clic en Crear cliente.

  3. En Tipo de aplicación, selecciona Aplicación web.

  4. En Nombre, ingresa un nombre para tu ID de cliente.

  5. En la sección URI de redireccionamiento autorizados, haz clic en Agregar URI y, luego, ingresa el siguiente URI: https://vertexaisearch.cloud.google.com/oauth-redirect

  6. Haz clic en Crear y copia la siguiente información:

    • ID de cliente
    • Secreto del cliente

Agrega una acción de Gmail

Sigue estos pasos para crear una acción de Gmail con la consola o la API:

Antes de comenzar

Antes de agregar una acción de Gmail, asegúrate de cumplir con los requisitos previos necesarios, como tener una app existente y detalles de autenticación.

  • Un administrador de Google Cloud primero debe completar los pasos de la secciónConfigura la autenticación y los permisos para Gmaily proporcionarte el ID de cliente y el secreto del cliente antes de que puedas agregar acciones.

  • Debes tener una app de Gemini Enterprise existente que esté conectada a un almacén de datos de Gmail. Para crear una app nueva, consulta Crea una app.

  • Si habilitaste recientemente la API de Discovery Engine en tu Google Cloud proyecto y creaste una app, espera al menos 15 minutos para que se complete la configuración de la app antes de configurar las acciones de Gmail.

Configura acciones de Gmail

Console

Para agregar acciones a tu app con la consola, haz lo siguiente:

  1. En Gemini Enterprise, ve a la página de Gemini Enterprise.
  2. Elige tu app de Gemini Enterprise.
  3. En el menú de navegación, haz clic en Acciones.

  4. Agrega una acción:

    • Si esta es la primera acción, haz clic en Agregar acción.

    • Si ya creaste acciones, haz clic en Crear.

  5. En el caso de Gmail, haz clic en Conectar.

  6. Ingresa un nombre para tu conector de acciones.

  7. Ingresa la información de autorización para tu conector de acción:

    1. En Nuevo ID de cliente y Nuevo secreto de cliente, ingresa el ID de cliente y el secreto del cliente que creó tu administrador en la sección Crea credenciales de cliente de OAuth.
    2. Haz clic en Verify Auth y otorga acceso a la app de Gemini Enterprise a tu cuenta de Gmail.

  8. Selecciona las acciones que quieres habilitar.

  9. Haz clic en Finalizar la configuración. Tu acción se muestra en la página Acciones.

REST

Para agregar acciones a tu app con la API, haz lo siguiente.

  1. Crea un conector de acción para la acción de 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: Es el ID del proyecto en el que deseas crear el conector de acciones de Gmail.
    • LOCATION: Es la multirregión de tu conector de acción de Gmail: global, us o eu.
    • CONNECTOR_ID: Es el ID del conector que deseas crear. Este ID solo puede contener letras en minúscula, dígitos, guiones bajos y guiones.
    • CONNECTOR_DISPLAY_NAME: Es el nombre visible del conector que deseas crear.
    • CLIENT_ID: Es el ID de cliente que creó tu administrador en Create OAuth client credentials.
    • CLIENT_SECRET: Es el secreto del cliente que creó tu administrador en Create OAuth client credentials.

  2. Vincula el conector de acción de Gmail que creaste a una 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: Es el ID del proyecto en el que se encuentran tu app y el conector de acciones de Gmail.
    • LOCATION: Es la multirregión de tu app y conector: global, us o eu.
    • APP_ID: Es el ID de la app a la que deseas adjuntar la acción.
    • CONNECTOR_ID: Es el ID del conector de acción de Gmail que creaste en el paso anterior.

Después de agregar acciones, el asistente podrá realizarlas en nombre de los usuarios finales en la app. La primera vez que un usuario le pida al asistente que realice una acción de Gmail, se le pedirá que autorice el acceso a su cuenta de Gmail.

Vincula las acciones de Calendario de Google y Gmail a una app

En la siguiente solicitud a la API, se muestra cómo vincular las acciones de Calendario de Google y Gmail a una 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: Es el ID del proyecto en el que se encuentran tu app y los conectores de acciones de Calendario de Google y Gmail.
  • LOCATION: Es la multirregión de tu app y tus conectores: global, us o eu.
  • APP_ID: Es el ID de la app a la que deseas adjuntar la acción.
  • CALENDAR_CONNECTOR_ID: Es el ID del conector de acción de Calendario de Google que creaste en el paso anterior.
  • GMAIL_CONNECTOR_ID: Es el ID del conector de acción de Gmail que creaste en el paso anterior.

Después de agregar acciones, el asistente podrá realizarlas en nombre de los usuarios finales en la app. La primera vez que un usuario le pida al asistente que realice una acción de Calendario de Google o Gmail, se le solicitará que autorice el acceso a su cuenta.