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:

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, el almacén de datos sincroniza los datos de esa fuente con la frecuencia que selecciones durante la configuración.

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

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

  • Ten a mano la siguiente información de autenticación:

    • URL de la instancia. En el formato https://EXAMPLE.atlassian.net, por ejemplo, https://google.atlassian.net.

    • ID de la instancia. Este es el cloudid y se puede encontrar en https://EXAMPLE.atlassian.net/_edge/tenant_info y copiando el valor de cloudId.

  • Habilita OAuth 2.0 y obtén el ID de cliente y el secreto del cliente.

    Usa https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html como la URL de devolución de llamada. Si quieres obtener información para habilitar OAuth 2.0 para Confluence Cloud y obtener el ID de cliente y el secreto del cliente, consulta Apps de OAuth 2.0 (3LO) en la documentación de Atlassian Developer.

  • Cuando configures los permisos de OAuth 2.0, configura los siguientes permisos:

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

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

  9. Ingresa un nombre para tu conector de datos.

  10. Selecciona una frecuencia de sincronización.

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

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

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

Próximos pasos

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

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

Configura la autenticación y los permisos en Jira

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

Crea un ID de cliente y un secreto del cliente

  1. Accede a developer.atlassian.com.
  2. Haz clic en el ícono de perfil que se encuentra en la esquina superior derecha y selecciona Consola de Play Console.
  3. Haz clic en Crear y selecciona Integración de OAuth 2.0.
  4. Ingresa un nombre para la app.
    • Marca la casilla de verificación de los Términos y Condiciones.
    • Haz clic en Crear.

  5. Encontrarás cinco opciones: Descripción general, Distribución, Permisos, Autorización y Configuración. Comienza con Autorización:

    a. Haz clic en Autorización.

    b. En la tabla Authorization type, selecciona Add para OAuth 2.0 (3LO).

  6. En el campo URL de devolución de llamada, ingresa https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html y, luego, haz clic en Guardar cambios.

    NOTA: Si ves la advertencia: Tu app no tiene ninguna API. Agrega APIs a tu app.. Esto se abordará en la siguiente sección.

  7. Selecciona Permisos:

    a. Ve a la API de Jira, haz clic en Agregar y, luego, en Configurar.

    NOTA: Cuando haces clic en Agregar, el botón cambia a Configurar.

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

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

  8. Haz clic en Distribución, selecciona Editar y haz lo siguiente:

    • Primero, selecciona el botón de selección Uso compartido para habilitar la edición de otros campos.
    • Completa los campos restantes.
    • Selecciona Sí cuando se te pregunte: Does your app store personal data?

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

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

Para obtener la URL de la instancia, sigue estos pasos:

  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. Se verá de la siguiente manera: Assign appropriate permissions.

Para obtener el ID de la instancia, haz lo siguiente:

  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. En la sección Acceso a los productos del grupo de la página del grupo nuevo, haz clic en Agregar productos al grupo.

  6. Para Jira, selecciona Administrador de acceso de usuarios como el rol del producto.

  7. Para Administrador de Jira, selecciona Administrador de productos como el rol del producto y guarda los cambios.

  8. En la página Groups, haz clic en Add group members y agrega los usuarios o las cuentas con los que se autenticará el conector.

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, ve a la sección Fuentes de terceros y selecciona Jira.

  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 Jira para tu almacén de datos.

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

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

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

  10. Selecciona una frecuencia de sincronización.

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

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

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

Próximos pasos

Conecta Salesforce

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

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

Antes de comenzar

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

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

  • Ten a mano la siguiente información de autenticación. Si quieres obtener información para configurar el ID de cliente y el secreto del cliente en Salesforce, consulta Configura una app conectada para el flujo de credenciales de cliente de OAuth 2.0 en la documentación de Salesforce.

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

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

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

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

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

Crea una app

Salesforce admite las siguientes apps:

  1. App conectada:
  2. App cliente externa:

Crea una app conectada

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

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

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

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

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

    b. Habilita los flujos:

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

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

  1. Edita las políticas de la app:

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

  2. Configura restricciones de IP:

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

  3. Configura una app conectada de OAuth:

  4. Guarda la app conectada:

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

Crea una app cliente externa

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

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

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

  2. Proporciona la información requerida:

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

  3. Habilita la configuración de OAuth:

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

  4. Edita las políticas de la app:

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

  5. Accede a las credenciales de OAuth:

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

Crea un conector de Salesforce

Console

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

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

    Agent Builder

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

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

  4. En la página Selecciona 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

Conectar 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 configurar la conexión, haz lo siguiente:

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

  • Ten a mano la siguiente información de autenticación:

    • URL de la instancia en el formato https://<domain-name>.service-now.com/.
    • ID de cliente y secreto del cliente Para obtener información sobre la configuración de extremos y cómo obtener el ID de cliente y el secreto del cliente, consulta Crea un extremo para que los clientes accedan a la instancia en la documentación de ServiceNow.

    • Nombre de usuario y contraseña para uno de los siguientes tipos de roles de ServiceNow:

      • Rol de administrador Consulta Roles del sistema base en la documentación de ServiceNow.

      • Un rol personalizado de ServiceNow Esta es una alternativa al uso de un rol de administrador. Para usar un rol personalizado de ServiceNow, crea reglas de control de acceso con los siguientes campos:

        Para obtener más información, consulta Crea un rol y Crea una regla de ACL en la documentación de ServiceNow.

Console

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

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

    Agent Builder

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

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

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

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

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

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

  8. Ingresa un nombre para tu conector de datos.

  9. Selecciona una frecuencia de sincronización.

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

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

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

Próximos pasos

Cómo conectar 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 configurar la conexión, haz lo siguiente:

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

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

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

    • URL de la instancia. En el formato http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Para obtener más información sobre las URLs, consulta URLs y tokens en SharePoint en la documentación de SharePoint.

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

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

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

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

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

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

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

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

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

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

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

Próximos pasos

Conectar Slack

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

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

Antes de comenzar

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

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

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

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

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

Configura la app de Slack

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

Genera un token de bot

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

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

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

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

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

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

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

Genera un token de usuario

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

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

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

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

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

Crea un conector de Slack Cloud

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

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

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

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

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

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

Próximos pasos

Cómo conectar Dropbox

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

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

Antes de comenzar

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

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

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

    • ID de cliente
    • Secreto del cliente

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

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

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

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

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

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

Próximos pasos

Connect Box

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

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

Antes de comenzar

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

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

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

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

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

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

Crea la app de Box

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

Configura la app de Box

Configura la app de Box.

Crea clave pública/privada

  1. Ve a Box Developer Console.

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

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

Configura los permisos necesarios

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

Autoriza la app

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

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

Crea un conector de Box

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

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

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

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

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

Próximos pasos

Cómo conectar OneDrive

Usa el siguiente procedimiento para sincronizar datos de OneDrive con la Búsqueda de Vertex AI.

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

Antes de comenzar

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

Console

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

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

    Agent Builder

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

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

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

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

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

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

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

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

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

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

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

Próximos pasos