Los equipos pueden integrar Atlassian Confluence Cloud con Amazon Quick para buscar y administrar documentación sin cambiar entre múltiples sistemas. Cuando la documentación reside en Confluence, pero los datos relacionados se encuentran en otros sistemas, los equipos pierden tiempo cambiando de herramientas, investigando el contexto y recopilando información manualmente. Estas interrupciones ralentizan las decisiones y crean brechas entre el conocimiento disponible y los conocimientos prácticos. La integración directa con Confluence Cloud reduce el cambio de contexto al hacer que su contenido de Confluence se pueda buscar mediante consultas en lenguaje natural directamente desde la interfaz rápida. Los equipos pueden consultar páginas de Confluence, recuperar documentación y actualizar contenido mientras acceden a datos de otros sistemas integrados como Amazon Simple Storage Service (Amazon S3), Atlassian JIRA u otras aplicaciones comerciales.
En esta publicación, aprenderá cómo configurar la integración de Confluence Cloud con Quick. Esto incluye la creación de una base de conocimientos para la búsqueda semántica, la configuración de acciones para consultar y administrar páginas de Confluence y la organización de recursos en Quick Spaces. Quick se integra con su pila de tecnología empresarial actual, desde repositorios de conocimiento internos e intranets corporativas hasta aplicaciones críticas para el negocio y servicios de datos de AWS. Estas integraciones abarcan tres categorías: acciones para ejecutar tareas en aplicaciones conectadas, bases de conocimiento para indexar contenido no estructurado como documentos y wikis, y temas y conjuntos de datos para consultas en lenguaje natural sobre fuentes de datos estructurados como Amazon Redshift. Esta publicación se centra en la configuración de bases de conocimiento y acciones.
Las acciones conectan Quick a sistemas externos en el momento de una solicitud o consulta. Puede leer, escribir y automatizar tareas directamente en Quick. Hay tres formas de configurar una integración de Action:
A través de un conector integrado (una integración prediseñada y basada en configuración para herramientas populares como Confluence Cloud, Jira y Salesforce) Usando una API REST personalizada usando una especificación OpenAPI (para conectar API propias o de terceros) A través de un servidor Model Context Protocol (MCP) (un enfoque flexible basado en estándares que permite el descubrimiento dinámico de herramientas desde servidores MCP personalizados o de terceros).
Algunos servicios, como Confluence Cloud, admiten múltiples rutas de integración. Esta publicación se centrará en configurar una integración de acciones utilizando el conector integrado.
Las bases de conocimiento indexan el contenido antes de que los usuarios lo consulten. Cuando crea una base de conocimientos, Quick se conecta a sistemas externos como Confluence Cloud o JIRA, recupera sus documentos y wikis y crea un índice con capacidad de búsqueda. Cuando los usuarios hacen preguntas, Quick recupera información relevante de este índice prediseñado en lugar de conectarse al sistema externo en tiempo real. Este enfoque hace que el contenido no estructurado se pueda buscar instantáneamente mediante consultas en lenguaje natural.
Juntas, las acciones y las bases de conocimientos le brindan formas flexibles y complementarias de incorporar los datos y flujos de trabajo de su empresa a Quick.
Requisitos previos
Antes de configurar la integración de Confluence, asegúrese de tener lo siguiente:
Atlassian Confluence Cloud y cuenta de desarrollador con permisos de administrador para crear aplicaciones OAuth 2.0 y administrar alcances de API Suscripción a Amazon Quick: Quick Enterprise (para crear integraciones) o Quick Professional (para usar integraciones existentes) Cuenta de AWS con permisos apropiados de AWS Identity and Access Management (IAM) para acceder a Quick y crear integraciones
La integración en esta publicación sigue el modelo de responsabilidad compartida de AWS: AWS administra la seguridad de la infraestructura y los servicios subyacentes, mientras que usted es responsable de configurar los permisos de OAuth, administrar los alcances de las API, controlar el acceso a su contenido de Confluence a través de la configuración de permisos y verificar la alineación con las políticas de gobierno de datos de su organización.
Amazon Quick mantiene la seguridad de los datos durante esta integración con cifrado en reposo y en tránsito. Para obtener más información, consulte Seguridad de AWS en Quick.
Descripción general de la solución
Ahora que comprende los beneficios, creará la integración de Confluence Cloud en Quick, creará bases de conocimiento y acciones para sincronizar su contenido de Confluence, configurará permisos e interactuará con su espacio en la nube de Confluence a través de consultas en lenguaje natural. Al final, podrá utilizar el contenido de sus páginas wiki de Confluence para crear información valiosa.
Creación de la base de conocimientos de Atlassian Confluence Cloud
Una base de conocimientos en Quick es una colección organizada e indexada de documentos o contenido de fuentes de datos que Quick mejora para la recuperación generativa impulsada por IA y la respuesta a preguntas. Puede utilizar integraciones de la base de conocimientos para crear repositorios de información con capacidad de búsqueda desde fuentes externas.
En la Consola rápida, elija el botón Conocimiento para configurar una nueva integración. En la sección Configurar una nueva base de conocimientos, seleccione el ícono más (+) en la tarjeta Atlassian Confluence Cloud. La tarjeta Atlassian Confluence Cloud se muestra junto con otras integraciones de la base de conocimientos disponibles, como Amazon S3 y Atlassian Jira Cloud.
En la página Crear base de conocimientos de Confluence, elija el menú desplegable Mi integración de acceso a datos y seleccione Agregar cuenta para conectar su instancia de Confluence Cloud.
En la pantalla Método de autenticación, ingrese su URL base de Confluence en el cuadro de texto URL de Confluence. La URL de Confluence Cloud debe ser la URL base y terminar en .atlassian.net (por ejemplo, tuinstancia.atlassian.net).
Conectar Confluence Cloud a una base de conocimientos Quick no requiere la participación del administrador. Ingrese su URL de Confluence y acepte la solicitud de permiso de OAuth. Quick maneja la autenticación por usted. Cualquier usuario puede configurar esto de forma independiente, sin necesidad de claves API, acceso a la consola de administración o participación de TI.
Los controles de acceso a nivel de documento (ACL) son una característica avanzada opcional para organizaciones que necesitan Quick para aplicar permisos de Confluence por usuario, lo que garantiza que los usuarios solo vean respuestas del contenido al que ya están autorizados a acceder. Para habilitar las ACL se requieren credenciales de administrador de Atlassian (clave de API, ID de organización e ID de directorio).
Para obtener más información, consulte Controles de acceso a nivel de documento. Si no habilita las ACL, el acceso se controla en el nivel de la base de conocimientos. Cualquiera que tenga acceso a la base de conocimientos puede obtener información de todo el contenido que contiene.
Esta publicación de blog utiliza la conexión habilitada para ACL.
Para habilitar los controles de acceso a nivel de documento, marque la casilla Usar credencial de administrador de Atlassian en Administración de ACL y complete los campos Clave API, ID de organización e ID de directorio. Consulte aquí cómo obtener estas credenciales de administrador de Atlassian.
Cuando está habilitado, Amazon Quick verifica el acceso de un usuario en tiempo real y rastrea los siguientes recursos de ACL de Confluence:
Espacios: los permisos de espacio se aplican a todos los documentos del espacio de forma predeterminada. Páginas: las páginas se pueden restringir a usuarios y grupos específicos. Las páginas anidadas heredan restricciones de la página principal y pueden tener sus propias restricciones. Blogs: las publicaciones de blog se pueden restringir a usuarios y grupos específicos en el espacio. Archivos adjuntos: los archivos adjuntos a páginas o publicaciones de blog heredan los controles de acceso de su documento principal.
Cuando aparezca la ventana emergente de Amazon Quick solicitando acceso a su cuenta de Atlassian, revise los permisos enumerados y elija Aceptar para completar el proceso de autorización e inicio de sesión.
Después de iniciar sesión, ingrese un nombre descriptivo para su base de conocimientos y proporcione la URL de Confluence, incluida la clave de espacio (por ejemplo, yourinstance.atlassian.net/wiki/spaces/SPACEKEY).
Elija Agregar y luego Siguiente: Configuraciones adicionales para completar la configuración de la base de conocimientos.
Una vez que haya creado correctamente la base de conocimientos, aparecerá en la sección Bases de conocimientos existentes. La columna Estado muestra el estado de sincronización actual de su base de conocimientos.
Una base de conocimientos creada con éxito en sincronizaciones rápidas con el contenido disponible en Confluence Cloud. Una vez completada la sincronización, el campo Estado cambia a Disponible.
Puede ver más detalles sobre la base de conocimientos eligiendo el botón de puntos suspensivos (…) en la columna Acción y seleccionando Ver base de conocimientos.
En la página de detalles de la base de conocimientos, puede ver el resumen, los programas de sincronización, los informes de sincronización y los permisos de esa base de conocimientos.
La pestaña Resumen de la página de detalles de la base de conocimientos muestra el estado de la base de conocimientos, la marca de tiempo de su última actualización y la URL del contenido que rastreó Quick. Puede elegir Sincronizar ahora para activar una actualización manual o Editar para modificar la configuración de la base de conocimientos, como agregar URL de contenido adicionales y otras configuraciones de indexación avanzadas.
La pestaña Programaciones de sincronización muestra las programaciones de sincronización actuales y el historial de actualizaciones. Puede cambiar la programación actual eligiendo Agregar nueva programación o ejecutar una actualización bajo demanda seleccionando Sincronizar ahora.
La pestaña Sincronizar informes le brinda una descripción general de los elementos que se sincronizaron o actualizaron rápidamente junto con los elementos que se omitieron o fallaron. Aquí también puede descargar un informe CSV detallado para realizar un análisis más detallado de los resultados de la sincronización.
Configurar permisos de la base de conocimientos
Puede administrar los permisos de la base de conocimientos en la pestaña Permisos. Agregue o elimine usuarios y grupos para controlar quién tiene acceso para consultar el contenido indexado de Confluence dentro de Quick.
Consultando su base de conocimientos
Con su base de conocimientos configurada, ahora puede comenzar a hacer preguntas para validar que Quick indexó su contenido de Confluence correctamente antes de conectar todo. Opcionalmente, también puedes considerar agregar tu base de conocimientos a un Espacio Rápido. Cubriremos esto en una sección posterior de este blog. Ahora puede consultar su base de conocimientos. Busca rápidamente su contenido indexado de Confluence y devuelve una respuesta con referencias de fuentes que apuntan a las páginas originales de Confluence.
Creando acciones rápidas
Las bases de conocimiento manejan la amplitud, la ingesta y la indexación del contenido de Confluence para que Quick pueda realizar búsquedas semánticas y generación aumentada de recuperación (RAG) en toda su documentación. Las acciones aportan precisión. Las acciones conectan Quick directamente con las API de Confluence Cloud en vivo, lo que impulsa consultas específicas en tiempo real y operaciones de escritura: creación de páginas, actualización de contenido, recuperación de registros específicos y activación de flujos de trabajo.
Quick admite la integración de acciones en la nube de Confluence mediante autenticación de usuario (3LO) y autenticación de servicio (clave API). Este blog se centra en la autenticación de usuarios (3LO).
Para obtener más información, consulte la integración de Confluence Cloud Action de Amazon Quick.
Para integrar acciones rápidas con Confluence Cloud mediante autenticación de usuario (3LO), primero debe crear una aplicación OAuth 2.0 en la consola de desarrollador de Atlassian. La siguiente sección explica estos pasos.
Creando la aplicación OAuth 2.0
Inicie sesión en su cuenta desde la página de desarrollador de Atlassian.
Inicie sesión en su cuenta desde la página de desarrollador de Atlassian. Seleccione el ícono de perfil en la esquina superior derecha. Luego, en el menú que se abre, seleccione Consola de desarrollador.
En la página de bienvenida, seleccione Crear y luego seleccione Integración de OAuth 2.0.
En la página de integración Crear una nueva OAuth 2.0 (3LO – OAuth de tres patas), en Nombre, ingrese un nombre descriptivo para la aplicación OAuth 2.0. Seleccione la casilla Acepto los términos para desarrolladores de Atlassian y elija Crear.
La consola muestra una página de resumen que describe los detalles de la aplicación OAuth 2.0 que creó. Utilizará las credenciales de esta aplicación en pasos posteriores para configurar la integración de acciones en Quick.
Autorizando la configuración
En el menú de navegación de la izquierda, elija Autorización. En la página Autorización, elija Agregar junto a OAuth 2.0 (3LO) para agregar autorización OAuth de tres etapas a su aplicación.
En la sección OAuth 2.0 otorga códigos de autorización (3LO) para aplicaciones, ingrese la URL de devolución de llamada y elija Guardar cambios. Tenga en cuenta que esta es una URL de devolución de llamada temporal que debe actualizar después de crear una integración de acción en Amazon Quick. Quick genera una URL de devolución de llamada en el siguiente formato: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
Reemplace {región} con la región de AWS donde implementó su instancia Quick.
En la sección Generador de URL de autorización que aparece en la parte inferior de la página Autorización, elija Agregar API para navegar a la página Permisos donde configurará los alcances de API requeridos.
Configuración de alcances de API
En la página Permisos, para Ámbitos, navegue hasta API de identidad de usuario. Elija Agregar y luego elija Configurar para establecer los ámbitos necesarios.
En la página API de identidad de usuario, elija Editar ámbitos y luego agregue los siguientes ámbitos de lectura:
read:me – Ver perfil de usuario activo read:account – Ver perfiles de usuario
Regrese a la página Permisos. Desde Ámbitos, navegue hasta Confluence API. Elija Agregar y luego elija Configurar para establecer los alcances de Confluence requeridos.
Seleccione los siguientes ámbitos requeridos en las pestañas Ámbitos clásicos y Ámbitos granulares.
search:confluence: busca contenido de Confluence. Este es un alcance clásico en Confluence. read:page:confluence: lee el contenido de la página. Este es un alcance granular en Confluence. write:page:confluence: crea y modifica páginas. Este es un alcance granular en Confluence. read:space:confluence – Accede a información espacial. Este es un alcance granular en Confluence.
Para obtener más información, consulte Implementación de OAuth 2.0 (3LO) y Determinación de los alcances necesarios para una operación en Atlassian Developer.
Recupere la ID del cliente y el secreto desde la página de Configuración. Copie estos valores y guárdelos de forma segura. Los necesitará al configurar la integración de acciones en Amazon Quick.
Ahora que ha configurado la aplicación OAuth, es hora de crear una integración de acción. En la página Conectores, seleccione la pestaña Crear para su equipo y simplemente haga clic en la tarjeta Atlassian Confluence Cloud.
En la página de detalles de conexión de Atlassian Confluence Cloud, elija Aplicación OAuth personalizada en el menú desplegable Configuración de OAuth. Proporcione la URL base, la ID del cliente, el secreto del cliente, la URL del token, la URL de autenticación y la URL de redireccionamiento y luego elija Siguiente.
Para obtener más información sobre cada uno de estos campos, consulte Integración de Atlassian Confluence Cloud.
BaseURL: tiene el siguiente formato: ejemplo: https://api.atlassian.com/ex/confluence/yourInstanceId "yourInstanceId", como se muestra en el ejemplo anterior, se puede encontrar navegando a https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/
ID de cliente y secreto de cliente: consulte la sección “Creación de la aplicación OAuth 2.0” de este documento.
TokenURL y AuthorizationURL: puede utilizar los ejemplos predeterminados que se muestran debajo de cada uno de los cuadros de texto en la página Crear integración.
RedirectURL: puede mantener el valor predeterminado tal como está.
En la página Revisar acciones para Atlassian Confluence Cloud, revise las acciones disponibles que Quick expondrá a través de esta integración. Elija Siguiente para continuar.
Opcionalmente, puede compartir esta integración con otros miembros del equipo en la página Compartir integración. Elija Publicar para finalizar y publicar la integración de la acción.
Después de crear correctamente la integración de acciones, la tarjeta de integración de Atlassian Confluence Cloud muestra el estado Conectado.
Haga clic en la tarjeta Integración de Atlassian Confluence Cloud para ver sus detalles. En la página Integración de Atlassian Confluence Cloud, la sección Detalles de conexión muestra No iniciado sesión. Elija Iniciar sesión para autorizar a Quick a acceder a su cuenta de Confluence utilizando las credenciales de OAuth 2.0 que configuró anteriormente.
Después de elegir Iniciar sesión, aparece una ventana emergente que le solicita que apruebe el acceso a su cuenta de Confluence Cloud. Elija Aceptar. Si la conexión se realiza correctamente, la sección Detalles de la conexión se actualiza a Iniciado sesión.
Ahora ha creado y configurado con éxito la integración de su acción con Confluence Cloud.
Espacios rápidos
Si bien puedes usar Quick para trabajar con bases de conocimiento y acciones por separado, los espacios ofrecen una mejor manera de organizar tu integración de Confluence. Un espacio agrupa sus recursos de Confluence: bases de conocimientos, acciones, archivos y paneles en una sola colección para un acceso y una colaboración optimizados. Este espacio de trabajo unificado significa que puede acceder a los componentes de Confluence juntos en lugar de cambiar entre recursos individuales, y los espacios enfocados ayudan a comprender rápidamente su conjunto completo de recursos para obtener respuestas más precisas. Además, puede compartir colecciones completas con colegas para obtener un acceso constante en toda su organización. Agrupar integraciones de Confluence en un espacio crea un centro organizado que mejora tanto la eficiencia individual como los flujos de trabajo del equipo. Las siguientes secciones le muestran cómo crear y usar espacios en Quick para consultar y realizar acciones en Confluence Cloud.
Creando espacios rápidos
Para crear un espacio en Quick, seleccione Espacios en el panel de navegación de la consola y elija el botón Crear espacio.
Asigne al espacio un nombre descriptivo, elija Agregar conocimiento y luego seleccione bases de conocimiento en el menú desplegable para agregar su base de conocimientos de Confluence a este espacio.
En el cuadro de diálogo Agregar bases de conocimientos, seleccione la casilla de verificación junto a su base de conocimientos de Confluence Cloud y elija Agregar.
Ahora que su base de conocimientos de Confluence se agrega a un espacio, estará disponible en todo el ecosistema de Quick, no solo para consultas de chat. Los miembros del equipo pueden usar el Espacio para colaborar (compartir una vista coherente y gobernada del contenido de Confluence en toda su organización), agentes personalizados (crear agentes diseñados específicamente que se basan en su documentación de Confluence como fuente de conocimiento), Quick Flows (automatizar flujos de trabajo que hacen referencia o actualizar el contenido de Confluence) y Quick Research (ejecutar informes de análisis en profundidad basados en su base de conocimientos de Confluence). Esto significa que una única configuración de base de conocimientos desbloquea valor en toda la gama de capacidades Quick que su equipo utiliza todos los días.
Para agregar la integración de acciones recién configurada a su Quick Space, navegue hasta el botón Acciones y elija Agregar acciones.
Después de agregar ambos recursos, verá la base de conocimientos y la integración de acciones en la sección Todo el conocimiento del Espacio rápido.
Ahora que ha agregado con éxito tanto la base de conocimientos como la acción a su Quick Space, es hora de interactuar con Confluence Cloud usando Quick Spaces.
Usar Quick Spaces para interactuar con Confluence Cloud
Para usar este espacio y hacer preguntas sobre el contenido en Confluence Cloud configurado, elija el ícono Abrir chat en su navegador desde cualquier lugar en Quick.
En la ventana de chat, observe que su Confluence Cloud Space configurado ya está seleccionado y listo para responder sus preguntas.
Ahora puedes empezar a hacer preguntas sobre tu contenido de Confluence Cloud. Para demostrar esta funcionalidad, usaré una publicación de blog de prueba sobre la integración Confluence-Quick. Cuando envía una pregunta, Quick proporciona una respuesta detallada a su consulta, junto con referencias de fuentes de la información. Puede elegir el botón Fuentes para ver de dónde sacó Quick la información. En este ejemplo, notarás que la fuente es singular y apunta a nuestra página de prueba de Confluence.
Realizar acciones en páginas de Confluence
Con las acciones de Confluence, puedes crear, actualizar y administrar páginas, espacios y otros objetos de Confluence directamente a través de Quick. Con estas capacidades de acción, puede optimizar las tareas de administración de contenido sin salir de su entorno Quick. Para realizar acciones de Confluence, puedes preguntar en la ventana de chat qué acciones están disponibles. Quick proporciona una lista de acciones admitidas y los espacios de Confluence a los que tiene acceso.
Un buen caso de uso para realizar acciones es utilizar respuestas generadas de múltiples fuentes y publicar una respuesta consolidada en Confluence. En el siguiente ejemplo, una consulta sobre todas las integraciones admitidas por Amazon Quick proviene de Internet, ya que este contenido no existe en el espacio de Confluence adjunto.
Cuando le pide a Quick que publique el contenido anterior en su espacio de Confluence, presenta una tarjeta de revisión de Solicitud de acción con botones Permitir y Denegar y una opción de Formulario de revisión para inspeccionar los detalles de la página antes de aprobar la solicitud.
Revise los detalles de la página en el formulario Crear página, incluido el título de la página, el ID del espacio y el contenido. Tenga en cuenta que Quick seleccionó una ID de espacio predeterminada según su conversación anterior y proporcionó un título de página. Verifique que los detalles sean correctos y elija Permitir publicar el contenido en Confluence.
Si la creación de la página se realiza correctamente, Quick proporciona una respuesta de éxito junto con los detalles de la creación de la página y un enlace URL directo a la página recién creada en su espacio de Confluence Cloud.
Puedes confirmar la creación de la página en tu Confluence Cloud Space. Quick conserva automáticamente el formato de la respuesta al crear la página en Confluence, incluidos encabezados, listas y contenido estructurado, lo que elimina la necesidad de realizar trabajos de formato manual.
Solución de problemas y preguntas frecuentes
Para obtener información sobre cómo solucionar problemas de su conector, consulte Solución de problemas de integración de Atlassian Confluence. Consulte Preguntas frecuentes rápidas para conocer las preguntas más frecuentes.
Conclusión
La integración de Confluence Cloud demuestra cómo Quick aborda la gestión del conocimiento empresarial. Al combinar la búsqueda semántica a través de bases de conocimiento con operaciones específicas a través de Acciones, puede buscar, recuperar y actualizar el contenido de Confluence utilizando lenguaje natural mientras accede a datos de otros sistemas integrados. A medida que las organizaciones generan y dependen de más datos, Quick ayuda a los equipos a encontrar, conectar y actuar en base a la información de manera más eficiente. ¿Está listo para mejorar la gestión del conocimiento empresarial? Explore las capacidades de Quick al:
Para obtener orientación de implementación detallada y mejores prácticas, visite la Guía rápida del usuario.