Configura un almacén de datos de Zendesk

En esta página, se describe cómo crear un almacén de datos y conectar Zendesk a Gemini Enterprise.

Antes de comenzar

Antes de configurar tu almacén de datos de Zendesk, asegúrate de lo siguiente:

  1. Otorga el rol de Editor de Discovery Engine (roles/discoveryengine.editor). Este rol es necesario para que el usuario cree el almacén de datos. Para otorgar este rol, haz lo siguiente:

    1. En la consola de Google Cloud , ve a la página IAM.

      Ir a IAM

    2. Ubica la cuenta de usuario y haz clic en el ícono de editar Editar.
    3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.

  2. Crea un cliente de OAuth y obtén las siguientes credenciales:

    • ID de cliente

    • Secreto del cliente

  3. Configura los permisos necesarios en Zendesk para la aplicación de OAuth.

  4. Asegúrate de que el acceso con token esté habilitado en la configuración de la API de Zendesk.

Crea el almacén de datos de Zendesk

Para crear el almacén de datos de Zendesk, sigue estos pasos:

  1. En la consola de Google Google Cloud , ve a la página Gemini Enterprise.

    Gemini Enterprise

  2. Selecciona o crea un proyecto de Google Cloud .

  3. En el menú de navegación, haz clic en Almacenes de datos.

  4. Haz clic en Crear almacén de datos.

  5. En Fuente, busca Zendesk y haz clic en Seleccionar.

  6. En la sección Datos, haz lo siguiente:

    1. En la sección Configuración de autenticación, proporciona los siguientes detalles: * URI de instancia: Ingresa el URI de la instancia de Zendesk (por ejemplo, https://[subdomain].zendesk.com). * ID de cliente: Es el identificador único de la aplicación registrada en Zendesk. * Secreto del cliente: Es la clave secreta que se generó durante el proceso de registro de la aplicación de OAuth 2.0 en Zendesk.

      Para obtener información sobre cómo obtener el ID de cliente y el secreto del cliente, consulta Obtén el ID de cliente y el secreto del cliente. Para conocer los permisos necesarios para realizar búsquedas, consulta Permisos necesarios.

    2. Haz clic en Acceder y completa el acceso a Zendesk.

    3. Haz clic en Continuar.

    4. En la sección Destinos, haz lo siguiente:

      1. Servidor proxy: Ingresa el nombre de host o la dirección IP de un proxy para enrutar el tráfico HTTP, incluidos el Host y el Puerto.
      2. URL de asistencia de Zendesk: Ingresa la URL de la instancia, incluido https://, que es tu URL de asistencia de Zendesk.
      3. Haz clic en Continuar.

    5. Opcional: En la sección Opciones avanzadas, haz lo siguiente:

      1. Habilitar direcciones IP estáticas: Registra un conjunto reducido de direcciones IP estáticas para agregarlas a la lista de entidades permitidas de tu sistema. Las ejecuciones de sincronización fallarán hasta que estas direcciones IP estén en la lista de entidades permitidas.
      2. Max API Requests Per Minute: Es la cantidad máxima de solicitudes a la API por minuto que se pueden enviar a tu instancia de Zendesk para cada ejecución del conector.
      3. Haz clic en Continuar.

    6. En la sección Entidades para buscar, selecciona todas las entidades que deseas buscar en la lista. Debes seleccionar al menos una entidad.

  7. Haz clic en Continuar.

  8. En la sección Configuración, haz lo siguiente:

    1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
    2. En el campo Nombre del conector de datos, ingresa un nombre para tu conector.
    3. Si seleccionaste US o EU como ubicación, establece los parámetros de configuración de encriptación:
      • Opcional: Si no configuraste claves de una sola región, haz clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulta Cómo registrar una clave de una sola región para conectores de terceros.
      • Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
      • Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
        • En la lista Tipo de administración de claves, selecciona el tipo adecuado.
        • En la lista Clave de Cloud KMS, selecciona la clave.
      Para obtener más información, consulta Claves de encriptación administradas por el cliente.

  9. Haz clic en Continuar.

  10. En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.

En la página Almacenes de datos, haz clic en el nombre del almacén de datos para ver el estado. Después de que el estado del almacén de datos cambie de Creando a Activo, el conector de Zendesk estará listo para usarse.

Después de crear el almacén de datos, crea una app, conéctala al almacén de datos de Zendesk y autoriza a Gemini Enterprise para que acceda a Zendesk antes de ejecutar cualquier búsqueda.

Para obtener información sobre los permisos necesarios para realizar búsquedas, consulta Permisos necesarios.

Control de datos y ejecución de consultas

En esta sección, se describe cómo Gemini Enterprise administra tu búsqueda y las implicaciones de privacidad del uso del almacén de datos federado.

Ejecución de las consultas

Después de autorizar Zendesk y enviar una búsqueda a Gemini Enterprise, ocurrirá lo siguiente:

  • Gemini Enterprise envía tu búsqueda directamente a la API de Zendesk.
  • Gemini Enterprise combina los resultados con los de otras fuentes de datos conectadas y muestra un resultado de búsqueda integral.

Manejo de datos

Cuando se usa la búsqueda federada de terceros, se aplican las siguientes reglas de tratamiento de datos:

  • Tu cadena de consulta se envía al backend de búsqueda de terceros (API de Zendesk).
  • Estos terceros pueden asociar las búsquedas con tu identidad.
  • Si hay varias fuentes de datos de búsqueda federada habilitadas, es posible que la consulta se envíe a todas ellas.
  • Una vez que los datos llegan al sistema de terceros, se rigen por las condiciones del servicio y las políticas de privacidad de ese sistema.

¿Qué sigue?