Añadir acciones de Google Calendar y Gmail

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

Acciones de Google Calendar

Cuando las acciones de Google Calendar están activadas, los usuarios finales pueden pedirle al asistente que cree eventos de Google Calendar por ellos.

Por ejemplo, un usuario podría introducir "programa una reunión con [e-mail] a las 15:00 de mañana". El asistente pide más detalles si es necesario y, a continuación, solicita al usuario que confirme la creación del evento.

El asistente puede leer y editar los siguientes campos de Google Calendar mediante acciones:

Campo	Descripción
Participantes	Obligatorio. Lista de direcciones de correo de los participantes. El usuario que hace la solicitud se añade automáticamente a la lista.
Título	Título de la reunión.
Hora de inicio	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.

Configurar la autenticación y los permisos de Google Calendar

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

Habilitar la API Google Calendar

En la Google Cloud consola, habilita las siguientes APIs:

• API de Google Calendar: habilita la API.

• API People de Google: habilita la API.

Crear una aplicación OAuth y añadirle permisos

Si no tienes una aplicación OAuth, sigue estos pasos. Si ya tienes una aplicación OAuth, ve a Crear credenciales de cliente de OAuth.

1. Ve a Plataforma de autenticación de Google/Descripción general.

2. Haz clic en Empezar.

3. Introduce un nombre para tu aplicación OAuth.

4. Introduce un correo de asistencia para usuarios.

5. Selecciona Interno.

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

7. Haz clic en Crear.

Crear credenciales de cliente de OAuth

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

1. Ve a Plataforma de autenticación de Google/Clientes.

2. Haz clic en Crear cliente.

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

4. En Name (Nombre), escribe el nombre del ID de cliente.

5. En la sección URIs de redirección autorizados, haz clic en Añadir URI e introduce 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 de cliente

Añadir una acción de Google Calendar

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

Antes de empezar

Antes de añadir una acción de Google Calendar, asegúrate de que cumples los requisitos previos, como tener una aplicación y los detalles de autenticación.

• Un administrador debe completar primero los pasos que se indican en la sección Configurar la autenticación y los permisos de Google Calendar y proporcionarte el ID de cliente y el secreto de cliente para que puedas añadir acciones. Google Cloud

• Debes tener una aplicación de Gemini Enterprise conectada a un almacén de datos de Google Calendar. Para crear una aplicación, consulta el artículo Crear una aplicación.

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

Configurar acciones de Google Calendar

Consola

Para añadir acciones a tu aplicación mediante la consola, sigue estos pasos:

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

4. Añadir una acción:

   • Si es la primera acción que añades, haz clic en Añadir acción.

   • Si ya has creado acciones, haz clic en Crear.

5. En Google Calendar, haz clic en Connect (Conectar).

6. Introduce un nombre para el conector de acciones.

7. Introduce la información de autorización de tu conector de acciones:

   1. En New client ID (Nuevo ID de cliente) y New client secret (Nuevo secreto de cliente), introduce el ID de cliente y el secreto de cliente que haya creado tu administrador en la sección Create OAuth client credentials (Crear credenciales de cliente de OAuth).
   2. Haz clic en Verificar autenticación y concede acceso a la aplicación Gemini Enterprise a tu calendario de Google.

8. Selecciona las acciones que quieras habilitar.

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

REST

Para añadir acciones a tu aplicación mediante la API, sigue estos pasos.

1. Crea un conector de acciones para la acción de Google Calendar.

   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: el ID del proyecto en el que quieres crear el conector de acción de Google Calendar.
   • LOCATION: la multirregión de tu conector de acción de Google Calendar: global, us o eu.
   • CONNECTOR_ID: el ID del conector que quieres crear. Este ID solo puede contener letras minúsculas, dígitos, guiones bajos y guiones.
   • CONNECTOR_DISPLAY_NAME: el nombre visible del conector que quieras crear.
   • CLIENT_ID: el ID de cliente creado por tu administrador en la sección Crear credenciales de cliente de OAuth.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear credenciales de cliente de OAuth.

2. Vincula el conector de acción de Google Calendar que has creado a una aplicación.

   Nota: Si ya has configurado acciones para tu aplicación, al ejecutar el siguiente comando se desvincularán. Para conservar las acciones que ya tienes y vincular la acción de Google Calendar, debes incluir los detalles de las acciones que ya tienes en la solicitud de la API. Para obtener más información, consulta Vincular acciones de Google Calendar y Gmail a una aplicación.

   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: el ID del proyecto en el que se encuentra tu aplicación y el conector de acciones de Google Calendar.
   • LOCATION: la multirregión de tu aplicación y el conector de acciones: global, us o eu.
   • APP_ID: el ID de la aplicación a la que quieres adjuntar la acción.
   • CONNECTOR_ID: el ID del conector de acción de Google Calendar creado en el paso anterior.

Después de añadir acciones, el asistente puede llevarlas a cabo en nombre de tus usuarios finales en la aplicación. La primera vez que un usuario le pida al asistente que realice una acción de Google Calendar, se le pedirá que autorice el acceso a su cuenta de Google Calendar.

Acciones de Gmail

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

Por ejemplo, un usuario podría introducir "send an email to [e-mail] with title 'Hi there' and content 'how are you doing?'". El asistente pide más detalles si es necesario y, a continuación, solicita al usuario que confirme el envío del correo.

El asistente puede leer y editar los siguientes campos de Gmail mediante acciones:

Campo	Descripción
Para	Obligatorio. Lista de correos de los destinatarios.
Asunto	Obligatorio. Asunto del correo
Contenido	Obligatorio. Contenido del correo en formato Markdown.
CC	Lista de destinatarios en copia del correo.
BCC	Lista de Cco del correo.

Configurar la autenticación y los permisos de Gmail

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

Habilitar la API de Gmail

En la Google Cloud consola, habilita las siguientes APIs:

• API de Gmail: habilita la API.

• API People de Google: habilita la API.

Crear una aplicación OAuth y añadirle permisos

Si no tienes una aplicación OAuth, sigue estos pasos. Si ya tienes una aplicación OAuth, ve a Crear credenciales de cliente de OAuth.

1. Ve a Plataforma de autenticación de Google/Descripción general.

2. Haz clic en Empezar.

3. Introduce un nombre para tu aplicación OAuth.

4. Introduce un correo de asistencia para usuarios.

5. Selecciona Interno.

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

7. Haz clic en Crear.

Crear credenciales de cliente de OAuth

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

1. Ve a Plataforma de autenticación de Google/Clientes.

2. Haz clic en Crear cliente.

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

4. En Name (Nombre), escribe el nombre del ID de cliente.

5. En la sección URIs de redirección autorizados, haz clic en Añadir URI e introduce 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 de cliente

Añadir una acción de Gmail

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

Antes de empezar

Antes de añadir una acción de Gmail, asegúrate de que cumples los requisitos necesarios, como tener una aplicación y los detalles de autenticación.

• Un administrador debe completar primero los pasos de la sección Configurar la autenticación y los permisos de Gmail y proporcionarte el ID de cliente y el secreto de cliente para que puedas añadir acciones. Google Cloud

• Debes tener una aplicación de Gemini Enterprise conectada a un almacén de datos de Gmail. Para crear una aplicación, consulta el artículo Crear una aplicación.

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

Configurar acciones de Gmail

Consola

Para añadir acciones a tu aplicación mediante la consola, sigue estos pasos:

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

4. Añadir una acción:

   • Si es la primera acción que añades, haz clic en Añadir acción.

   • Si ya has creado acciones, haz clic en Crear.

5. En Gmail, haz clic en Conectar.

6. Introduce un nombre para el conector de acciones.

7. Introduce la información de autorización de tu conector de acciones:

   1. En New client ID (Nuevo ID de cliente) y New client secret (Nuevo secreto de cliente), introduce el ID de cliente y el secreto de cliente que haya creado tu administrador en la sección Create OAuth client credentials (Crear credenciales de cliente de OAuth).
   2. Haz clic en Verificar autenticación y concede acceso a la aplicación Gemini Enterprise a tu cuenta de Gmail.

8. Selecciona las acciones que quieras habilitar.

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

REST

Para añadir acciones a tu aplicación mediante la API, sigue estos pasos.

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: el ID del proyecto en el que quieres crear el conector de acciones de Gmail.
   • LOCATION: la multirregión de tu conector de acciones de Gmail: global, us o eu.
   • CONNECTOR_ID: el ID del conector que quieres crear. Este ID solo puede contener letras minúsculas, dígitos, guiones bajos y guiones.
   • CONNECTOR_DISPLAY_NAME: el nombre visible del conector que quieras crear.
   • CLIENT_ID: el ID de cliente creado por tu administrador en la sección Crear credenciales de cliente de OAuth.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear credenciales de cliente de OAuth.

2. Vincula el conector de acción de Gmail que has creado a una aplicación.

   Nota: Si ya has configurado acciones para tu aplicación, al ejecutar el siguiente comando se desvincularán. Para conservar las acciones que ya tienes y vincular la acción de Gmail, debes incluir los detalles de las acciones que ya tienes en la solicitud de la API. Para obtener más información, consulta Vincular acciones de Google Calendar y Gmail a una aplicación.

   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: el ID del proyecto en el que se encuentra tu aplicación y el conector de acciones de Gmail.
   • LOCATION: la multirregión de tu aplicación y conector: global, us o eu.
   • APP_ID: el ID de la aplicación a la que quieres adjuntar la acción.
   • CONNECTOR_ID: el ID del conector de acción de Gmail creado en el paso anterior.

Después de añadir acciones, el asistente puede llevarlas a cabo en nombre de tus usuarios finales en la aplicación. La primera vez que un usuario le pide al asistente que realice una acción de Gmail, se le pide que autorice el acceso a su cuenta de Gmail.

Vincular acciones de Google Calendar y Gmail a una aplicación

La siguiente solicitud de API muestra cómo vincular las acciones de Google Calendar y Gmail a una aplicación ya creada.

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: el ID del proyecto en el que se encuentran tu aplicación y los conectores de acciones de Google Calendar y Gmail.
• LOCATION: la multirregión de tu aplicación y conectores: global, us o eu.
• APP_ID: el ID de la aplicación a la que quieres adjuntar la acción.
• CALENDAR_CONNECTOR_ID: el ID del conector de acción de Google Calendar creado en el paso anterior.
• GMAIL_CONNECTOR_ID: el ID del conector de acción de Gmail creado en el paso anterior.

Después de añadir acciones, el asistente puede llevarlas a cabo en nombre de tus usuarios finales en la aplicación. La primera vez que un usuario le pide al asistente que realice una acción de Google Calendar o de Gmail, se le pide que autorice el acceso a su cuenta.