Esta página se ha traducido con Cloud Translation API.

Configurar 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 con Gemini Enterprise.

Antes de empezar

Antes de configurar la conexión federada de Confluence Cloud, asegúrate de lo siguiente:

Asigna el rol de editor de Discovery Engine (roles/discoveryengine.editor). Este rol es obligatorio para que el usuario pueda crear el almacén de datos. Para asignar este rol, sigue estos pasos:
1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud
  Ir a IAM
2. Busca la cuenta de usuario y haz clic en el icono de editar Editar.
3. Asigna el rol Discovery Engine Editor al usuario. Para obtener más información, consulta Roles y permisos de gestión de identidades y accesos.
Para aplicar el control de acceso a las fuentes de datos y proteger los datos en Google Gemini Enterprise, configura tu proveedor de identidades.
Para configurar el conector de Confluence Cloud, debes usar el nuevo modelo de gestión de usuarios centralizado de Atlassian. Si usas el modelo original, debes migrar tu gestión de usuarios antes de continuar. Para obtener más información, consulta el artículo Función de administrador del sitio.
Crea una aplicación 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 obtener las direcciones de correo de los usuarios de Confluence Cloud, aunque los ajustes restrinjan la visibilidad del correo, instala la aplicación User Identity Accessor for Confluence Cloud con privilegios de administrador del sitio de Confluence y, a continuación, configúrala para obtener las direcciones de correo de los usuarios de forma segura. Puede que no tengas que instalar esta aplicación si las direcciones de correo ya son de acceso público.

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

Crear un almacén de datos de Confluence Cloud

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

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

Gemini Enterprise
Selecciona o crea un Google Cloud proyecto.

Nota: Para acceder al flujo unificado, tu proyecto debe estar en la lista de permitidos.
En el menú de navegación, haga 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:
1. En la sección Modo de conector, selecciona Ingestión de datos o Búsqueda federada como 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 hayas elegido.
  1. Si has seleccionado Ingestión de datos:
    1. Selecciona Credenciales de cliente de OAuth 2.0 o Token de API como método de autenticación.
    2. Si seleccionas Credenciales del cliente de OAuth 2.0, introduce los siguientes detalles:
      - ID de cliente
      - Secreto de cliente
      - URI de instancia
      - ID de instancia
    3. Si seleccionas Token de API, introduce los siguientes detalles:
      - URI de instancia
      - Cuenta de usuario
      - Token de API
  2. Si has seleccionado Búsqueda federada:
    1. Credenciales de cliente de OAuth 2.0 es el único método aplicable. Proporcione los siguientes datos:
      - ID de cliente
      - Secreto de cliente
      - URI de instancia
  Para obtener más información sobre las credenciales, consulta Configuración de Confluence Cloud.
  1. Haz clic en Iniciar sesión y completa el inicio de sesión de Atlassian.
4. Haz clic en Continuar.
5. En la sección Destinos, introduce la URL de tu endpoint de Confluence Cloud.
6. Haz clic en Continuar.
7. En la sección Entidades que se van a sincronizar (si ha seleccionado Ingestión de datos) o Entidades que se van a buscar (si ha seleccionado Búsqueda federada):
  1. Selecciona todas las entidades necesarias.
  2. Opcional: Para sincronizar proyectos específicos, sigue estos pasos:
    1. Haz clic en Filtrar.
    2. Para excluir entidades del índice, selecciona Excluir del índice. Para asegurarte de que se incluyan en el índice, selecciona Incluir en el índice.
    3. Introduce las teclas de espacio. Pulsa Intro después de cada espacio.
    4. Haz clic en Guardar.
  3. Si ha seleccionado Ingestión de datos, siga estos pasos para configurar la programación de la sincronización:
    1. En la lista Frecuencia de sincronización, seleccione la frecuencia de sincronización.
      - Para programar sincronizaciones completas independientes de los datos de entidad y de identidad, despliega el menú de la sección Sincronización completa y selecciona Opciones personalizadas.
    2. En la lista Frecuencia de sincronización incremental, seleccione la frecuencia de sincronización incremental.
  Para obtener más información, consulta Programaciones de sincronización.
Haz clic en Continuar.
En la sección Configuración:
1. En la lista Multirregión, selecciona la ubicación del conector de datos.
2. En el campo Nombre del conector de datos, escriba un nombre para el conector.
3. Si has seleccionado US o EU como ubicación, configura los ajustes de cifrado:
  - Opcional: Si no ha configurado claves de una sola región, haga clic en Ir a la página de configuración para hacerlo. Para obtener más información, consulte Registrar una clave de una sola región para conectores de terceros.
  - Selecciona Clave de cifrado gestionada porGoogle o Clave de Cloud KMS.
  - Si has seleccionado Clave de Cloud KMS:
    - En la lista Tipo de gestió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 cifrado gestionadas por el cliente.
Haz clic en Continuar.
En la sección Facturación, seleccione Precios generales o Precios configurables. Para obtener más información, consulta Verificar 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 Data Stores (Almacenes de datos), haz clic en el nombre del almacén de datos para ver el estado. Cuando 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 ingestión creado con Confluence Cloud, el estado del almacén de datos pasa de Creating (Creando) a Running (En ejecución) cuando se inicia la sincronización. Después, cambia a Activo cuando se completa la ingestión, lo que indica que el almacén de datos está totalmente configurado. En función del volumen de datos, la ingestión puede tardar varias horas.

Después de crear el almacén de datos, crea una aplicación, 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 consulta.

Habilitar la sincronización en tiempo real para la ingestión 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 documento que se admiten con la sincronización en tiempo real.

Entidades de Confluence	Crear	Actualizar	Eliminar	Cambios en los permisos
Espacios
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:

Generar una URL de webhook

Ve 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 Sincronización en tiempo real.
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 interruptor Habilitar sincronización en tiempo real.
2. En el campo Client secret (Secreto de cliente), introduce un valor de marcador de posición, como clientsecret.
3. Haz clic en Guardar.
Cuando 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 del webhook.
2. Haz clic en Cerrar.

Suscribirse a eventos mediante la API

Para recibir actualizaciones en tiempo real de Confluence, debes suscribirte a eventos específicos mediante una solicitud POST. Para hacer llamadas a la API, usa la misma cuenta de administrador que usaste 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: la dirección web base de tu sitio de Atlassian Cloud.
USERNAME: nombre de usuario de Atlassian Cloud.
API_TOKEN: el token de API generado desde tu cuenta de Atlassian. Para obtener más información, consulta Configurar un token de API en Confluence.
SUBSCRIPTION_NAME: nombre único de la suscripción al evento.
LISTENER_URL: la URL del webhook copiada de la consola Google Cloud una vez que se haya habilitado la sincronización en tiempo real en tu almacén de datos.

EVENT_TYPE: los tipos de eventos a los que quieres suscribirte. Puedes suscribirte para crear, actualizar y eliminar eventos de archivos adjuntos, entradas 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 indican los códigos de error de la API que suelen aparecer cuando los usuarios crean webhooks.

Clase de error	Código de error	Mensaje de error	Solución de problemas
`403`	`FORBIDDEN`	El usuario actual no tiene permiso para usar Confluence.	Asegúrate de que el token de una cuenta de administrador sea válido y de que el endpoint de la API sea correcto.

Gestión de datos y ejecución de consultas

En esta sección se describe cómo gestiona Gemini Enterprise tu consulta y las implicaciones para la privacidad del uso del almacén de datos federado.

Ejecución de consultas

Después de autorizar Confluence Cloud y enviar una consulta de búsqueda a Gemini Enterprise:

Gemini Enterprise envía tu consulta de 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 completo.

Tratamiento de datos

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

La cadena de consulta se envía al backend de búsqueda de terceros (API de Atlassian).
Estos terceros pueden asociar las consultas con tu identidad.
Si hay varias fuentes de datos de búsqueda federada habilitadas, la consulta se puede enviar a todas ellas.
Una vez que los datos llegan al sistema de terceros, se rigen por los términos del servicio y las políticas de privacidad de ese sistema.

Siguientes pasos

Para proporcionar una interfaz de usuario para consultar tus datos de Confluence Cloud, crea una aplicación y conéctala al almacén de datos de Confluence Cloud.
Para ver cómo aparecen los resultados de búsqueda después de configurar tu aplicación, consulta Obtener resultados de búsqueda.
Para habilitar las alertas del almacén de datos, consulta Configurar alertas para almacenes de datos de terceros.