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:

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

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

  3. 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
    • 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 Selecciona una fuente de datos, desplázate o busca Adobe Experience Manager para conectar tu fuente de terceros.

  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:

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

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

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

    • ID de instancia (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, desplázate o busca AODocs para conectar tu fuente de terceros.

  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:

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

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

  3. 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 una 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 oAgent Builder de Google Cloud .
  6. Elige Autenticación del servidor con JWT.

Configura la app de Box

  1. Para configurar la app de Box, crea una 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.

  2. Configura los permisos necesarios: En la sección Alcances de la aplicación, selecciona Leer todos los archivos y carpetas almacenados en el cuadro.

    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

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

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

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

  3. Un administrador de Coda debe generar o obtener el token de la API de Coda para integrarlo con Vertex AI Search.

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, desplázate o busca Coda para conectar tu fuente de terceros.

  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:

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

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

Asegúrate de tener los detalles de autenticación y el acceso de administrador necesarios a tu instancia de Confluence. Usa las siguientes instrucciones para crear un ID de cliente y un secreto del cliente a través de la consola de Atlassian Developer, configurar los alcances de OAuth 2.0 requeridos, configurar los permisos de los usuarios, recuperar la URL y el ID de tu instancia, configurar roles y autenticar para sincronizar datos entre Confluence Cloud y Vertex AI Search. 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.

  1. Crea una integración de OAuth 2.0 en la Consola de Atlassian Developer:

    1. Accede a la consola de Atlassian Developer.
    2. Haz clic en el ícono de perfil y selecciona Atlassian Developer Console.
    3. Haz clic en Crear y selecciona Integración de OAuth 2.0.
    4. Ingresa un nombre para la app y haz lo siguiente:
      1. Marca la casilla de verificación de los Términos y Condiciones.
      2. Haz clic en Crear.
      3. Haz clic en Autorización.
      4. 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. Agrega APIs a tu app, continúa con el paso 2 y completa todos los pasos restantes. De lo contrario, continúa con los pasos 4 y 5.

  2. Habilita OAuth 2.0:

    1. Haz clic en Permisos.
    2. Ve a la API de Confluence.
    3. Haz clic en Agregar.
    4. Haz clic en Configurar.
    5. Ve a la pestaña Alcances detallados y haz clic en Editar alcances.
    6. Selecciona los siguientes permisos.
    7. Confirma que se hayan seleccionado siete permisos y guarda los cambios.

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

    1. Haz clic en Distribución.
    2. Selecciona Editar.
    3. Selecciona Uso compartido para habilitar la edición de otros campos.
    4. Completa los campos restantes.
    5. Selecciona Sí cuando veas Does your app store personal data?.
    6. Selecciona Configuración para copiar tu ID de cliente y tu Secreto del cliente.

  4. 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. Aparece como el subdominio en la barra de direcciones.

  5. 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ú 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. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Cloud.
  5. Navega a IAM.

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

  7. Otorga el rol de administrador a un usuario:

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

  8. Configura los permisos en Atlassian:

    1. Ve al sitio de tu dominio de Atlassian y abre la instancia de Confluence Cloud. Como alternativa, ve directamente a admin.atlassian.com.

    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.

  9. Crea y configura grupos:

    1. En la página Administrador, haz clic en el botón Administrar usuarios si es necesario y 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.

  10. Agrega permisos al grupo: Asigna el rol de Administrador de acceso de usuarios.

  11. Asignar miembros del grupo:

    1. En la página Grupo, haz clic en Agregar producto y selecciona el rol de producto adecuado en la lista desplegable.En este caso, selecciona 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 Crear almacén de datos.

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

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

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

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

    1. Establece la configuración de red:

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

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

    2. Ajusta las reglas de firewall:

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

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

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

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

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

  2. Para el extremo público: Si el tipo de destino del centro de datos de Confluence es público, no es necesario que crees la configuración para el 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 cuando crees el conector.

  3. Para el extremo Privado:

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

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

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

    4. Opcional: Configura un sondeo de verificación de estado para supervisar el estado del backend.

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

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

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

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

  2. Crea 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.

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

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

Console

  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 Centro de datos de Confluence para conectar tu fuente de terceros.

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

  6. En la lista desplegable Tipo de destino, selecciona Público o Privado.

    1. Para el tipo de destino 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.

    2. Para el tipo de destino Privado, ingresa toda la información requerida:

      1. Por ejemplo, con la URL del dominio:
        • Adjunto de servicio: Ingresa el adjunto de servicio.
        • Opcional: Nombre de dominio base: Ingresa tu dominio base.
        • URL de dominio: Ingresa la URL de tu dominio.
        • Opcional: Puerto de destino: Ingresa el puerto de destino.
      2. Por ejemplo, sin la URL del dominio:
        • Adjunto de servicio: Ingresa el adjunto de servicio.
        • Opcional: Puerto de destino: Ingresa el puerto de destino.

  7. Haga clic en Continuar.

  8. Opcional: Opciones avanzadas: Selecciona y habilita la configuración de proxy y la configuración de SSL, si es necesario.

  9. En Entidades para sincronizar, selecciona todas las entidades que se deben sincronizar y haz clic en Continuar.

  10. Selecciona una región para tu conector de datos y, luego, ingresa un nombre para él.

  11. Selecciona una frecuencia de sincronización.

En el caso del tipo de destino Privado, después de que envíes los detalles del conector, VAIS enviará una solicitud de conexión a tu PSC. Navega a tu conector para ver un mensaje que te permita incluir un projectId en la lista de entidades permitidas del PSC. El conector permanecerá en el estado Error hasta que permitas la conexión en PSC. Cuando aceptas la solicitud de conexión, el conector pasa al estado Activo durante la próxima ejecución de sincronización. Si configuras tu PSC para que acepte todas las conexiones, el conector se moverá automáticamente al estado Activo después de la creación.

En el caso del tipo de destino Público, el conector entra automáticamente en el estado Activo después del envío.

Para verificar el estado del almacén de datos y la actividad de transferencia, haz lo siguiente:

  1. Navega al conector en la lista de almacén de datos y supervisa su estado hasta que cambie a Activo.
  2. Después de que el estado del conector cambie a Activo, haz clic en la entidad requerida y confirma que se hayan transferido todas las entidades seleccionadas. El estado del almacén de datos pasa de Creando a En ejecución cuando comienza la sincronización y cambia a Activo una vez que se completa la transferencia, lo que indica que el almacén de datos está configurado.Según el tamaño de tus datos, la transferencia puede tardar varias 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:

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

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

Crea un conector de Dropbox

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, desplázate o busca Dropbox para conectar tu fuente de terceros.

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

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

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

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

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

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

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

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

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

Próximos pasos

Conectar Dynamics 365

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

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

Antes de comenzar

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

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

  2. 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, desplázate o busca Dynamics 365 para conectar tu fuente de terceros.

  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:

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

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

  3. Un administrador de GitHub debe obtener el token de acceso personal de la instancia de GitHub para integrarlo con la búsqueda de Vertex AI.

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, desplázate o busca GitHub para conectar tu fuente de terceros.

  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:

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

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

  3. Un administrador de GitLab debe obtener el token de acceso personal de la instancia de GitLab para realizar la integración con la Búsqueda de Vertex AI.

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, desplázate o busca GitLab para conectar tu fuente de terceros.

  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:

  1. Verifica que tienes acceso de administrador a la instancia y al proyecto de Jira.

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

  3. Para que los permisos de los usuarios se apliquen correctamente, los usuarios de Jira Cloud deben dar su consentimiento para compartir.

  4. Asegúrate de tener una cuenta de Atlassian, una instancia de Jira y un proyecto.

Configura la autenticación y los permisos en Jira

Asegúrate de tener los detalles de autenticación necesarios y el acceso de administrador a tu instancia de Jira. Usa las siguientes instrucciones para crear un ID de cliente y un secreto del cliente a través de la consola de Atlassian Developer, configurar los alcances de OAuth 2.0 necesarios, configurar los permisos de los usuarios, recuperar la URL y el ID de tu instancia, configurar roles y autenticar para sincronizar datos entre Jira Cloud y Vertex AI Search. 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.

  1. Crea una integración de OAuth 2.0 en la Consola de Atlassian Developer:

    1. Accede a la consola de Atlassian Developer.
    2. Haz clic en el ícono de perfil 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 y haz lo siguiente:

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

  3. Haz clic en Guardar cambios.

    Si ves la advertencia: Tu app no tiene ninguna API. Agrega APIs a tu app, continúa con el paso 2 y completa todos los pasos restantes. De lo contrario, continúa con los pasos 4 y 5.

  4. Habilita OAuth 2.0:

    1. Selecciona Permisos:
    • Ve a la API de Jira.
    • Haz clic en Agregar.
    • Haz clic en Configurar.
    • Ve a la pestaña Permisos clásicos y haz clic en Editar permisos. Selecciona los siguientes permisos:
    • Ve a la pestaña Alcances detallados y haz clic en Editar alcances. Selecciona los siguientes permisos:
    1. Confirma que se hayan seleccionado ocho alcances y, luego, guarda los cambios.

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

    1. Haz clic en Distribución.

    2. Selecciona Editar y haz lo siguiente:

      1. Selecciona Uso compartido para habilitar la edición de otros campos.
      2. Completa los campos restantes.
      3. 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.

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

  7. 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 Cloud 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:

  1. 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.
  2. Nombre de usuario y contraseña: Obtén credenciales válidas para la autenticación de tu administrador de Jira.
  3. Opcional para el tipo de destino privado: URL de dominio: Especifica la URL de la instancia de Jira Data Center.
  4. Opcional: Nombre de dominio base: Proporciona el nombre de dominio base de la instancia de Jira.
  5. Opcional: Puerto de destino: Identifica el puerto que se usa para la comunicación con el centro de datos de Jira.

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

    1. Establece la configuración de red:

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

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

    2. Ajusta las reglas de firewall:

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

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

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

Genera un adjunto de servicio

Sigue estos pasos para generar un archivo adjunto de servicio:

  1. Decide el tipo de extremo: Selecciona 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:

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

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

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

    4. Opcional: Configura un sondeo de verificación de estado para supervisar el estado del backend.

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

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

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

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

  2. Crea 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.

  3. 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 está asignado en la sección Miembros del grupo.

  4. 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:
      1. Explorar proyectos
      2. Explora el archivo de proyectos.
    8. Agrega este esquema a los proyectos en los que los usuarios del grupo necesiten acceso para ver el proyecto, los problemas, los comentarios, los registros de trabajo y los archivos adjuntos.

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

Console

  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 Centro de datos de Jira para conectar tu fuente de terceros.

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

  6. En la lista desplegable Tipo de destino, selecciona Público o Privado.

    1. Para el tipo de destino 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.

    2. Para el tipo de destino Privado, ingresa toda la información requerida:

      1. Por ejemplo, con la URL del dominio:
        • Adjunto de servicio: Ingresa el adjunto de servicio.
        • Opcional: Nombre de dominio base: Ingresa tu dominio base.
        • URL de dominio: Ingresa la URL de tu dominio.
        • Opcional: Puerto de destino: Ingresa el puerto de destino.
      2. Por ejemplo, sin la URL del dominio:
        • Adjunto de servicio: Ingresa el adjunto de servicio.
        • Opcional: Puerto de destino: Ingresa el puerto de destino.

  7. Haga clic en Continuar.

  8. Opcional: Opciones avanzadas: Selecciona y habilita la configuración de proxy y la configuración de SSL, si es necesario.

  9. En Entidades para sincronizar, selecciona todas las entidades que se deben sincronizar y haz clic en Continuar.

  10. Selecciona una región para tu conector de datos y, luego, ingresa un nombre para él.

  11. Selecciona una frecuencia de sincronización.

En el caso del tipo de destino Privado, después de que envíes los detalles del conector, VAIS enviará una solicitud de conexión a tu PSC. Navega a tu conector para ver un mensaje que te permita incluir un projectId en la lista de entidades permitidas del PSC. El conector permanecerá en el estado Error hasta que permitas la conexión en PSC. Cuando aceptas la solicitud de conexión, el conector pasa al estado Activo durante la próxima ejecución de sincronización. Si configuras tu PSC para que acepte todas las conexiones, el conector se moverá automáticamente al estado Activo después de la creación.

En el caso del tipo de destino Público, el conector entra automáticamente en el estado Activo después del envío. Para verificar el estado del almacén de datos y la actividad de transferencia, haz lo siguiente:

  1. Navega al conector en la lista de almacén de datos y supervisa su estado hasta que cambie a Activo.
  2. Después de que el estado del conector cambie a Activo, haz clic en la entidad requerida y confirma que se hayan transferido todas las entidades seleccionadas. El estado del almacén de datos pasa de Creando a En ejecución cuando comienza la sincronización y cambia a Activo una vez que se completa la transferencia, lo que indica que el almacén de datos está configurado. Según el tamaño de tus datos, la transferencia puede tardar varias 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:

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

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

  3. 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, desplázate o busca Microsoft Outlook para conectar tu fuente de terceros.

  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:

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

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

  3. 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 Seleccionar una fuente de datos, desplázate o busca Microsoft Teams para conectar tu fuente de terceros.

  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:

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

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

    • Token de API de la instancia de Notion
    • ID del lugar de trabajo

  3. 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, desplázate o busca Notion para conectar tu fuente de terceros.

  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:

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

  2. Ten a mano la siguiente información de autenticación de OneDrive:

    1. ID de cliente, secreto del cliente y ID de grupo de usuarios Si deseas obtener información para configurar estos parámetros, consulta la guía de inicio rápido para registrar una aplicación con la plataforma de identidad de Microsoft en la documentación de Microsoft.

    2. Especifica los permisos de acceso. Se requiere un rol de administrador. Para obtener más información, consulta Guía de inicio rápido: Configura una aplicación cliente para acceder a una API web en la documentación de Microsoft.

    3. Configura los siguientes permisos:

Crea un conector de OneDrive

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 Selecciona una fuente de datos, desplázate o busca OneDrive para conectar tu fuente de terceros.

  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:

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

  2. 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
    • ID de consumidor
    • Secreto de consumidor

Se aplica la siguiente limitación:

  1. Usa un plan empresarial o para desarrolladores. No se admiten cuentas de prueba.
  2. Asegúrate de usar Sales Cloud. No se admite Service Cloud.
  3. Agrega Google Cloud a la lista de entidades permitidas de CORS de Salesforce. Si ya completaste esta tarea, ve al siguiente paso.
    1. Sigue las instrucciones de la documentación de Salesforce para configurar la lista de entidades permitidas de CORS.
    2. Ingresa https://console.cloud.google.com/ como URL de origen y guarda la configuración.

Crea un conector de Salesforce

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

  9. Selecciona una frecuencia de sincronización.

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

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

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

Próximos pasos

Conecta ServiceNow

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

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

Antes de comenzar

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

  1. Instancia de ServiceNow: Para crear una instancia de ServiceNow, sigue las instrucciones de la documentación de ServiceNow Developer.

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

  3. 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, establece flujos de trabajo y desarrolla aplicaciones personalizadas.
    • URL: https://developer.service-now.com.
    • Accede con tu ID de ServiceNow.

Para crear un extremo de OAuth, haz lo siguiente:

  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:

    1. Nombre: Es un nombre único.
    2. 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. Mantén 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 esta función, haz clic en Elevar rol en tu perfil para cambiar tu rol a security_admin. Selecciona el rol security_admin y haz clic en Actualizar. Se requiere el rol security_admin para crear roles y administrar usuarios.

  1. 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:

      1. Incidente: incident.
      2. 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.
      3. Conocimiento: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Adjunto: Todos los elementos de la lista.
      5. Identidad: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember y sys_user
      6. Se actualizan a medida que se extraen nuevos criterios: core_company, cmn_location y cmn_department.
      7. 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 LCA requeridas estén asignadas al rol seleccionado.

  2. 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:

    1. ID de usuario: manager.
    2. 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:

  1. Configuración de OIDC de Azure
  2. Configuración de SAML de Azure
  3. Configuración de OIDC y Okta
  4. Configuración de Okta y SAML

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, desplázate o busca ServiceNow para conectar tu fuente de terceros.

  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

Conecta SharePoint Online

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

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

  2. Otorga el consentimiento del administrador. Si deseas obtener información para otorgar consentimiento, consulta Otorga consentimiento de administrador en todo el inquilino a una aplicación en la documentación de Microsoft Entra.

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

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

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

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

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

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

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

Usa este método para obtener un control detallado sobre los permisos de la API de REST de SharePoint, lo que te permite restringir el acceso a los recursos en la cuenta de usuario. Asegúrate de crear un usuario de SharePoint nuevo, lo que podría agregar costos de licencias. Usa el método de token de actualización de OAuth 2.0 para configurar un registro de la aplicación de Entra y habilitar el acceso seguro a SharePoint.

Configura el registro de la aplicación de Entra

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

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

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

      1. En la consola de Google Cloud, ve a la página 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 SharePoint Online para conectar tu fuente de terceros.
      5. Anota el identificador de asunto.

    2. Registra la app en Microsoft Entra:

      1. Navega a Entra admin center.

      2. Crea un registro de app:

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

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

    3. Agrega credenciales federadas:

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

      2. Usa la siguiente configuración:

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

      3. Haz clic en Agregar para otorgar acceso.

    4. Establece permisos de API:

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

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

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

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

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

    1. Crea el registro de la app:

      1. Navega a Entra admin center.

      2. Crea un registro de app:

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

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

    2. Agrega el secreto del cliente:

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

      2. Anota la cadena secreta.

    3. Establece permisos de API:

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

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

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

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

Crea un conector de SharePoint Online

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, desplázate o busca SharePoint Online para conectar tu fuente de terceros.

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

  6. Ingresa la URL del sitio de SharePoint:

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

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

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

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

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

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

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

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

Prueba el motor de búsqueda

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

  1. Habilita la app web:

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

  2. Prueba la app web:

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

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

Configura el grupo de trabajadores

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

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

    1. Configuración de OIDC de Azure
    2. Configuración de SAML de Azure
    3. Configuración de OIDC y Okta
    4. Configuración de Okta y SAML

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

Próximos pasos

Conectar Slack

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

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

Antes de comenzar

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

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

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

  3. Prepara la siguiente información de autenticación de Slack:

    1. ID de Workspace: Para obtener el ID de Workspace, sigue las instrucciones que se indican en Especifica la fuente de Slack para tu almacén de datos en la documentación de Slack.

    2. Token de acceso: Crea una app cliente y define los permisos necesarios. Para obtener más información, consulta la Guía de inicio rápido y Cómo obtener y usar rápidamente un token de API de Slack en la documentación de Slack.

    3. Cuando configures los permisos de OAuth 2.0, configura los siguientes permisos:

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

  1. 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 permisos obligatorios:

    De forma predeterminada, el bot lee de los canales #general y #random.

    1. Para habilitar el rastreo, haz lo siguiente:

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

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

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

  2. 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, IM 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 Alcances de tokens de usuario, agrega los siguientes alcances 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:

  1. 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.
  2. Verifica que tu proyecto se haya agregado a la lista de entidades permitidas para usar Trello.
  3. 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, desplázate o busca Trello para conectar tu fuente de terceros.

  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:

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

  2. Un administrador de Workday debe generar o obtener lo siguiente para integrarlo con Vertex AI Search:

    1. ID de cliente Obtén la información en la página Ver clientes de API en Workday.
    2. Secreto del cliente. Obtén la información en la página Ver clientes de API en Workday.
    3. Token de actualización Obtén la información en la página Ver clientes de API en Workday.
    4. Opcional: Servidor proxy El nombre de host o la dirección IP de un proxy para enrutar el tráfico HTTP.
    5. Opcional: URL base. La URL base de la conexión de Workday.
    6. Opcional: URL de la API. 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>
    7. 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.

  3. 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 Selecciona una fuente de datos, desplázate o busca Workday para conectar tu fuente de terceros.

  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:

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

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

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

    1. Token de acceso Token de API de tu instancia de Zendesk.
    2. 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, desplázate o busca Zendesk para conectar tu fuente de terceros.

  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