Se usó la API de Cloud Translation para traducir esta página.

Configura un almacén de datos de Confluence Cloud

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

Antes de comenzar

Antes de configurar la conexión federada de Confluence Cloud, asegúrate de cumplir con los siguientes requisitos:

Otorga el rol de Editor de Discovery Engine (roles/discoveryengine.editor). Este rol es necesario para que el usuario cree el almacén de datos. Para otorgar este rol, haz lo siguiente:
1. En la consola de Google Cloud , dirígete a la página IAM.
  Ir a IAM
2. Ubica la cuenta de usuario y haz clic en el ícono de editar Editar.
3. Otorga el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de IAM.
Para aplicar el control de acceso a la fuente de datos y proteger los datos en Google Gemini Enterprise, configura tu proveedor de identidad.
Para configurar el conector de Confluence Cloud, debes usar el nuevo modelo centralizado de administración de usuarios de Atlassian. Si usas el modelo original, debes migrar tu administración de usuarios antes de continuar. Para obtener más información, consulta Rol de administrador del sitio.
Crea una app de OAuth 2.0, obtén el ID y el secreto del cliente y configura los permisos mínimos de la aplicación con el consentimiento de un administrador de Confluence Cloud.
Opcional: Para recuperar las direcciones de correo electrónico de los usuarios de Confluence Cloud, incluso cuando la configuración restringe la visibilidad del correo electrónico, instala la aplicación User Identity Accessor for Confluence Cloud con privilegios de administrador del sitio de Confluence y, luego, configúrala para recuperar de forma segura las direcciones de correo electrónico de los usuarios. Es posible que no necesites instalar esta app si las direcciones de correo electrónico ya son de acceso público.

Nota: Atlassian está actualizando los elementos de la interfaz de usuario y cambiará el nombre de algunos de los que se mencionan en esta documentación (por ejemplo, Productos pasará a ser Apps). Para obtener más información, consulta Cambio en la terminología de administración de Atlassian de "productos" a "apps".

Crea un almacén de datos de Confluence Cloud

Para crear un almacén de datos de Confluence Cloud, sigue estos pasos:

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

Gemini Enterprise
Selecciona o crea un proyecto de Google Cloud .

Nota: Para acceder al flujo unificado, tu proyecto debe estar en la lista de entidades permitidas.
En el menú de navegación, haz clic en Almacenes de datos.
Haz clic en Crear almacén de datos.
En la sección Fuente, busca Confluence Cloud y haz clic en Seleccionar.
En la sección Datos, haz lo siguiente:
1. En la sección Modo del conector, selecciona Transferencia de datos o Búsqueda federada como el modo de conexión.
2. Haz clic en Continuar.
3. En la sección Configuración de autenticación, configura la autenticación según el modo de conexión que elijas.
  1. Si seleccionaste Transferencia de datos, haz lo siguiente:
    1. Selecciona Credenciales de cliente de OAuth 2.0 o Token de API como método de autenticación.
    2. Si seleccionas Credenciales de cliente de OAuth 2.0, ingresa los siguientes detalles:
      - Client ID (ID de cliente)
      - Client Secret (Secreto del cliente)
      - URI de instancia
      - ID de instancia
    3. Si seleccionas Token de API, ingresa los siguientes detalles:
      - URI de instancia
      - Cuenta de usuario
      - Token de API
  2. Si seleccionaste Búsqueda federada, haz lo siguiente:
    1. El único método aplicable son las credenciales de cliente de OAuth 2.0. Proporciona los siguientes detalles:
      - Client ID (ID de cliente)
      - Client Secret (Secreto del cliente)
      - URI de instancia
  Para obtener más información sobre las credenciales, consulta Configuración de Confluence Cloud.
  1. Haz clic en Acceder y completa el acceso a Atlassian.
4. Haz clic en Continuar.
5. En la sección Destinations, ingresa la URL de tu extremo de Confluence Cloud.
6. Haz clic en Continuar.
7. En la sección Entities to sync (Entidades para sincronizar) si seleccionaste Data ingestion (Ingesta de datos) o Entities to search (Entidades para buscar) si seleccionaste Federated search (Búsqueda federada), haz lo siguiente:
  1. Selecciona todas las entidades requeridas.
  2. Opcional: Para sincronizar proyectos específicos, haz lo siguiente:
    1. Haz clic en Filtrar.
    2. Para filtrar entidades del índice, selecciona Excluir del índice o, para asegurarte de que se incluyan en él, selecciona Incluir en el índice.
    3. Ingresa las claves de espacio. Presiona Intro después de cada tecla de espacio.
    4. Haz clic en Guardar.
  3. Si seleccionaste Ingesta de datos, para configurar la programación de la sincronización, haz lo siguiente:
    1. En la lista Frecuencia de sincronización, selecciona la frecuencia de sincronización.
      - Para programar sincronizaciones completas independientes de los datos de identidad y de entidad, expande el menú en la sección Sincronización completa y, luego, selecciona Opciones personalizadas.
    2. En la lista Frecuencia de sincronización incremental, selecciona la frecuencia de sincronización incremental.
  Para obtener más información, consulta Programas de sincronización.
Haz clic en Continuar.
En la sección Configuración, haz lo siguiente:
1. En la lista Multirregional, selecciona la ubicación de tu conector de datos.
2. En el campo Nombre del conector de datos, ingresa un nombre para tu conector.
3. Si seleccionaste US o EU como ubicación, configura los parámetros de configuración de encriptación:
  - Opcional: Si no configuraste claves de una sola región, haz clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulta Cómo registrar una clave de una sola región para conectores de terceros.
  - Selecciona Clave de encriptación administrada porGoogle o Clave de Cloud KMS.
  - Si seleccionaste Clave de Cloud KMS, haz lo siguiente:
    - En la lista Tipo de administración de claves, selecciona el tipo adecuado.
    - En la lista Clave de Cloud KMS, selecciona la clave.
  Para obtener más información, consulta Claves de encriptación administradas por el cliente.
Haz clic en Continuar.
En la sección Facturación, selecciona Precios generales o Precios configurables. Para obtener más información, consulta Verifica el estado de facturación de tus proyectos y Licencias.
Haz clic en Crear. Gemini Enterprise crea tu almacén de datos y lo muestra en la página Almacenes de datos.

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

En el caso de un conector de transferencia creado con Confluence Cloud, el estado del almacén de datos pasa de Creando a Ejecutando cuando se inicia la sincronización. Luego, cambia a Activo una vez que se completa la transferencia, lo que indica que el almacén de datos está completamente configurado. Según el volumen de datos, la transferencia puede tardar varias horas.

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

Habilita la sincronización en tiempo real para la transferencia de datos

La sincronización en tiempo real solo sincroniza las entidades de documentos y no sincroniza los datos relacionados con las entidades de identidad. En la siguiente tabla, se muestran los eventos de documentos que se admiten con la sincronización en tiempo real.

Entidades de Confluence	Crear	Actualizar	Borrar	Cambios de permisos
Spaces
Páginas
Blogs
Archivos adjuntos
Comentarios
Pizarras

Habilita la sincronización en tiempo real 20 minutos después de crear el almacén de datos de Confluence Cloud. Para habilitar la sincronización en tiempo real de una fuente de datos de Confluence, sigue estos pasos:

Genera una URL de webhook

Navega a la página de Gemini Enterprise y, en el menú de navegación, haz clic en Almacenes de datos.
Selecciona un almacén de datos de Confluence.
Haz clic en Ver o editar en la fila Realtime sync.
En el cuadro de diálogo Ver y editar parámetros de sincronización en tiempo real, haz lo siguiente:
1. Para activar la sincronización en tiempo real, haz clic en el botón de activación Habilitar la sincronización en tiempo real.
2. En el campo Secreto del cliente, ingresa un valor de marcador de posición, como clientsecret.
3. Haz clic en Guardar.
Después de que el estado de Sincronización en tiempo real cambie a Running, haz clic en Ver o editar.
En el cuadro de diálogo Ver y editar parámetros de sincronización en tiempo real, haz lo siguiente:
1. Copia la URL de webhook.
2. Haz clic en Cerrar.

Suscríbete a eventos con la API

Para recibir actualizaciones en tiempo real de Confluence, debes suscribirte a eventos específicos con una solicitud POST. Para realizar llamadas a la API, usa la misma cuenta de administrador que se usó para configurar la autenticación y los permisos en Confluence para crear el almacén de datos.

      curl -X POST \
        INSTANCE_URL/wiki/rest/webhooks/1.0/webhook \
        -H "Content-Type: application/json" \
        -u "USERNAME:API_TOKEN" \
        -d '{
          "name": "SUBSCRIPTION_NAME",
          "url": "LISTENER_URL",
          "events": [
            "EVENT_TYPE_1",
            "EVENT_TYPE_2"
          ],
          "active": true
        }'

INSTANCE_URL: Es la dirección web base de tu sitio de Atlassian Cloud.
USERNAME: Es el nombre de usuario de Atlassian Cloud.
API_TOKEN: Es el token de API generado a partir de tu cuenta de Atlassian. Para obtener más información, consulta Configura un token de API en Confluence.
SUBSCRIPTION_NAME: Es un nombre único para tu suscripción a eventos.
LISTENER_URL: URL del webhook copiada de la consola Google Cloud una vez que se habilita la sincronización en tiempo real (RTS) en tu almacén de datos.

EVENT_TYPE: Son los tipos de eventos a los que deseas suscribirte. Puedes suscribirte a eventos de creación, actualización y eliminación de archivos adjuntos, publicaciones de blog, páginas, espacios y comentarios.

El usuario puede suscribirse a los siguientes eventos:

space_created
space_updated
page_created
page_updated
attachment_created
attachment_updated
comment_created
comment_updated
blog_created
blog_updated

Ejemplo de comando y resultado

curl -X POST \
    https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook \
    -H "Content-Type: application/json" \
    -u "admin1:######" \
    -d '{
      "name": "Cymbal_DCT",
      "events": [
        "attachment_created",
        "attachment_updated"
      ],
      "url": "https://rt-server-a-jx3m2-uw.a.run.app/webhook",
      "active": true
    }'

{
"name": "Cymbal_DCT",
"url": "https://cymbalgroup.atlassian.net/wiki/rest/webhooks/1.0/webhook",
"description": " Webhook for Cymbal DCT group to fetch attachments.",
"excludeBody": false,
"filters": {},
"events": [
    "attachment_created",
    "attachment_updated",
],
"enabled": true,
"self": https://rt-server-a-jx3m2-uw.a.run.app/webhook,
"lastUpdatedUser": "Cymb_389",
"lastUpdatedDisplayName": "Ariel",
"lastUpdated": 1752095647212
}

Códigos de error de la API

En esta tabla, se enumeran los códigos de error de la API habituales que los usuarios encuentran cuando crean webhooks.

Clase de error	Código de error	Mensaje de error	Soluciona problemas
`403`	`FORBIDDEN`	El usuario actual no tiene permiso para usar Confluence.	Asegúrate de tener un token válido de una cuenta de administrador y el extremo de API correcto.

Control de datos y ejecución de consultas

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

Ejecución de las consultas

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

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

Manejo de datos

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

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

¿Qué sigue?

Para proporcionar una interfaz de usuario para consultar tus datos de Confluence Cloud, crea una app y conéctala al almacén de datos de Confluence Cloud.
Para obtener una vista previa de cómo aparecerán los resultados de la búsqueda después de configurar tu app, consulta Cómo obtener resultados de la búsqueda.
Para habilitar las alertas del almacén de datos, consulta Configura alertas para almacenes de datos de terceros.