Agregar acciones de calendario y correo electrónico de Outlook

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

Agrega acciones de correo electrónico de Outlook

Cuando las acciones de correo electrónico de Outlook 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 usuarioA@example.com con el título "Reunión de hoy" y el contenido "¿Cuál es la agenda?". El asistente solicita detalles adicionales si es necesario 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 Outlook 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 el correo electrónico de Outlook

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

El siguiente procedimiento se aplica a las acciones de correo electrónico y calendario de Outlook. Si planeas usar acciones de correo electrónico y calendario, habilita los permisos para ambos durante el procedimiento de habilitación de permisos.

Crea una app de OAuth y agrega permisos

  1. Accede a https://portal.azure.com/ y navega a la página Registros de aplicaciones.

  2. Haz clic en Registro nuevo.

    1. Asigna un nombre a tu app.
    2. Para el URI de redireccionamiento:
      • En el tipo de plataforma, selecciona Web.
      • Agrega el siguiente URI de redireccionamiento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. En Certificados y secretos, crea un nuevo secreto del cliente. Toma nota del secreto del cliente. Solo se muestra inmediatamente después de la creación.

Para habilitar los permisos requeridos, sigue estos pasos:

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

Según el tipo de configuración de la organización en Azure, es posible que se omita este último paso para habilitar los permisos.

Configura una acción de correo electrónico de Outlook

Antes de comenzar, asegúrate de que un administrador haya completado los pasos que se indican en Cómo configurar la autenticación y los permisos para el correo electrónico de Outlook y te haya proporcionado lo siguiente: Google Cloud

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

Configura acciones de correo electrónico de Outlook con la API

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

Las siguientes instrucciones se pueden usar para configurar las acciones de calendario y correo electrónico de Outlook. Si ya configuraste las acciones del calendario de Outlook, no es necesario que vuelvas a realizar estos pasos.

  1. Si no conectaste tus datos de Outlook a 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",
  }
}'

    Reemplaza lo siguiente:

    • PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud .
    • COLLECTION_ID: ID de la colección.
    • COLLECTION_DISPLAY_NAME: Es un nombre visible para la colección.
    • CLIENT_ID: Es el ID de cliente que creó tu administrador en la sección Crea una app de OAuth y agrega permisos.
    • CLIENT_SECRET: Es el secreto del cliente que creó tu administrador en la sección Crea una app de OAuth y agrega permisos.

  2. Incluye la configuración 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",
      }
    }
  }'

    Reemplaza lo siguiente:

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

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

    Reemplaza lo siguiente:

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

Agregar acciones del calendario de Outlook

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

Por ejemplo, un usuario podría ingresar "Programa una reunión con usuarioA@ejemplo.com a las 11 a.m. del viernes 4 de noviembre". 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 Outlook 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 Outlook

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

El siguiente procedimiento se aplica a las acciones de correo electrónico y calendario de Outlook. Si planeas usar acciones de correo electrónico y calendario, habilita los permisos para ambos durante el procedimiento de habilitación de permisos.

Crea una app de OAuth y agrega permisos

  1. Accede a https://portal.azure.com/ y navega a la página Registros de aplicaciones.

  2. Haz clic en Registro nuevo.

    1. Asigna un nombre a tu app.
    2. Para el URI de redireccionamiento:
      • En el tipo de plataforma, selecciona Web.
      • Agrega el siguiente URI de redireccionamiento: https://vertexaisearch.cloud.google.com/oauth-redirect

  3. En Certificados y secretos, crea un nuevo secreto del cliente. Toma nota del secreto del cliente. Solo se muestra inmediatamente después de la creación.

Para habilitar los permisos requeridos, sigue estos pasos:

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

Según el tipo de configuración de la organización en Azure, es posible que se omita este último paso para habilitar los permisos.

Configura una acción del calendario de Outlook

Antes de comenzar, asegúrate de que un administrador de Microsoft Outlook haya completado los pasos que se indican en Configura la autenticación y los permisos para el calendario de Outlook y te haya proporcionado la siguiente información:

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

Configura acciones del calendario de Outlook con la API

Las siguientes instrucciones se pueden usar para configurar las acciones de calendario y correo electrónico de Outlook. Si ya configuraste las acciones de correo electrónico de Outlook, no es necesario que vuelvas a realizar estos pasos.

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

  1. Si no conectaste tus datos de Outlook a 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",
  }
}'

    Reemplaza lo siguiente:

    • PROJECT_NUMBER: Es el número de tu proyecto de Google Cloud .
    • COLLECTION_ID: ID de la colección.
    • COLLECTION_DISPLAY_NAME: Es un nombre visible para la colección.
    • CLIENT_ID: Es el ID de cliente que creó tu administrador en la sección Crea una app de OAuth y agrega permisos.
    • CLIENT_SECRET: Es el secreto del cliente que creó tu administrador en la sección Crea una app de OAuth y agrega permisos.

  2. Incluye la configuración 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",
      }
    }
  }'

    Reemplaza lo siguiente:

  3. Habilita las acciones de Outlook para tu asistente.

    Puedes asociar el nuevo conector de datos a tu asistente en la IU. 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"
          }
        ]
      }
    }
  }'

    Reemplaza lo siguiente:

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