Conecta una fuente de datos de terceros

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

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 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, 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 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 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 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

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 nueva app.
  3. Selecciona el tipo de 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 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

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 los 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

Cómo conectar 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 archivo adjunto del 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 de PSC y el balanceador de cargas, 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 archivo adjunto de servicio. En su lugar, puedes usar tu URL pública en el campo URL de 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.

Crea un conector de Confluence Data Center local

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 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 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

Cómo 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 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 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 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

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 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

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 Alcances clásicos y haz clic en Editar alcances. 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 archivo adjunto del 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 de PSC y el balanceador de cargas, 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 el 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.

Crea un conector de Jira Data Center local

Configura un conector local de Jira Data Center 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 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

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 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 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 el equipo de tu cuenta 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 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 OneDrive

Usa el siguiente procedimiento para sincronizar datos de OneDrive 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:

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:

  • 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. Si quieres obtener información para configurar el ID y el secreto del cliente en Salesforce, consulta Configura una app conectada para el flujo de credenciales de cliente de OAuth 2.0 en la documentación de Salesforce.

    • URL de la instancia: Es el nombre de dominio de tu instancia de Salesforce. Busca Mi dominio, copia el dominio que termina en my.salesforce.com y agrega https:// al principio.
    • ID de cliente: Para copiar el ID de cliente de la app conectada, haz clic en Administrar detalles del cliente. Si el token de actualización está habilitado, verifica que se haya actualizado y proporciona el token más reciente cuando crees un almacén de datos.
    • Secreto de cliente: Haz clic en Administrar detalles del cliente para copiar el secreto del cliente de la app conectada. Si el token de actualización está habilitado, verifica que se haya actualizado y proporciona el token más reciente cuando crees un almacén de datos.

  • Para que los permisos de los usuarios se apliquen correctamente, los usuarios de Salesforce deben proporcionar su consentimiento para compartir.

  • Usa un plan empresarial o para desarrolladores. No se admiten cuentas de prueba.

  • Asegúrate de usar Sales Cloud. No se admite Service Cloud.

  • Agrega Google Cloud a la lista de entidades permitidas de CORS de Salesforce. Si ya completaste esta tarea, ve a la sección Crear una app.

Crea una app

Salesforce admite las siguientes apps:

  1. App conectada:
  2. App cliente externa:

Crea una app conectada

Para configurar una app conectada en Salesforce para la integración con Google Cloud, haz lo siguiente:

  1. Accede a Salesforce.
  2. Haz clic en el ícono de ajustes y navega a Configuración.
  3. En el menú Configuración, navega a Administrador de aplicaciones.
  4. Haz clic en Nueva app conectada.

  5. Para configurar la app conectada, sigue estos pasos:

    a. En la página de creación de apps conectadas, haz lo siguiente:

    • Marca Habilitar configuración de OAuth.
    • Establece la URL de devolución de llamada en https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
    • Selecciona los siguientes permisos de OAuth:
      • Acceso completo (full):
      • Realizar solicitudes en cualquier momento (refresh_token, offline_access)

    b. Habilita los flujos:

    • Flujo de credenciales de cliente.
    • Flujo de código de autorización y credenciales.
    • Credenciales del usuario en el cuerpo de POST para el código de autorización y el flujo de credenciales
    • Para el flujo de credenciales de cliente, asigna tu nombre de usuario en el campo Ejecutar como. Debes tener permisos de lectura para todas las entidades que puede extraer tu conector.

Después de crear la app conectada, haz lo siguiente:

  1. Edita las políticas de la app:

    • Ve a Administrador de apps y edita la app recién creada.
    • Establece Relajación de IP en Relax IP restrictions.
    • Configura la política de tokens de actualización en Valid until revoked o en una configuración más restrictiva según sea necesario.
    • Asegúrate de que Usuarios permitidos esté configurado en All users may self-authorize.

  2. Configura restricciones de IP:

    • Si la aplicación forzosa de rangos de IP a nivel de la organización está habilitada, establece Rangos de IP de confianza en Seguridad > Acceso a la red. Para obtener más información, consulta la documentación sobre Aplicación de IP continua y relajación de IP de apps conectadas.
    • Inhabilita Aplicar rangos de IP de acceso en cada solicitud si no se requieren restricciones de IP.

  3. Configura una app conectada de OAuth:

  4. Guarda la app conectada:

    • Guarda y sal de la app conectada.
    • En la barra de búsqueda, busca Configuración de conexión de OAuth y OpenID.
    • Habilita Permitir flujos de código de autorización y credenciales y Flujos de nombre de usuario y contraseña de OAuth.

Crea una app cliente externa

Para crear y configurar una app de cliente externa en Salesforce y habilitar la autenticación basada en OAuth para las integraciones, haz lo siguiente:

  1. Obtén el ID de cliente y el secreto del cliente:

    • Accede a Salesforce.
    • Haz clic en el ícono de ajustes y ve a Configuración.
    • Navega a Configuración > Apps > Apps de cliente externas.
    • Haz clic en Nueva app de cliente externa.

  2. Proporciona la información requerida:

    • Ingresa el nombre de la app y tu dirección de correo electrónico. El nombre de la API se completa automáticamente de forma predeterminada.
    • Deja el Estado de distribución como Local.

  3. Habilita la configuración de OAuth:

    • Expande API (Enable OAuth Settings) y selecciona Enable OAuth.
    • Configurar:
      • URL de devolución de llamada: https://login.salesforce.com/services/oauth2/callback
      • Permisos de OAuth: Administra los datos del usuario a través de las APIs (api).
      • En Habilitación de flujos, selecciona Habilitar flujo de credenciales de cliente.
      • Haz clic en Crear para crear la app de cliente externa. Ve al administrador de app de cliente externa para ver la app que agregaste a la lista.

  4. Edita las políticas de la app:

    • Abre la app creada.
    • Ve a Políticas y haz clic en Editar.
    • En Flujos de OAuth y mejoras de apps de cliente externas, marca Habilitar flujo de credenciales de cliente.
    • Ingresa tu nombre de usuario de Salesforce en el campo Run as.

  5. Accede a las credenciales de OAuth:

    • Haz clic en Configuración.
    • Haz clic en Configuración de OAuth.
    • Haz clic en Clave y secreto de consumidor para acceder a las credenciales. El código de verificación se enviará a tu dirección de correo electrónico.
    • Ingresa el código de verificación y haz clic en Verificar.
    • Copia la clave del consumidor y úsala como el ID de cliente.
    • Copia el Secreto de consumidor y úsalo como secreto del cliente.

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: Para crear una instancia de ServiceNow, sigue las instrucciones de la documentación de ServiceNow Developer.

  • Proyecto de : 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 del envío, 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 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. Si deseas obtener información para otorgar consentimiento, consulta Otorga el consentimiento del 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. Para obtener más información sobre las URLs, consulta URLs y tokens en SharePoint en la documentación de SharePoint.

    • ID de inquilino, ID de cliente y 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.

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. 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 Sharepoint Online 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 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.

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 de 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:

  • De forma predeterminada, Slack restringe el rastreo y la sincronización de contenido de canales privados, mensajes grupales y mensajes directos.

Configura la app de Slack

Obtén un token de acceso para permitir que Vertex AI Search transfiera documentos desde tu espacio de trabajo de Slack.

Genera un token de bot

Genera un token de bot para acceder de forma segura a canales privados, mensajes instantáneos (MI) y mensajes instantáneos multiusuario (MPIM). El token de bot no puede rastrear los canales públicos de los que no forma parte, y unirse a canales públicos genera un mensaje de unión.

  1. Accede a Apps de la API de Slack.
  2. Haz clic en Crear nueva app.
  3. Selecciona Desde cero.
  4. Ingresa un nombre para tu app y selecciona el lugar de trabajo para la integración.
  5. Haz clic en Crear aplicación.
  6. Haz clic en OAuth y permisos.

  7. En Bot token scopes, agrega los siguientes alcances obligatorios:

    De forma predeterminada, el bot lee de los canales #general y #random. Para habilitar el rastreo, haz lo siguiente:

    • Para los canales públicos, otorga el permiso channels:join para permitir que el bot se una automáticamente.
    • En el caso de los canales privados, invita al bot de forma manual.

  8. Haz clic en Instalar en el lugar de trabajo de tu nombre de usuario.

  9. Sigue las instrucciones en pantalla para instalar la app y recuperar el token del bot.

Genera un token de usuario

Genera un token de usuario para acceder a todos los canales públicos sin unirte a ellos primero. El token de usuario no puede rastrear canales privados, MI ni MPIM, a menos que el usuario tenga acceso.

  1. Accede a Apps de la API de Slack.
  2. Haz clic en Crear nueva app.
  3. Selecciona Desde cero.
  4. Ingresa un nombre para tu app y selecciona el lugar de trabajo para la integración.
  5. Haz clic en Crear aplicación.
  6. Haz clic en OAuth y permisos.

  7. En Permisos de token de usuario, agrega los siguientes permisos obligatorios:

  8. Haz clic en Instalar en el lugar de trabajo de tu nombre de usuario.

  9. Sigue las instrucciones en pantalla para instalar la app y recuperar el token del usuario.

Crea un conector de Slack Cloud

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 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

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 el equipo de tu cuenta de Vertex AI Search.

  • Un administrador de Workday debe generar o obtener lo siguiente para integrarlo 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). Es 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 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

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 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