Conecta una fuente de datos de terceros

En esta página, se describe cómo conectar fuentes de datos de terceros a la Búsqueda de Vertex AI.

Cuando conectas una fuente de datos de terceros, Vertex AI Search crea un conector de datos y lo asocia con almacenes de datos (llamados almacenes de datos de entidad) para las entidades que especifiques. Los tipos de entidades son específicos de la fuente de datos a la que te conectas. Por ejemplo, las entidades de Jira Cloud incluyen problemas, archivos adjuntos, comentarios y registros de trabajo.

Las fuentes de datos de terceros solo están disponibles para las apps de búsqueda genéricas. Las apps de chat, recomendaciones y agentes no pueden usar fuentes de datos de terceros.

Los conectores de terceros no son compatibles con CMEK.

Para importar datos desde una fuente de datos de Google, consulta Cómo crear un almacén de datos de búsqueda.

Antes de comenzar

  1. Comunícate con tu equipo de Cuentas de Google y pídele que te agregue a la lista de entidades permitidas para los conectores de fuentes de datos de terceros.

  2. Ve a la sección de la fuente que planeas usar:

Cómo conectar Adobe Experience Manager

Usa el siguiente procedimiento para sincronizar datos de Adobe Experience Manager con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de Adobe Experience Manager debe generar o obtener lo siguiente para la integración con Vertex AI Search:

    • Credenciales de servicio de tu instancia de Adobe Experience Manager
    • Es la URL de la instancia de tu sitio de Adobe Experience Manager.

Crea un conector de Adobe Experience Manager

Console

Para usar la consola de Google Cloud y sincronizar datos de Adobe Experience Manager con la búsqueda de Vertex AI, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Seleccionar una fuente de datos, ve a la sección Fuentes de terceros y selecciona Adobe Experience Manager.

  5. Ingresa la información de autenticación de Adobe Experience Manager y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Cómo conectar AODocs

Usa el siguiente procedimiento para sincronizar datos de AODocs con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de AODocs debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    • ID de la instancia. Es la URL de dominio de tu instancia de AODocs.
    • ID de cliente
    • Secreto del cliente.

Crea un conector de AODocs

Console

Para usar la consola de Google Cloud y sincronizar datos de AODocs con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona AODocs.

  5. Ingresa tu información de autenticación de AODocs y haz clic en Autenticar. Aparecerá una ventana nueva.

  6. Autentica tu cuenta y confirma que se realizó correctamente antes de volver a la página Especifica la fuente de AODocs para tu almacén de datos.

  7. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  8. Selecciona una región para tu almacén de datos.

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Connect Box

Usa el siguiente procedimiento para sincronizar datos de Box con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Ten a mano la siguiente información de autenticación de Box. Para obtener información sobre la configuración de estos parámetros, consulta JWT Auth en la documentación para desarrolladores de Box.

    • ID de la empresa
    • ID de cliente
    • Secreto del cliente
    • ID de clave pública
    • Clave privada
    • Frase de contraseña

  • Cuando crees el extremo de JWT, configura los siguientes permisos:

Los cambios incrementales de los comentarios pueden tardar más en sincronizarse que el intervalo de frecuencia configurado. Si se copia o mueve una carpeta que contiene una entidad, los cambios incrementales pueden tardar más en sincronizarse que el intervalo de frecuencia configurado.

Crea la app de Box

  1. Accede a la Consola de desarrolladores de Box con tu cuenta de administrador.
  2. Haz clic en Crear app nueva.
  3. Selecciona el tipo App personalizada.
  4. Ingresa el Nombre de la app.
  5. Establece el propósito de la app: integración, IA o Google Cloud Agent Builder.
  6. Elige Autenticación del servidor con JWT.

Configura la app de Box

Configura la configuración de tu app de Box.

Crea clave pública/privada

  1. Ve a Box Developer Console.

  2. En la pestaña Configuración, haz clic en Generar un par de claves pública/privada.

    • La clave pública se sube automáticamente a la consola con un ID. Este ID se usa cuando se crea una conexión.
    • Se puede descargar de forma local un archivo de configuración con la clave privada y la frase de contraseña. Asegúrate de conservar este archivo de configuración para usarlo más adelante.
    • De manera opcional, para generar tu propia clave, consulta la guía de configuración del par de claves de Box.

Configura los permisos necesarios

  1. En la sección Alcances de la aplicación, selecciona el siguiente permiso:
    • Lee todos los archivos y carpetas almacenados en Box.

Autoriza la app

  1. En la pestaña Autorización, haz clic en Revisar y enviar y espera la aprobación de tu administrador.
  2. Los administradores pueden aprobar la app en la Consola del administrador.

Después de la autorización, Box configura completamente la app.

Crea un conector de Box

Console

Para usar la consola de Google Cloud y sincronizar datos de Box con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, desplázate o busca Box para conectar tu fuente de terceros.

  5. Ingresa tu información de autenticación.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu almacén de datos.

  9. Selecciona una frecuencia de sincronización para tu almacén de datos.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conecta Coda

Usa el siguiente procedimiento para sincronizar datos de Coda con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de Coda debe generar o obtener lo siguiente para la integración con Vertex AI Search:

    • Token de API de Coda

Crea un conector de Coda

Console

Para usar la consola de Google Cloud y sincronizar datos de Coda con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Coda.

  5. Ingresa tu información de autenticación de Coda y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta Confluence Cloud

Usa el siguiente procedimiento para sincronizar datos de Confluence Cloud con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Verifica que tienes acceso de administrador a la instancia y al proyecto de Confluence.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Configura la autenticación y los permisos en Confluence

Con las instrucciones de las siguientes secciones, asegúrate de tener los detalles de autenticación necesarios y el acceso de administrador a tu instancia de Confluence. Crea un ID de cliente y un secreto de cliente a través de la consola de Atlassian Developer, configura los alcances de OAuth 2.0 necesarios y configura los permisos para los usuarios. Recupera la URL y el ID de tu instancia, configura los roles y realiza la autenticación para sincronizar datos entre Confluence Cloud y Vertex AI Search.

- Instance ID. This is the `cloudid` and is available on
  <code>https://<var>EXAMPLE</var>.atlassian.net/_edge/tenant_info</code>
  and copying the value of `cloudId`.
  • Habilita OAuth 2.0 y obtén el ID de cliente y el secreto del cliente.
    • Ve a la API de Confluence.
    • Haz clic en Agregar.

    • Haz clic en Configurar.

      b. Ve a la pestaña Alcances detallados y haz clic en Editar alcances. Selecciona los siguientes permisos:

    Confirma que se hayan seleccionado 7 permisos y, luego, guarda los cambios.

  1. Haz clic en Distribución.

  2. Selecciona Editar y haz lo siguiente:

    • Selecciona Uso compartido para habilitar la edición de otros campos.
    • Completa los campos restantes.
    • Selecciona Sí cuando veas Does your app store personal data?.

  3. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

Cómo recuperar la URL y el ID de la instancia

Obtén la URL de la instancia:

  1. Ve a atlassian.net y accede con tu cuenta de administrador.
  2. Selecciona la app que quieras sincronizar. Por ejemplo, sincroniza la primera app.
  3. Busca la URL de la instancia, que es el subdominio en la barra de direcciones.

Obtén el ID de la instancia:

  1. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
  2. Navega al vínculo para encontrar el valor de cloudId. cloudId es el ID de tu instancia.

Configura permisos y roles

Para otorgarle al administrador de Confluence el rol de editor de Discovery Engine, haz lo siguiente:

  1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Cloud.
  2. Navega a IAM .
  3. Otorga al administrador de Confluence el rol de motor de descubrimiento. Esto permite que el administrador de Confluence configure el conector como se describe en Cómo crear un conector de Confluence Cloud.

Para otorgar el rol de administrador a un usuario, haz lo siguiente:

  1. Crea una cuenta de usuario dedicada.
  2. Asigna el rol de Administrador al usuario nuevo.
    • Usa esta cuenta para configurar el almacén de datos.

Para configurar los permisos en Atlassian, haz lo siguiente:

  1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Cloud.
  2. Haz clic en el ícono de menú y selecciona la opción requerida.
  3. (Opcional) Si se te solicita, selecciona la organización adecuada en la página de destino.

Para crear y configurar grupos, haz lo siguiente:

  1. En la página Administrador, haz clic en el botón Administrar usuarios (si es necesario).
    • Selecciona Administrar usuarios en la lista desplegable.
  2. En la página Administración de usuarios, selecciona Grupos.
  3. Haz clic en Crear grupo y asígnale un nombre.
    • Usa este grupo para asignar los permisos que requiere el conector.
  4. Agrega permisos al grupo: Asigna el rol de Administrador de acceso de usuarios.

Para asignar miembros del grupo, haz lo siguiente:

  1. En la página Grupo, haz clic en Agregar producto y selecciona el rol de producto adecuado:
    • Administrador de acceso de usuarios
  2. Haz clic en Agregar para confirmar la asignación de roles.
  3. Haz clic en Agregar miembros del grupo para incluir cuentas de usuario o miembros del grupo.
    • Asegúrate de que el conector se autentique en nombre de estos usuarios para recuperar documentos.

Para que los permisos de los usuarios se apliquen correctamente, cada usuario de Confluence Cloud debe hacer que su correo electrónico sea visible para todos los usuarios. Para ello, cambia la configuración de visibilidad de los correos electrónicos en Confluence Cloud y establece la visibilidad en Anyone. Para obtener más información, consulta Cómo configurar la visibilidad de tus correos electrónicos en la documentación de Atlassian.

Crea un conector de Confluence Cloud

Console

Para usar la consola de Google Cloud y sincronizar datos de Confluence Cloud con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

  3. Haz clic en Nuevo almacén de datos.

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Confluence.

  5. Ingresa tu información de autenticación y haz clic en Autenticar.

  6. Aparecerá una ventana nueva. Ingresa el nombre de usuario y la contraseña de la instancia. Verifica que la autenticación se haya realizado correctamente antes de volver a la página Especifica la fuente de Confluence de tu almacén de datos.

  7. Selecciona las entidades que deseas sincronizar y, luego, haz clic en Continuar.

  8. Selecciona una región para tu conector de datos.

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conecta Confluence Data Center local

Usa este procedimiento para crear un almacén de datos y una app de búsqueda de Confluence Data Center en Agent Builder y sincronizar los datos de Confluence locales con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

  • Conexión de servicio (obligatoria solo para el tipo de destino privado): Configura una conexión de servicio para realizar una transferencia de datos segura.
  • Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de Confluence.
  • URL del dominio (opcional para el tipo de destino privado): Especifica la URL de la instancia de Confluence Data Center.
  • Nombre de dominio base (opcional): Proporciona el nombre de dominio base para la instancia de Confluence.
  • Puerto de destino (opcional): Identifica el puerto que se usa para la comunicación con el centro de datos de Confluence.

Lineamientos de configuración para Private Service Connect

Usa los siguientes lineamientos de configuración para establecer conexiones con Private Service Connect(PSC). Ajusta o agrega recursos según sea necesario. Asegúrate de que el adjunto de servicio de PSC esté configurado correctamente para conectarse a la instancia privada y cumpla con los requisitos de un servicio publicado.

  • Configuración de red:

    a. Coloca el adjunto de servicio y el balanceador de cargas de PSC en subredes diferentes dentro de la misma red de nube privada virtual.

    b. El sistema de backend debe permanecer cerrado a la red pública por motivos de seguridad. Sin embargo, asegúrate de que pueda aceptar tráfico de las siguientes fuentes:

  • Reglas de firewall:

    a. Reglas de entrada:

    • Permite el tráfico de la subred de conexión del servicio de PSC a la subred del balanceador de cargas interno (ILB).
    • Asegúrate de que el ILB pueda enviar tráfico al backend.
    • Permite que los sondeos de verificación de estado lleguen al backend.

    b. Reglas de salida:

    • Habilita el tráfico de salida de forma predeterminada, a menos que se apliquen reglas de denegación específicas.

Consideraciones adicionales:

  • Asegúrate de mantener todos los componentes, incluido el adjunto de servicio y el balanceador de cargas de PSC, en la misma región.

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

  1. Decide el tipo de extremo: Selecciona un extremo público o privado.

  2. Para el extremo público: Si el tipo de destino del centro de datos de Confluence es público, no es necesario que crees la configuración para el adjunto de servicio. En su lugar, puedes usar tu URL pública en el campo URL del dominio de la consola de Google Cloud cuando crees el conector.

  3. Para el extremo Privado:

    a. Usa Private Service Connect (PSC) para habilitar conexiones desde instancias privadas a Google Cloud.

    b. Crea una red de nube privada virtual y las subredes necesarias.

    c. Crea una instancia de máquina virtual (VM) y, luego, instala el servicio de backend.

    d. (Opcional) Configura una sonda de verificación de estado para supervisar el estado del backend.

    e. Agrega un balanceador de cargas para enrutar el tráfico a la VM o al backend.

    f. Define reglas de firewall para permitir el tráfico entre el extremo de PSC y el backend.

    g. Para publicar el extremo, crea un adjunto de servicio de PSC.

Crea un usuario de Confluence Data Center y configura los permisos

Para permitir que Vertex AI Search obtenga datos de Confluence, debes crear un usuario nuevo con los permisos mínimos necesarios. Sigue estos pasos para crear el usuario y configurar los permisos necesarios.

Accede como administrador
  1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Data Center.
  2. Ingresa el nombre de usuario y la contraseña de administrador.
  3. Haz clic en Acceder.
Crear un usuario nuevo

Cuando creas un almacén de datos, debes crear un usuario para obtener datos de la instancia de terceros.

  1. Haz clic en el ícono de configuración.
  2. Selecciona Administración de usuarios.
  3. Si se te solicita, ingresa las credenciales de administrador.
  4. En la página Administración, haz clic en Crear usuario.
  5. Ingresa la dirección de correo electrónico, el nombre completo, el nombre de usuario y la contraseña.
  6. Haz clic en Crear usuario.
Cómo asignar un usuario a un grupo
  1. En la página Administración de Confluence, navega a la pestaña Usuarios y seguridad y haz clic en Grupos.
  2. Haz clic en Agregar grupo. Ingresa un nombre para el grupo y créalo.
  3. En el campo Buscar grupo, ingresa el nombre del grupo para encontrarlo.
  4. Haz clic en el ícono de configuración.
  5. Selecciona la cuenta de perfil y navega a Administración de usuarios.
  6. En la página Usuarios, en Lista de usuarios, busca el usuario recién creado en el campo Buscar usuario.
  7. Haz clic en el usuario para abrir la página Ver usuarios.
  8. Haz clic en Editar grupos para abrir la página Editar grupo de usuarios.
  9. Selecciona la casilla de verificación del grupo de usuarios creado.
  10. Haz clic en Guardar para asignar al usuario al grupo recién creado.

El usuario agregado se asigna en la sección Miembros del grupo.

Configura los permisos de los usuarios
  1. En la página Administración de Confluence, navega a la pestaña Problemas.
  2. Busca Permisos.
  3. Selecciona Ver permisos globales.
  4. Selecciona Editar permisos.
  5. En la página Editar permisos globales, busca el grupo asignado al usuario y habilita la opción Puede usar.

Configura el espacio de documentación

  1. Haz clic en el ícono de Confluence para navegar a la página Panel.
  2. Haz clic en Crear espacio.
  3. Selecciona Espacio de documentación y haz clic en Siguiente.
  4. Ingresa todos los detalles necesarios y haz clic en Crear para crear el espacio de documentación.
  5. En Mis espacios, haz clic en el espacio que acabas de crear.
  6. Navega a Páginas y abre el menú (tres puntos).
  7. Selecciona Restricciones.
  8. En el menú desplegable Restricciones, selecciona la opción Visualización y edición restringidas.
  9. Busca el grupo y asígnale el permiso puede ver.
  10. Haz clic en Aplicar. El usuario se crea con acceso mínimo y se establecen permisos para los espacios. También puedes asignar permisos a los blogs.

Configura un conector local de Confluence Data Center

Configura un conector de Confluence Data Center local para sincronizar datos con Google Cloud. Primero, crea un almacén de datos en Agent Builder y configura la configuración de la conexión, incluidas las preferencias de autenticación y sincronización.

Crea un conector de Confluence Data Center local

Console

Para usar la consola de Google Cloud y sincronizar datos de Confluence Cloud con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

  3. Haz clic en Nuevo almacén de datos.

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Confluence.

  5. Ingresa tu información de autenticación y haz clic en Autenticar.

  6. Aparecerá una ventana nueva. Ingresa el nombre de usuario y la contraseña de la instancia. Verifica que la autenticación se haya realizado correctamente antes de volver a la página Especifica la fuente de Confluence de tu almacén de datos.

  7. Selecciona las entidades que deseas sincronizar y, luego, haz clic en Continuar.

  8. Selecciona una región para tu conector de datos.

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Cómo conectar Dropbox

Usa el siguiente procedimiento para sincronizar datos de Dropbox con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Configura el control de acceso para tu fuente de datos. Para obtener más información, consulta Cómo usar el control de acceso a la fuente de datos.

  • Ten a mano la siguiente información de autenticación de Dropbox. Para obtener información sobre la configuración de estos parámetros, consulta la Guía de OAuth en la documentación de Dropbox.

    • ID de cliente
    • Secreto del cliente

Console

Para usar la consola de Google Cloud y sincronizar datos de Dropbox con la búsqueda de Vertex AI, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Dropbox.

  5. Ingresa tu información de autenticación de Dropbox y haz clic en Authenticate. Aparecerá una ventana nueva.

  6. Autentica tu cuenta y confirma que se realizó correctamente antes de volver a la página Especifica la fuente de Dropbox para tu almacén de datos.

  7. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  8. Selecciona una ubicación para tu almacén de datos.

  9. Ingresa un nombre para tu almacén de datos.

  10. Selecciona una frecuencia de sincronización para tu almacén de datos.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada. Revisa la pestaña Documentos para asegurarte de que tus entidades se hayan transferido correctamente.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conectar Dynamics 365

Usa el siguiente procedimiento para sincronizar datos de Dynamics 365 con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de crear un conector de Dynamics 365, haz lo siguiente:

  • Un administrador de Dynamics 365 debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    • ID de cliente
    • Secreto del cliente
    • Usuario de Azure
    • URL de la organización. Por ejemplo, https://abc123.cloudax.dynamics.com/.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Crea un conector de Dynamics 365

Console

Para usar la consola de Google Cloud y sincronizar datos de Dynamics 365 con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Dynamics 365.

  5. Ingresa la información de autenticación de Dynamics 365 y haz clic en Continuar.

  6. Ingresa la URL de tu organización y del inquilino de Azure, y haz clic en Continuar.

  7. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  8. Selecciona una región para tu almacén de datos.

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta GitHub

Usa el siguiente procedimiento para sincronizar datos de GitHub con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de GitHub debe obtener lo siguiente para realizar la integración con Vertex AI Search:

    • Token de acceso personal de la instancia de GitHub.

Crea un conector de GitHub

Console

Para usar la consola de Google Cloud y sincronizar datos de GitHub con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona GitHub.

  5. Ingresa tu información de autenticación de GitHub y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta GitLab

Usa el siguiente procedimiento para sincronizar datos de GitLab con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de GitLab debe obtener lo siguiente para realizar la integración con Vertex AI Search:

    • Token de acceso personal de la instancia de GitLab.

Crea un conector de GitLab

Console

Para usar la consola de Google Cloud y sincronizar datos de GitLab con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona GitLab.

  5. Ingresa tu información de autenticación de GitLab y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta Jira Cloud

Usa el siguiente procedimiento para sincronizar datos de Jira Cloud con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Verifica que tienes acceso de administrador a la instancia y al proyecto de Jira.
  • Configura el control de acceso. Asegúrate de que el control de acceso esté configurado correctamente para tu fuente de datos. Este paso garantiza que solo los usuarios autorizados puedan acceder a los datos y administrarlos. Para obtener más información, consulta la documentación sobre cómo usar el control de acceso a las fuentes de datos.
  • Para que los permisos de los usuarios se apliquen correctamente, los usuarios de Jira Cloud deben dar su consentimiento para compartir.
  • Asegúrate de tener una cuenta de Atlassian, una instancia de Jira y un proyecto.

Configura la autenticación y los permisos en Jira

Usa las instrucciones de las siguientes secciones para asegurarte de tener los detalles de autenticación necesarios y el acceso de administrador a tu instancia de Jira. Crea un ID de cliente y un secreto de cliente a través de la consola de Atlassian Developer, configura los alcances de OAuth 2.0 necesarios y configura los permisos para los usuarios. Recupera la URL y el ID de tu instancia, configura los roles y realiza la autenticación para sincronizar los datos entre Jira Cloud y Vertex AI Search.

Crea un ID de cliente y un secreto del cliente

Para habilitar OAuth 2.0 y obtener el ID y el secreto de cliente, consulta Apps de OAuth 2.0 (3LO) en la documentación de Atlassian Developer.

Para crear una integración de OAuth 2.0 en la consola de Atlassian Developer, haz lo siguiente:

  1. Accede a developer.atlassian.com.
  2. Haz clic en el ícono de perfil que se encuentra en la esquina superior derecha y selecciona Consola de Play Console.
  3. Haz clic en Crear y selecciona Integración de OAuth 2.0.

  4. Ingresa un nombre para la app.

    • Marca la casilla de verificación de los Términos y Condiciones.
    • Haz clic en Crear.
    • Haz clic en Autorización.
    • En la tabla Authorization type, selecciona Add para OAuth 2.0 (3LO).

  5. En el campo URL de devolución de llamada, ingresa https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.

  6. Haz clic en Guardar cambios.

Si ves la advertencia: Tu app no tiene ninguna API. Para agregar APIs a tu app, haz lo siguiente:

  1. Selecciona Permisos:

    • Ve a la API de Jira.
    • Haz clic en Agregar.
    • Haz clic en Configurar.
    • Ve a la pestaña Permisos clásicos y haz clic en Editar permisos. Selecciona los siguientes permisos:

    Confirma que estén seleccionados 8 permisos y, luego, guarda los cambios.

  2. Haz clic en Distribución.

  3. Selecciona Editar y haz lo siguiente:

    • Selecciona Uso compartido para habilitar la edición de otros campos.
    • Completa los campos restantes.
    • Selecciona Sí cuando veas Does your app store personal data?.

  4. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

Cómo recuperar la URL y el ID de la instancia

Obtén la URL de la instancia:

  1. Ve a atlassian.net y accede con tu cuenta de administrador.
  2. Selecciona la app que quieras sincronizar. Por ejemplo, sincroniza la primera app.
  3. Busca la URL de la instancia, que es el subdominio en la barra de direcciones.

Obtén el ID de la instancia:

  1. Abre una pestaña nueva, copia la URL de la instancia y agrega /_edge/tenant_info a la URL de la instancia. Por ejemplo, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
  2. Navega al vínculo para encontrar el valor de cloudId. cloudId es el ID de tu instancia.

Configura permisos y roles

  1. Accede a atlassian.com con tu cuenta de administrador.
  2. Haz clic en el ícono de menú en la parte superior izquierda o ve a admin.atlassian.com.
  3. En la página Administrador, haz clic en Administrar usuarios y ve a la página Grupos.
  4. Haz clic en Crear grupo. Ingresa un nombre para el grupo y créalo.
  5. Haz clic en Agregar producto.
  6. En el cuadro de diálogo Agregar productos al grupo, selecciona Administrador de acceso de usuarios como el rol del producto.
  7. Haz clic en Agregar.
  8. En la página Grupos, haz clic en Agregar miembros del grupo para agregar usuarios o cuentas que autentica el conector.

Para que los permisos de los usuarios se apliquen correctamente, cada usuario de Jira Cloud debe hacer que su correo electrónico sea visible para todos los usuarios. Para ello, cambia la configuración de visibilidad de los correos electrónicos en Confluence Cloud y establece la visibilidad en Anyone. Para obtener más información, consulta Cómo configurar la visibilidad de tus correos electrónicos en la documentación de Atlassian.

Crea un conector de Jira Cloud

Console

Para usar la consola de Google Cloud y sincronizar datos de Jira Cloud con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, desplázate o busca Jira para conectar tu fuente de terceros.

  5. Ingresa tu información de autenticación y haz clic en Autenticar.

  6. Ingresa el nombre de usuario y la contraseña de la instancia.

  7. Verifica que la autenticación se haya realizado correctamente antes de volver a la página Especifica la fuente de Jira para tu almacén de datos.

  8. Selecciona las entidades que deseas sincronizar y, luego, haz clic en Continuar.

  9. Selecciona una región para tu almacén de datos.

  10. Ingresa un nombre para tu almacén de datos.

  11. Selecciona una frecuencia de sincronización.

  12. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  13. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conecta Jira Data Center local

Usa este procedimiento para crear un almacén de datos y una app de búsqueda de Jira Data Center en Agent Builder y sincronizar los datos de Jira locales con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, puedes elegir la frecuencia con la que el almacén de datos se sincroniza con esa fuente.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

  • Conexión de servicio (obligatoria solo para el tipo de destino privado): Configura una conexión de servicio para realizar una transferencia de datos segura.
  • Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de Jira.
  • URL de dominio (opcional para el tipo de destino privado): Especifica la URL de la instancia de Jira Data Center.
  • Nombre de dominio base (opcional): Proporciona el nombre de dominio base de la instancia de Jira.
  • Puerto de destino (opcional): Identifica el puerto que se usa para la comunicación con Jira Data Center.

Lineamientos de configuración para Private Service Connect

Usa los siguientes lineamientos de configuración para establecer conexiones con Private Service Connect(PSC). Ajusta o agrega recursos según sea necesario. Asegúrate de que el adjunto de servicio de PSC esté configurado correctamente para conectarse a la instancia privada y cumpla con los requisitos de un servicio publicado.

  • Configuración de red:

    a. Coloca el adjunto de servicio y el balanceador de cargas de PSC en subredes diferentes dentro de la misma red de nube privada virtual.

    b. El sistema de backend debe permanecer cerrado a la red pública por motivos de seguridad. Sin embargo, asegúrate de que pueda aceptar tráfico de las siguientes fuentes:

  • Reglas de firewall:

    a. Reglas de entrada:

    • Permite el tráfico de la subred de conexión del servicio de PSC a la subred del balanceador de cargas interno (ILB).
    • Asegúrate de que el ILB pueda enviar tráfico al backend.
    • Permite que los sondeos de verificación de estado lleguen al backend.

    b. Reglas de salida:

    • Habilita el tráfico de salida de forma predeterminada, a menos que se apliquen reglas de denegación específicas.

Consideraciones adicionales:

  • Asegúrate de mantener todos los componentes, incluido el adjunto de servicio y el balanceador de cargas de PSC, en la misma región.

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

  1. Decide el tipo de extremo: Selecciona un extremo público o privado.

  2. Para el extremo público: Si el tipo de destino del centro de datos de Jira es público, no es necesario que crees la configuración para el archivo adjunto de servicio. En su lugar, puedes usar tu URL pública en el campo URL del dominio de la consola de Google Cloud .

  3. Para el extremo Privado:

    a. Usa PSC para habilitar conexiones desde instancias privadas a Google Cloud.

    b. Crea una red de nube privada virtual y las subredes necesarias.

    c. Crea una instancia de máquina virtual (VM) y, luego, instala el servicio de backend.

    d. (Opcional) Configura una sonda de verificación de estado para supervisar el estado del backend.

    e. Agrega un balanceador de cargas para enrutar el tráfico a la VM o al backend.

    f. Define reglas de firewall para permitir el tráfico entre el extremo de PSC y el backend.

    g. Para publicar el extremo, crea un adjunto de servicio de PSC.

Crea un usuario de Jira Data Center y configura los permisos

Para permitir que Vertex AI Search obtenga datos de Jira, debes crear un usuario nuevo con los permisos mínimos necesarios. Sigue estos pasos para crear el usuario y configurar los permisos necesarios.

Accede como administrador
  1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Jira Data Center.
  2. Ingresa el nombre de usuario y la contraseña de administrador.
  3. Haz clic en Acceder.
Crear un usuario nuevo

Cuando creas un almacén de datos, debes crear un usuario para obtener datos de la instancia de terceros.

  1. Haz clic en el ícono de configuración.
  2. Selecciona Administración de usuarios.
  3. Si se te solicita, ingresa las credenciales de administrador.
  4. En la página Administración, haz clic en Crear usuario.
  5. Ingresa la dirección de correo electrónico, el nombre completo, el nombre de usuario y la contraseña.
  6. Haz clic en Crear usuario.
Cómo asignar un usuario a un grupo
  1. En la página Administración, en Administración de usuarios, haz clic en Grupos.
  2. Para crear un grupo, ingresa un nombre y haz clic en Agregar grupo.
  3. Selecciona el grupo recién creado.
  4. Haz clic en Agregar/quitar usuarios.
  5. Haz clic en el ícono de miembro que se encuentra junto al cuadro Agregar miembros a los grupos seleccionados.
  6. Selecciona el usuario que acabas de crear y haz clic en Guardar la selección.
  7. Haz clic en Agregar usuario seleccionado para ver a los usuarios nuevos en la sección de miembros del grupo.

Puedes ver que el usuario agregado se asignó en la sección Miembros del grupo.

Configura los permisos de los usuarios
  1. En la página Administración, navega a la pestaña Problemas.
  2. Selecciona Esquemas de permisos.
  3. Haz clic en Agregar esquema de permisos.
  4. Ingresa un nombre para el esquema y haz clic en Agregar.
  5. Selecciona el esquema y haz clic en el ícono de Permiso.
  6. Haz clic en Otorgar permiso.
  7. Agrega los siguientes permisos, asígnales al grupo creado anteriormente y haz clic en Otorgar:
    • Explorar proyectos
    • Explora el archivo de proyectos.

Puedes agregar este esquema a los proyectos en los que los usuarios de ese grupo necesiten acceso para ver ese proyecto y los problemas, comentarios, registros de trabajo y archivos adjuntos en él.

Configura el acceso de las aplicaciones

  1. En la página Administración, navega a la pestaña Aplicaciones.
  2. En la pestaña Aplicaciones, selecciona Acceso a la aplicación.
  3. Busca el grupo creado y selecciónalo.
  4. Verifica que el grupo aparezca en la lista de acceso.

El usuario se crea con acceso mínimo. Este esquema se agrega a los proyectos. El administrador de Jira puede agregar más miembros a ese grupo o usuarios a ese proyecto.

Configura un conector de Jira Data Center local

Configura un conector de Jira Data Center local para sincronizar datos con Google Cloud. Primero, crea un almacén de datos en Agent Builder y configura la configuración de la conexión, incluidas las preferencias de autenticación y sincronización.

Crea un conector de Jira Data Center local

Console

Para usar la consola de Google Cloud y sincronizar datos de Jira Cloud con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, desplázate o busca Jira para conectar tu fuente de terceros.

  5. Ingresa tu información de autenticación y haz clic en Autenticar.

  6. Ingresa el nombre de usuario y la contraseña de la instancia.

  7. Verifica que la autenticación se haya realizado correctamente antes de volver a la página Especifica la fuente de Jira para tu almacén de datos.

  8. Selecciona las entidades que deseas sincronizar y, luego, haz clic en Continuar.

  9. Selecciona una región para tu almacén de datos.

  10. Ingresa un nombre para tu almacén de datos.

  11. Selecciona una frecuencia de sincronización.

  12. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  13. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Cómo conectar Microsoft Outlook

Usa el siguiente procedimiento para sincronizar datos de Microsoft Outlook con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de Microsoft Outlook debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    • ID de cliente
    • Secreto del cliente.
    • ID de usuario.

Crea un conector de Microsoft Outlook

Console

Para usar la consola de Google Cloud y sincronizar datos de Microsoft Outlook con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Microsoft Outlook.

  5. Ingresa la información de autenticación de Microsoft Outlook y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Cómo conectar Microsoft Teams

Usa el siguiente procedimiento para sincronizar datos de Microsoft Teams con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de Microsoft Teams debe generar o obtener lo siguiente para la integración con Vertex AI Search:

    • ID de cliente
    • Secreto del cliente.
    • ID de usuario.

Crea un conector de Microsoft Teams

Console

Para usar la consola de Google Cloud y sincronizar datos de Microsoft Teams con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Microsoft Teams.

  5. Ingresa tu información de autenticación de Microsoft Teams y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Cómo conectar Notion

Usa el siguiente procedimiento para sincronizar datos de Notion con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar el conector, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con tu equipo de cuentas de Vertex AI Search.

  • Un administrador de Notion debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    • Es el token de API de la instancia de Notion.
    • ID del lugar de trabajo.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Crea un conector de Notion

Console

Para usar la consola de Google Cloud y sincronizar datos de Notion con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Notion.

  5. Ingresa tu información de autenticación de Notion y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Cómo conectar OneDrive

Usa el siguiente procedimiento para sincronizar datos de OneDrive con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

Console

Para usar la consola de Google Cloud y sincronizar datos de OneDrive con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Seleccionar fuente de datos, ve a la sección Fuentes de terceros y selecciona OneDrive.

  5. Ingresa tu información de autenticación de OneDrive.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu almacén de datos.

  9. Selecciona una frecuencia de sincronización para tu almacén de datos.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conecta Salesforce

Usa el siguiente procedimiento para sincronizar datos de Salesforce con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

Se aplica la siguiente limitación:

Crea un conector de Salesforce

Console

Para usar la consola de Google Cloud y sincronizar datos de Salesforce con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Seleccionar una fuente de datos, desplázate o busca Salesforce para conectar tu fuente de terceros.

  5. Ingresa tu información de autenticación de Salesforce.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu almacén de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Conecta ServiceNow

Usa el siguiente procedimiento para sincronizar datos de ServiceNow con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, asegúrate de tener lo siguiente:

  • Instancia de ServiceNow: Sigue las instrucciones de la documentación de ServiceNow Developer para crear una instancia de ServiceNow.

  • Proyecto de Google Cloud : Configura un proyecto de Google Cloud con una cuenta de administrador capaz de administrar configuraciones a nivel de la organización, lo que garantiza que la organización pueda configurar un grupo de personal.

  • Grupo de trabajadores: Asegúrate de que tu organización esté configurada para administrar un grupo de trabajadores.

Configura ServiceNow

ServiceNow ofrece dos sitios principales:

  1. Sitio principal de ServiceNow: Es el sitio de tu instancia de ServiceNow.

    • Administra usuarios, grupos y tareas de administración del sistema.
    • URL: Es la URL de tu instancia de ServiceNow.
    • Accede con tus credenciales de administrador.

  2. Sitio para desarrolladores:

    • Configura la base de conocimiento, los flujos de trabajo y el desarrollo de aplicaciones personalizadas.
    • URL: https://developer.service-now.com.
    • Accede con tu ID de ServiceNow.

Crea un extremo de OAuth

  1. Accede a la instancia principal de ServiceNow con privilegios de administrador.
  2. Navega a Todo > OAuth del sistema > Registro de aplicaciones.
  3. Haz clic en Nuevo y, luego, selecciona Crear un extremo de API de OAuth para clientes externos. Recupera el ID de cliente y el secreto del cliente.

  4. Completa la información requerida:

    • Nombre: Es un nombre único.
    • URL de redireccionamiento: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

  5. Haz clic en Enviar para crear la credencial.

  6. Después de enviarlo, haz clic en el nombre para ver el secreto del cliente.

  7. El secreto se enmascara. Haz clic en el ícono de bloqueo que se encuentra junto a él para desenmascarar y ver el secreto.

  8. Conserva una copia del ID de cliente y el secreto para usarlos cuando sea necesario.

  9. Ve a developer.service-now.com y haz clic en Administrar la contraseña de la instancia.

  10. Conserva una copia del nombre de usuario y la contraseña para usarla cuando sea necesario.

  11. En esta etapa, están disponibles los cinco datos necesarios para configurar un almacén de datos de ServiceNow. Si no tienes problemas con el uso del rol de administrador para extraer datos, continúa con la creación de un almacén de datos.

Configura roles y permisos

Debes tener el rol de administrador de seguridad para crear y administrar usuarios. Si no tienes este rol, haz lo siguiente:

  1. Para elevar tu rol a security_admin, haz clic en Elevar rol en tu perfil.

  2. Selecciona el rol security_admin y haz clic en Actualizar. Se requiere el rol security_admin para crear roles y administrar usuarios.

Crea un rol personalizado con reglas de ACL
  1. Navega a Todo > Administración de usuarios > Roles.
  2. Haz clic en Nuevo para crear un rol nuevo.
  3. Selecciona un nombre y haz clic en Enviar.
  4. Navega a Seguridad del sistema > Control de acceso (LCA) para crear una nueva regla de LCA.
  5. Haz clic en Nueva para crear una regla de ACL nueva.
  6. Selecciona un rol, como sys_user_role.
  7. Haz clic en Enviar y asigna el rol.

  8. Repite este proceso hasta que se otorgue todo el acceso a la tabla. El conector requiere acceso a las siguientes tablas para que cada entidad se ejecute correctamente:

    • Incidente: incident.
    • Elemento del catálogo: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom y sc_cat_item_user_no_mtom.
    • Conocimiento: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
    • Adjunto: Todos los elementos de la lista.
    • Identidad: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember y sys_user
    • Se actualizan a medida que se extraen nuevos criterios: core_company, cmn_location y cmn_department.
    • Criterios de usuario: user_criteria.

  9. Para verificar que todas las ACL estén actualizadas, navega a sys_security_acl_role_list.do en la barra de búsqueda.

  10. Selecciona el rol que deseas verificar.

  11. Confirma que todas las ACL requeridas estén asignadas al rol seleccionado.

Otorga el rol a una cuenta de servicio

  1. Ve a Todo > Administración de usuarios > Usuarios y selecciona el usuario.
  2. Busca al usuario al que quieres otorgarle el rol y selecciónalo.
  3. Si no hay ningún usuario disponible, navega a Seguridad del sistema > Usuarios y grupos > Usuarios.
  4. Haz clic en Nuevo para crear una cuenta de servicio nueva en la tabla Usuario.
  5. Asegúrate de marcar la casilla de verificación Solo acceso al servicio web.
  6. Ve a la tabla Roles en la parte inferior de la página.
  7. Haz clic en Editar a la derecha.
  8. Otorga el rol creado anteriormente y asígnale al usuario. Según el tipo de rol creado, selecciona el adecuado y asígnale el rol.
  9. Obtén el nombre de usuario y la contraseña del usuario. En la misma página, haz clic en Configurar contraseña.

  10. Generar una contraseña automáticamente y guardarla para usarla más adelante:

    • ID de usuario: manager.
    • Contraseña: Ingresa la contraseña generada automáticamente.

Configura el grupo de trabajadores

Sigue las instrucciones para configurar un grupo de personal con una de las siguientes configuraciones:

Crea un conector de ServiceNow

Console

Para usar la consola de Google Cloud y sincronizar datos de ServiceNow con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona ServiceNow.

  5. Ingresa tu información de autenticación de ServiceNow.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu conector de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu conector de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Cómo conectar SharePoint Online

Usa el siguiente procedimiento para sincronizar datos de SharePoint Online con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Otorga el consentimiento del administrador. Para obtener información sobre cómo otorgar consentimiento, consulta Otorga consentimiento de administrador en todo el inquilino a una aplicación en la documentación de Microsoft.

  • Prepara la siguiente información de autenticación de Sharepoint Online para usarla durante la configuración:

    • URL de la instancia. En el formato http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

    • La autenticación federada requiere el ID de inquilino y el ID de cliente, mientras que OAuth requiere el ID de inquilino, el ID de cliente y el secreto del cliente. Para registrar la aplicación, selecciona Cuentas solo en este directorio de la organización para el público de acceso y, luego, busca esta información de autenticación. Para obtener más información, consulta la Guía de inicio rápido: Registra una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft.

    • Cuando registres la aplicación, usa https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html como la URL de devolución de llamada web.

    • Cuando configures los permisos de la aplicación, agrega los siguientes permisos de la API de Graph:

    • Cuando configures los permisos de la aplicación, agrega los siguientes permisos delegados para la API de REST de Sharepoint:

  • En la siguiente tabla, se describen los roles que se recomiendan para la configuración y sus limitaciones.

Use this method for granular control over SharePoint REST API permissions, allowing you to restrict resource access on the user account. Make sure to create a new SharePoint user, which might add licensing costs. Use the [OAuth 2.0 refresh token](#oauth-2.0-refresh-token) method to set up an Entra application registration and enable secure access to SharePoint.

Configura el registro de la aplicación de Entra

Configura un registro de la aplicación de Entra para habilitar el acceso seguro a SharePoint. Elige entre credenciales federadas para el acceso basado en tokens o token de actualización de OAuth 2.0 para el control detallado. Sigue estos pasos para configurar el registro de la app, otorgar permisos y establecer la autenticación.

Credenciales federadas

Configura credenciales federadas para permitir que Google acceda de forma segura a SharePoint con tokens firmados criptográficamente, lo que evita la necesidad de un principal de usuario real. Para configurar permisos y otorgar acceso, haz lo siguiente:

  1. Obtén el ID de cliente de la cuenta de servicio:

    a. En la consola de Google Cloud , ve a la página Agent Builder.

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

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

    d. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona SharePoint Online.

    e. Anota el identificador de asunto.

  2. Registra la app en Microsoft Entra:

    a. Navega a Entra admin center.

    b. Crea un registro de app:

    • Tipos de cuentas admitidos: Solo cuentas en el directorio de la organización.
    • Mantén los demás parámetros de configuración predeterminados y haz clic en Registrar.

    c. Anota el ID de cliente y el ID de inquilino.

  3. Agrega credenciales federadas:

    a. Ve a Certificados y secretos > Credenciales federadas > Agregar credencial.

    b. Usa la siguiente configuración:

    • Empresa emisora: https://accounts.google.com
    • Identificador de asunto: Usa el identificador de asunto que se indicó.
    • Nombre: Proporciona un nombre único.

    c. Haz clic en Agregar para otorgar acceso.

  4. Establece permisos de API:

    a. Agrega y otorga el consentimiento del administrador para los siguientes permisos:

    • API de Graph:

      • GroupMember.Read.All (aplicación): Lee todas las pertenencias a grupos.
      • Sites.Read.All (aplicación): Lee todos los sitios.
      • User.Read.All (aplicación): Lee los perfiles completos de todos los usuarios.

    • API de SharePoint:

      • Sites.FullControl.All (aplicación): Control total sobre todos los sitios.

    b. Usa Sites.Selected para asignar permisos de sitio específicos en lugar de Sites.FullControl.All. Sites.Selected no se puede configurar directamente a través de la IU. Después de seleccionar Sites.Selected, debes llamar a la API de Microsoft Graph para otorgar explícitamente el rol de control total a la aplicación para los sitios que deseas rastrear.

    c. Otorga Sites.Read.All para rastrear todos los subsitios de una URL de sitio raíz.

Token de actualización de OAuth 2.0

Configura la autenticación de OAuth 2.0 con un secreto del cliente y un token de actualización del usuario de SharePoint para habilitar el control detallado sobre el acceso a la API de SharePoint. Para configurar el registro de apps, agregar un secreto del cliente y asignar permisos de API, haz lo siguiente:

  1. Crea el registro de la app:

    a. Navega a Entra admin center.

    b. Crea un registro de app:

    • Tipos de cuentas admitidos: Solo cuentas en el directorio de la organización.
    • URI de redireccionamiento: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

    c. Anota el ID de cliente y el ID de inquilino.

  2. Agrega el secreto del cliente:

    a. Ve a Certificados y secretos > Nuevo secreto de cliente.

    b. Anota la cadena secreta.

  3. Establece permisos de API:

    a. Agrega y otorga el consentimiento del administrador para los siguientes permisos:

    • API de Graph (aplicación):

      • GroupMember.Read.All: Lee todas las pertenencias a grupos.
      • Sites.FullControl.All: Control total de todas las colecciones de sitios.
      • User.Read.All: Lee los perfiles completos de todos los usuarios.

    • API de REST de SharePoint (delegada):

      • AllSites.FullControl: Control total sobre todos los sitios.

    b. Usa una cuenta de usuario dedicada con acceso limitado a sitios específicos.

    c. Asegúrate de que la cuenta tenga acceso de propietario a los sitios seleccionados.

Crea un conector de SharePoint Online

Para configurar un motor de búsqueda, selecciona SharePoint como la fuente de datos y configura el método de autenticación adecuado. Elige entre credenciales federadas para el acceso basado en tokens o el token de actualización de OAuth 2.0 para obtener un control más detallado y, luego, proporciona la URL del sitio y los detalles de registro de la app necesarios para completar el proceso.

Console

Para usar la consola de Google Cloud y sincronizar datos de Sharepoint Online con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Sharepoint Online.

  5. Ingresa tu información de autenticación de SharePoint Online y haz clic en Autenticar.

  6. Ingresa la URL del sitio de SharePoint:

    • Para un solo sitio: https://<domain_name>.sharepoint.com/sites/<site_name>.
    • Para todos los sitios de primer nivel: https://<domain_name>.sharepoint.com.

  7. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  8. Selecciona una región para tu almacén de datos.

  9. Ingresa un nombre para tu almacén de datos.

  10. Selecciona una frecuencia de sincronización para tu almacén de datos.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Prueba el motor de búsqueda

Después de configurar tu motor de búsqueda, prueba sus capacidades. Esto garantiza que se muestren resultados precisos según el acceso del usuario.

  1. Habilita la app web:

    a. Ve a la configuración de integración de la app y activa la opción para habilitar la app web.

  2. Prueba la app web:

    a. Haz clic en Abrir junto al vínculo de la app web y accede con un usuario de tu grupo de personal.

    b. Verifica que los resultados de la búsqueda se restrinjan a los elementos a los que el usuario que accedió puede acceder.

Configura el grupo de trabajadores

El grupo de personal te permite administrar y autenticar usuarios de proveedores de identidad externos, como Azure o Okta, en la consola de Google Cloud . Para configurar tu grupo de personal y habilitar la app web para que los usuarios accedan sin inconvenientes, haz lo siguiente:

  1. Crea un grupo de personal

    a. Sigue el manual de configuración correspondiente para crear un grupo de trabajadores a nivel de la organización en Google Cloud :

    b. Configura el grupo de trabajadores en Agent Builder > Configuración para la región en la que creas tu app.

Próximos pasos

Conectar Slack

Usa el siguiente procedimiento para sincronizar datos de Slack con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Comunícate con el propietario de Workspace para que te proporcione los permisos necesarios para instalar apps nuevas en tu espacio de trabajo.

  • Prepara la siguiente información de autenticación de Slack:

Se aplica la siguiente limitación:

  • El comportamiento predeterminado de Slack restringe el rastreo y la sincronización de contenido de los canales privados, los mensajes instantáneos de varias partes y los mensajes instantáneos 1:1.

Console

Para usar la consola de Google Cloud y sincronizar datos de Slack con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, desplázate o busca Slack para conectar tu fuente de terceros.

  5. Ingresa tu información de autenticación de Slack.

    • ID de instancia (ID de espacio de trabajo): Accede a tu espacio de trabajo de Slack a través de un navegador para obtenerlo. El ID del lugar de trabajo es el segmento que aparece después de /client en la URL.
    • Token de autenticación: Usa el token que obtuviste en la sección anterior.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu almacén de datos.

  9. Selecciona una frecuencia de sincronización para tu almacén de datos.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre de tu almacén de datos para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar los datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar minutos o horas.

Próximos pasos

Cómo conectar Trello

Usa el siguiente procedimiento para sincronizar datos de Trello con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar el conector, asegúrate de completar los siguientes pasos:

  • Verifica que tienes acceso de administrador a Trello. Un administrador de Trello debe generar una clave y un token de API en la siguiente sección.
  • Verifica que tu proyecto se haya agregado a la lista de entidades permitidas para usar Trello.
  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Genera una clave de API y un token en Trello

Un administrador de Trello debe realizar los siguientes pasos:

  1. Crea una función de Trello para generar una clave de API.
  2. Ve a la página Administrador de Trello.
  3. Navega a la pestaña Clave de API y selecciona la opción para generar una clave de API nueva.
  4. Haz clic en Token.
  5. Haz clic en Permitir.
  6. Copia el token.

Para obtener más información sobre la API de Trello, consulta Introducción a la API.

Crea un conector de Trello

Console

Para usar la consola de Google Cloud y sincronizar datos de Trello con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Trello.

  5. Ingresa tu información de autenticación de Trello y haz clic en Continuar.

  6. Opcional: Para enrutar el tráfico HTTP, haz clic en Agregar destino y, luego, ingresa el nombre de host o la dirección IP del servidor proxy. Luego, haz clic en Continuar.

  7. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  8. Selecciona una región para tu almacén de datos.

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

  11. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  12. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta Workday

Usa el siguiente procedimiento para sincronizar datos de Workday con la búsqueda de Vertex AI.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de crear un conector de Workday, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con tu equipo de cuentas de Vertex AI Search.

  • Un administrador de Workday debe generar o obtener lo siguiente para realizar la integración con Vertex AI Search:

    • ID de cliente Obtén la información en la página Ver clientes de API en Workday.
    • Secreto del cliente. Obtén la información en la página Ver clientes de API en Workday.
    • Token de actualización Obtén la información en la página Ver clientes de API en Workday.
    • Servidor proxy (opcional) El nombre de host o la dirección IP de un proxy para enrutar el tráfico HTTP
    • URL base (opcional). La URL base de la conexión de Workday.
    • URL de la API (opcional). La URL completa del extremo de API que se usará para realizar solicitudes de SOAP. Por ejemplo: https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
    • Usuario de Workday Es el usuario de la cuenta. Por ejemplo, abc_cms1. Puedes obtener el nombre del inquilino en los detalles de configuración de tu instancia de Workday.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

Crea un conector de Workday

Console

Para usar la consola de Google Cloud y sincronizar datos de Workday con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Seleccionar fuente de datos, ve a la sección Fuentes de terceros y selecciona Workday.

  5. Ingresa tu información de autenticación de Workday y haz clic en Continuar.

  6. Opcional: Ingresa la información de destino de Workday y haz clic en Continuar.

  7. Ingresa tu inquilino de Workday y haz clic en Continuar.

  8. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  9. Selecciona una región para tu almacén de datos.

  10. Ingresa un nombre para tu conector de datos.

  11. Selecciona una frecuencia de sincronización.

  12. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  13. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos

Conecta Zendesk

Usa el siguiente procedimiento para sincronizar datos de Zendesk con Vertex AI Search.

Después de configurar tu fuente de datos y de importar datos por primera vez, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

Antes de comenzar

Antes de configurar la conexión, haz lo siguiente:

  • Además de la lista de entidades permitidas del conector de terceros, este conector requiere que tu proyecto se agregue a una lista de entidades permitidas adicional. Para que se te agregue a esta lista de entidades permitidas, comunícate con el equipo de tu cuenta de Vertex AI Search.

  • Configura el control de acceso para tu fuente de datos. Para obtener información sobre cómo configurar el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.

  • Un administrador de Zendesk debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    • Token de acceso Token de API de tu instancia de Zendesk
    • Es el URI de la instancia.

Crea un conector de Zendesk

Console

Para usar la consola de Google Cloud y sincronizar datos de Zendesk con Vertex AI Search, sigue estos pasos:

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

    Agent Builder

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

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

  4. En la página Selecciona una fuente de datos, ve a la sección Fuentes de terceros y selecciona Zendesk.

  5. Ingresa la información de autenticación de Zendesk y haz clic en Continuar.

  6. Selecciona las entidades que deseas sincronizar y haz clic en Continuar.

  7. Selecciona una región para tu almacén de datos.

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

  10. Haz clic en Crear. Vertex AI Search crea tu almacén de datos y lo muestra en la página Almacenes de datos.

  11. Para verificar el estado de la transferencia, ve a la página Almacenes de datos y haz clic en el nombre del conector para ver los detalles en la página Datos. El estado del conector cambia de Creando a Ejecutando cuando comienza a sincronizar datos. Cuando se completa la transferencia, el estado cambia a Activo para indicar que la conexión a tu fuente de datos está configurada y a la espera de la próxima sincronización programada.

    Según el tamaño de tus datos, la transferencia puede tardar varios minutos o varias horas.

Próximos pasos