Añadir acciones de calendario y correo de Outlook

Vista previa: Debes estar en la lista de permitidos para usar esta función.

Nota: Esta es una de las series de acciones del asistente. Para configurar otras acciones del Asistente, consulta Configurar acciones del Asistente.

En la página siguiente se describe cómo configurar acciones para el correo de Outlook y el calendario de Outlook.

Añadir acciones de correo de Outlook

Cuando las acciones de correo de Outlook 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 'Today's meeting' and content 'What's the agenda?'" (envía un correo a [e-mail] con el asunto "Reunión de hoy" y el contenido "¿Cuál es el orden del día?"). El asistente pide más detalles si es necesario y, a continuación, pide al usuario que confirme que quiere enviar el correo.

El asistente puede leer y editar los siguientes campos de Outlook 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 para el correo de Outlook

Antes de activar las acciones de Outlook, un administrador debe configurar la autenticación y los permisos de Outlook.

El siguiente procedimiento se aplica tanto a las acciones de correo de Outlook como a las de calendario de Outlook. Si tienes previsto usar acciones de correo y de calendario, habilita los ámbitos de ambas durante el procedimiento de habilitación de ámbitos.

Crear una aplicación OAuth y añadirle permisos

1. Inicia sesión en https://portal.azure.com/ y ve a la página Registros de aplicaciones.

2. Haz clic en Nuevo registro.

   1. Ponle un nombre a tu aplicación.
   2. En el URI de redirección:
      • En Tipo de plataforma, selecciona Web.
      • Añade el siguiente URI de redirección: https://vertexaisearch.cloud.google.com/oauth-redirect

3. En Certificados y secretos, crea un secreto de cliente. Anota el secreto de cliente. Se muestra solo inmediatamente después de la creación.

Para habilitar los ámbitos obligatorios, sigue estos pasos:

1. Ve a la página de configuración Permisos de API de tu aplicación de Azure.
2. Haz clic en Añadir un permiso.
3. Selecciona Microsoft Graph.
4. Selecciona Permisos delegados.
5. Añade los siguientes ámbitos:
   1. offline_access
   2. User.Read
   3. Calendars.ReadWrite (si se necesitan acciones de calendario)
   4. Mail.Send (si se necesitan acciones de correo electrónico)

En función del tipo de configuración de la organización en Azure, puede que no sea necesario completar este último paso para habilitar los ámbitos.

Configurar una acción de correo de Outlook

Antes de empezar, asegúrate de que un Google Cloud administrador ha completado los pasos que se indican en Configurar la autenticación y los permisos para el correo de Outlook y te ha proporcionado lo siguiente:

• ID de cliente
• Secreto de cliente
• ID de cliente (llamado "ID de instancia" en la API)

Configurar acciones de correo de Outlook mediante la API

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

Puedes seguir estas instrucciones para configurar acciones de correo y calendario de Outlook. Si ya has configurado acciones de calendario de Outlook, no es necesario que vuelvas a realizar estos pasos.

1. Si no has conectado tus datos de Outlook con Gemini Enterprise, crea un conector de Outlook. Si ya tienes un conector de Outlook, ve al siguiente paso.

   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",
     }
   }'
   

   Haz los cambios siguientes:

   • PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección.
   • COLLECTION_DISPLAY_NAME: un nombre visible para la colección.
   • CLIENT_ID: el ID de cliente creado por tu administrador, en la sección Crear una aplicación OAuth y añadir ámbitos.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear una aplicación OAuth y añadir permisos.

2. Incluye configuraciones de acciones en tu conector de 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",
         }
       }
     }'
   

   Haz los cambios siguientes:

   • PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección.
   • CLIENT_ID: el ID de cliente creado por tu administrador, en la sección Crear una aplicación OAuth y añadir ámbitos.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear una aplicación OAuth y añadir permisos.

3. Habilita las acciones de Outlook para tu asistente. Omite la entrada del calendario si solo necesitas la acción de correo.

   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"
             }
           ]
         }
       }
     }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID del proyecto en el que se encuentran tu aplicación y el conector de Outlook.
   • 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.
   • COLLECTION_ID: el ID del conector de Outlook que has 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 Outlook, se le pide que autorice el acceso a su cuenta de Outlook. Para usar el asistente, los usuarios deben tener licencias de Gemini Enterprise Enterprise Plus.

Añadir acciones del calendario de Outlook

Si las acciones del calendario de Outlook están activadas, los usuarios finales pueden pedirle al asistente que cree eventos de calendario por ellos.

Por ejemplo, un usuario podría introducir "programa una reunión con [e-mail] a las 11:00 del viernes 4 de noviembre". 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 del calendario de Outlook mediante acciones:

Campo	Descripción
Participantes	Obligatorio. Lista de direcciones de correo de los participantes. El usuario que envía 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 del calendario de Outlook

Antes de activar las acciones de Outlook, un administrador debe configurar la autenticación y los permisos de Outlook.

El siguiente procedimiento se aplica tanto a las acciones de correo de Outlook como a las de calendario de Outlook. Si tienes previsto usar acciones de correo y de calendario, habilita los ámbitos de ambas durante el procedimiento de habilitación de ámbitos.

Crear una aplicación OAuth y añadirle permisos

1. Inicia sesión en https://portal.azure.com/ y ve a la página Registros de aplicaciones.

2. Haz clic en Nuevo registro.

   1. Ponle un nombre a tu aplicación.
   2. En el URI de redirección:
      • En Tipo de plataforma, selecciona Web.
      • Añade el siguiente URI de redirección: https://vertexaisearch.cloud.google.com/oauth-redirect

3. En Certificados y secretos, crea un secreto de cliente. Anota el secreto de cliente. Se muestra solo inmediatamente después de la creación.

Para habilitar los ámbitos obligatorios, sigue estos pasos:

1. Ve a la página de configuración Permisos de API de tu aplicación de Azure.
2. Haz clic en Añadir un permiso.
3. Selecciona Microsoft Graph.
4. Selecciona Permisos delegados.
5. Añade los siguientes ámbitos:
   1. offline_access
   2. User.Read
   3. Calendars.ReadWrite (si se necesitan acciones de calendario)
   4. Mail.Send (si se necesitan acciones de correo electrónico)

En función del tipo de configuración de la organización en Azure, puede que no sea necesario completar este último paso para habilitar los ámbitos.

Configurar una acción de calendario de Outlook

Antes de empezar, asegúrate de que un administrador de Microsoft Outlook ha completado los pasos que se indican en Configurar la autenticación y los permisos del calendario de Outlook y te ha proporcionado lo siguiente:

• ID de cliente
• Secreto de cliente
• ID de cliente (llamado "ID de instancia" en la API)

Configurar acciones del calendario de Outlook mediante la API

Puedes seguir estas instrucciones para configurar acciones de correo y calendario de Outlook. Si ya has configurado las acciones de correo de Outlook, no es necesario que vuelvas a realizar estos pasos.

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

1. Si no has conectado tus datos de Outlook con Gemini Enterprise, crea un conector de Outlook. Si ya tienes un conector de Outlook, ve al siguiente paso.

   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",
     }
   }'
   

   Haz los cambios siguientes:

   • PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección.
   • COLLECTION_DISPLAY_NAME: un nombre visible para la colección.
   • CLIENT_ID: el ID de cliente creado por tu administrador, en la sección Crear una aplicación OAuth y añadir ámbitos.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear una aplicación OAuth y añadir permisos.

2. Incluye configuraciones de acciones en tu conector de 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",
         }
       }
     }'
   

   Haz los cambios siguientes:

   • PROJECT_NUMBER: el número de tu proyecto de Google Cloud .
   • COLLECTION_ID: el ID de la colección.
   • CLIENT_ID: el ID de cliente creado por tu administrador, en la sección Crear una aplicación OAuth y añadir ámbitos.
   • CLIENT_SECRET: el secreto de cliente creado por tu administrador en la sección Crear una aplicación OAuth y añadir permisos.

3. Habilita las acciones de Outlook para tu asistente.

   Puedes asociar el nuevo conector de datos a tu asistente en la interfaz de usuario. Necesitas el siguiente comando de API para habilitar tus acciones de 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"
             }
           ]
         }
       }
     }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID del proyecto en el que se encuentran tu aplicación y el conector de Outlook.
   • APP_ID: el ID de la aplicación a la que quieres adjuntar la acción.
   • COLLECTION_ID: el ID del conector de Outlook que has 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 Outlook, se le pide que autorice el acceso a su cuenta de Outlook. Para usar el asistente, los usuarios deben tener licencias de Gemini Enterprise Enterprise Plus.