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. Amazon Quick admite controles de acceso opcionales a nivel de documento (ACLs) para las bases de conocimiento de Confluence. Cuando está habilitada, los usuarios solo ven las respuestas de los documentos a los que están autorizados a acceder en Confluence. Para obtener más información, consulte Controles de acceso a nivel de documento.
Antes de empezar
Asegúrate de tener lo siguiente antes de configurar la integración.
-
Una instancia de Confluence Cloud de Atlassian.
-
Para conocer los requisitos de suscripción rápida, consulte. Configurar las integraciones en la consola
Si planeas habilitar los controles de acceso a nivel de documento, debes proporcionar las credenciales de administrador de Atlassian durante la configuración. Estas credenciales permiten a Amazon Quick acceder a toda la información de los usuarios y grupos, independientemente de la configuración individual de visibilidad del correo electrónico. Sin las credenciales de administrador, la opción ACL no está disponible durante la creación de la base de conocimientos. Para proporcionar las credenciales de administrador, necesitas lo siguiente del administrador de tu organización de Atlassian:
-
Clave de la API de administración de Atlassian: cadena alfanumérica generada en el portal de administración de Atlassian.
-
ID de organización (UUID): el identificador único de tu organización de Atlassian. Puedes encontrarlo en la URL de tu navegador cuando inicies sesión en el portal de administración:.
admin.atlassian.com/o/orgId -
ID de directorio (UUID): el identificador único de su directorio de usuarios. Recupera este valor mediante la API Atlassian Admin Workspace.
Para ver los pasos detallados para obtener estas credenciales, consulte. Obtenga las credenciales de administrador de Atlassian
Configure la integración de la base de conocimientos
El asistente de configuración consta de tres pasos: autenticación, creación de la base de conocimientos y ajustes adicionales.
Autentica tu cuenta
-
En la consola Amazon Quick, selecciona Integraciones.
-
En Knowledge, selecciona Atlassian Confluence Cloud y pulsa el botón Añadir (con el signo «+»).
-
En el cuadro de diálogo Crear la base de conocimientos de Confluence, en Método de autenticación, selecciona una cuenta conectada existente en el menú desplegable Nombre o selecciona Añadir cuenta para crear una nueva conexión.
-
Si vas a añadir una cuenta nueva, completa los siguientes campos:
-
Nombre: un nombre descriptivo para la conexión.
-
Descripción (opcional): notas sobre la conexión.
-
URL de Confluence: la URL de tu sitio de Atlassian (por ejemplo,).
https://your-site.atlassian.net
-
-
(Opcional) En Administración de ACL, selecciona Usar credenciales de administrador de Atlassian para proporcionar las credenciales de administrador de Atlassian. Cuando esté seleccionada, introduce lo siguiente:
-
Clave de API: la clave de API de administración de Atlassian.
-
OrganizationID (UUID): tu ID de organización de Atlassian.
-
ID de directorio (UUID): tu ID de directorio de usuarios de Atlassian.
importante
Las credenciales de administrador de Atlassian son necesarias para habilitar los controles de acceso a nivel de documento () en la configuración adicional. ACLs Sin credenciales de administrador, la opción ACL está deshabilitada. Las credenciales de administrador no se pueden agregar una vez creada la base de conocimientos. Para ver los pasos para obtener estas credenciales, consulteObtenga las credenciales de administrador de Atlassian.
-
-
Elija Siguiente.
-
Complete la ventana emergente de autenticación de Confluence Cloud que aparece. Revisa los permisos solicitados y selecciona Aceptar para autorizar a Amazon Quick a acceder a tu contenido de Confluence.
Crea la base de conocimientos
-
En Crear base de conocimientos, introduzca un nombre para la base de conocimientos.
-
(Opcional) Introduzca una descripción con notas sobre cómo se utilizará la base de conocimientos.
-
En Confluence URLs, pega URLs los espacios, blogs o páginas de Confluence que quieras incluir. Selecciona Añadir después de cada URL.
nota
URLs que siguen la estructura
https://se tratan como página URLs, no como espacio URLs. Para indexar un espacio completo, utilice la URL del espacio sincompany.atlassian.net/wiki/spaces/space-key/overview/overview(por ejemplo,https://).company.atlassian.net/wiki/spaces/space-key -
Seleccione Siguiente: ajustes adicionales para configurar los controles de acceso y las opciones de indexación, o bien elija Crear para crear la base de conocimientos con los ajustes predeterminados.
Configure ajustes adicionales
-
Para activar los controles de acceso a nivel de documento, selecciona Controlar el acceso a los documentos con. ACLs Esta opción solo está disponible si has proporcionado las credenciales de administrador de Atlassian en el método de autenticación. Cuando está habilitada, Amazon Quick sincroniza las listas de control de acceso de Confluence y verifica los permisos de cada usuario en el momento de la consulta. Para obtener más información sobre cómo funcionan los controles de acceso, consulte. Controles de acceso a nivel de documento
Si no los habilita ACLs, el acceso se controla a nivel de la base de conocimientos. Cualquier persona que tenga acceso a la base de conocimientos puede obtener información de todo el contenido que contiene. Cuando ACLs están activadas, el acceso se controla a nivel de documento. Los usuarios que tienen acceso a la base de conocimientos solo ven las respuestas de los documentos a los que están autorizados a acceder en Confluence.
importante
La administración de las ACL no se puede cambiar una vez creada la base de conocimientos. Si necesita cambiar esta configuración, debe crear una nueva base de conocimientos.
nota
Si no has proporcionado las credenciales de administrador de Atlassian en el método de autenticación, esta opción está desactivada. Para activarlo ACLs, selecciona Retroceder o cancelar el asistente y vuelve a empezar con una cuenta conectada que incluya credenciales de administrador.
-
En Contenido multimedia, tamaño y patrones de archivos, configure las siguientes opciones de indexación según sea necesario:
-
Contenido visual en los documentos: indexe el contenido visual, como imágenes y gráficos, incrustados en los documentos.
-
Archivos de audio: indexe los archivos adjuntos de audio.
-
Archivos de vídeo: indexe los archivos de vídeo adjuntos.
-
Tamaño máximo de un archivo: el tamaño máximo de archivo para los archivos adjuntos individuales (predeterminado: 50 MB).
-
-
Seleccione Crear.
Tipos de contenido admitidos
Páginas y publicaciones de blog de Confluence
Archivos adjuntos de páginas y publicaciones de blog
Cuando añades la URL de un espacio de Confluence, Amazon Quick rastrea todas las páginas y entradas de blog de ese espacio. Para conocer los tipos de archivos adjuntos y los límites de tamaño admitidos, consulte. Límites de tamaño y contenido de los archivos
Gestione las bases de conocimiento
Edite las bases de conocimiento existentes
-
En la consola Amazon Quick, selecciona Bases de conocimiento.
-
Selecciona tu base de conocimientos de Confluence Cloud de la lista.
-
Selecciona el icono de tres puntos en Acciones y, a continuación, selecciona Editar base de conocimientos.
-
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».Elegir 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
Un administrador del sitio de Atlassian navega a Amazon Quick e inicia una nueva configuración de base de conocimientos con Confluence Cloud.
Como el administrador tiene permisos a nivel de sitio, aparece una pantalla de consentimiento limpio sin errores.
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 Apps
admin.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:
Comprueba que tu navegador permite ventanas emergentes del dominio de Amazon Quick console.
Comprueba que se pueda acceder a tu instancia de Confluence Cloud desde la red.
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:
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.
Comprueba que los tipos de contenido seleccionados sean compatibles (páginas, publicaciones de blog y archivos adjuntos).
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.
-
Comprueba si tienes el
/overviewsufijo en Confluence URLs . URLs las que terminan con/wiki/spaces/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 sinspace-key/overview/overview(por ejemplo,https://).company.atlassian.net/wiki/spaces/space-key
Problemas relacionados con la ACL
No hay resultados de la base de conocimientos habilitada para ACL
Comprueba que el usuario final haya iniciado sesión en Confluence cuando se le pregunte durante su primera consulta. Es necesario iniciar sesión para verificar los permisos en tiempo real.
Comprueba que el usuario final tenga acceso al contenido de Confluence correspondiente en su instancia de Confluence.
Documentos omitidos durante la sincronización
Si los informes de sincronización muestran elementos con el estado OMITIDO, comprueba que el usuario que realiza la autenticación tenga acceso a los espacios y páginas de Confluence incluidos en la base de conocimientos.
Para obtener más información sobre la verificación del acceso a los documentos, consulte. Compruebe el acceso a los documentos (verificación ACL)
