View a markdown version of this page

Integración de la base de conocimiento de Atlassian Confluence Cloud - Amazon Quick
Antes de empezarAutenticaciónConfigure la integración de la base de conocimientosTipos de contenido admitidosControles de accesoGestione las bases de conocimientoSolución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración de la base de conocimiento de Atlassian Confluence Cloud

Usa la integración de la base de conocimiento de Confluence Cloud de Atlassian para indexar el contenido de Confluence de forma que los agentes de Amazon Quick puedan buscarlo y responder a sus preguntas.

Antes de empezar

Asegúrate de tener lo siguiente antes de configurar la integración.

Autenticación

Para las integraciones de bases de conocimiento, Amazon Quick gestiona la autenticación mediante un flujo emergente durante la configuración. Siga estos pasos:

  1. Completa la ventana emergente de autenticación de Confluence Cloud que aparece.

  2. Concede permisos a Amazon Quick para acceder a tu contenido de Confluence.

  3. Revisa y completa el proceso de autenticación.

Configure la integración de la base de conocimientos

  1. En la consola Amazon Quick, selecciona Integraciones.

  2. Elige Atlassian Confluence Cloud y pulsa el botón Añadir (más «+»).

  3. En el cuadro de diálogo Crear la base de conocimientos de Confluence, en Cuenta conectada, rellena los siguientes campos:

    • Nombre: un nombre descriptivo para tu integración de acceso a datos.

    • URL de Confluence: la URL de tu sitio de Atlassian (por ejemplo,). your-site.atlassian.net

  4. Selecciona Iniciar sesión y completa el flujo de autenticación de Confluence Cloud en la ventana emergente.

  5. En Crear base de conocimientos, completa los siguientes campos:

    • Nombre: un nombre para la base de conocimientos.

    • Descripción (opcional): notas sobre cómo se utilizará la base de conocimientos.

  6. En Contenido, pega URLs los espacios, blogs o páginas de Confluence que quieras incluir. Selecciona Añadir después de cada URL.

    nota

    URLs las que siguen la estructura https://company.atlassian.net/wiki/spaces/space-key/overview se tratan como páginas URLs.

  7. Seleccione Crear.

Tipos de contenido admitidos

  • Páginas y publicaciones de blog de Confluence

  • Contenido de Spaces

  • Archivos adjuntos de páginas y blogs

Controles de acceso

importante

Amazon Quick no sincroniza las listas de control de acceso (ACLs) de las fuentes de datos. Cuando crea una base de conocimientos en Amazon Quick, de forma predeterminada, solo usted puede obtener información de la base de conocimientos. En el caso del contenido compartido, puede proporcionar acceso a diferentes usuarios y grupos actualizando los permisos de la base de conocimientos.

Gestione las bases de conocimiento

Edite las bases de conocimiento existentes

  1. En la consola Amazon Quick, selecciona Bases de conocimiento.

  2. Selecciona tu base de conocimientos de Confluence Cloud de la lista.

  3. Selecciona el icono de tres puntos en Acciones y, a continuación, selecciona Editar base de conocimientos.

  4. Actualice los ajustes de configuración según sea necesario y seleccione Guardar.

Solución de problemas

Para editar, compartir o eliminar la integración, consulteAdministrar las integraciones existentes.

Para obtener información general sobre la solución de problemas de la base de conocimientos, incluidos los problemas de sincronización y la falta de documentos, consulteBases de conocimiento para la solución.

Autorización de OAuth aplicaciones bloqueadas

Síntomas:

  • Mensaje de error: «El administrador del sitio debe autorizar esta aplicación para el sitio instance-name .atlassian.net para que la aplicación pueda acceder a tu cuenta».

  • Hacer clic en Aceptar en el cuadro de diálogo de consentimiento no tiene ningún efecto.

Causa:

El administrador de tu sitio de Atlassian ha bloqueado las aplicaciones instaladas por los usuarios OAuth . Cuando esta configuración está habilitada, solo el administrador del sitio o la organización puede autorizar nuevas aplicaciones de terceros.

Pasos de resolución:

Usa una de las siguientes opciones para resolver este problema.

  • Opción 1 (recomendada): el administrador autoriza la aplicación directamente

    1. Un administrador del sitio de Atlassian navega a Amazon Quick e inicia una nueva configuración de base de conocimientos con Confluence Cloud.

    2. Como el administrador tiene permisos a nivel de sitio, aparece una pantalla de consentimiento limpio sin errores.

    3. El administrador selecciona Aceptar para instalar la aplicación.

    Una vez que el administrador autorice la aplicación, todos los demás usuarios del sitio pueden conectarse sin problemas.

  • Opción 2: Permitir temporalmente las aplicaciones instaladas por el usuario: un administrador va a Appsadmin.atlassian.com, Atlassian Apps, navega hasta ellas y, a continuación, elige el enlace para las aplicaciones de terceros y Marketplace. En Configuración, busca las aplicaciones instaladas por el usuario y activa esta opción para permitir las aplicaciones de los usuarios. Una vez que el usuario autorice Amazon Quick, vuelve a cambiar la configuración para bloquear las aplicaciones del usuario.

importante

La autorización de administrador se aplica a cada sitio de Atlassian, no a cada organización. Si tu empresa tiene varios sitios (por ejemplo, team-a.atlassian.net yteam-b.atlassian.net), cada sitio requiere una autorización independiente.

nota

Si bien las aplicaciones instaladas por el usuario están desbloqueadas (opción 2), cualquier usuario del sitio puede autorizar cualquier OAuth aplicación. Vuelva a activar el bloqueo inmediatamente después de que el usuario se haya conectado.

La ventana emergente de autenticación falla

Síntomas:

  • La ventana emergente de autenticación no aparece o se cierra inmediatamente.

  • Aparece una ventana emergente pero no completa el OAuth flujo.

Pasos de resolución:

  1. Comprueba que tu navegador permite ventanas emergentes del dominio de Amazon Quick console.

  2. Comprueba que se pueda acceder a tu instancia de Confluence Cloud desde la red.

  3. Prueba a utilizar otro navegador o a borrar la memoria caché del navegador.

Falta contenido en la base de conocimientos

Síntomas:

  • Se ha completado la sincronización de la base de conocimientos, pero el contenido esperado no está indexado.

  • Los resultados de la búsqueda no incluyen contenido de páginas o espacios específicos.

  • Solo se indexa un documento para todo un espacio.

Pasos de resolución:

  1. Comprueba que el usuario de Confluence Cloud que se autenticó tiene acceso a los espacios y las páginas que seleccionaste durante la configuración.

  2. Comprueba que los tipos de contenido seleccionados sean compatibles (páginas, publicaciones de blog y archivos adjuntos).

  3. Revise la selección de contenido en la configuración de la base de conocimientos para confirmar que se incluyen los espacios y las páginas correctos.

  4. Comprueba el /overview sufijo en tu Confluence URLs . URLs las que terminan con /wiki/spaces/space-key/overview se tratan como una URL de una sola página, no como un espacio completo. Si pretendía indexar todo el espacio, utilice la URL del espacio sin /overview (por ejemplo,https://company.atlassian.net/wiki/spaces/space-key).