Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration à la base de connaissances Atlassian Confluence Cloud
Utilisez l'intégration de la base de connaissances Atlassian Confluence Cloud pour indexer le contenu Confluence afin que les agents Amazon Quick puissent effectuer des recherches et répondre à des questions à ce sujet. Amazon Quick prend en charge les contrôles d'accès facultatifs au niveau des documents (ACL) pour les bases de connaissances Confluence. Lorsque cette option est activée, les utilisateurs ne voient que les réponses des documents auxquels ils sont autorisés à accéder dans Confluence. Pour de plus amples informations, veuillez consulter Document-level contrôles d'accès.
Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
-
Une instance Atlassian Confluence Cloud.
-
Pour les exigences relatives à l'abonnement Quick, voirConfiguration des intégrations dans la console.
Si vous prévoyez d'activer les contrôles d'accès au niveau des documents, vous devez fournir des informations d'identification d'administrateur Atlassian lors de la configuration. Ces informations d'identification permettent à Amazon Quick d'accéder à toutes les informations des utilisateurs et des groupes, quels que soient les paramètres de visibilité des e-mails individuels. Sans informations d'identification d'administrateur, l'option ACL n'est pas disponible lors de la création de la base de connaissances. Pour fournir des informations d'identification d'administrateur, vous avez besoin des informations suivantes auprès de l'administrateur de votre organisation Atlassian :
-
Clé d'API d'administration Atlassian : chaîne alphanumérique générée sur le portail d'administration Atlassian.
-
ID d'organisation (UUID) : identifiant unique de votre organisation Atlassian. Vous pouvez le trouver dans l'URL de votre navigateur lorsque vous êtes connecté au portail d'administration :
admin.atlassian.com/o/.orgId -
ID de répertoire (UUID) : identifiant unique de votre annuaire d'utilisateurs. Récupérez cette valeur à l'aide de l'API Atlassian Admin Workspace.
Pour connaître les étapes détaillées permettant d'obtenir ces informations d'identification, consultezObtenir les informations d'identification d'administrateur Atlassian.
Configuration de l'intégration de la base de connaissances
L'assistant de configuration comporte trois étapes : authentification, création de la base de connaissances et paramètres supplémentaires.
Authentifiez votre compte
-
Dans la console Amazon Quick, sélectionnez Knowledge.
-
Sous Knowledge, choisissez Atlassian Confluence Cloud et cliquez sur le bouton Ajouter (plus « + »).
-
Dans la boîte de dialogue Créer la base de connaissances Confluence, sous Méthode d'authentification, choisissez un compte connecté existant dans le menu déroulant Nom, ou choisissez Ajouter un compte pour créer une nouvelle connexion.
-
Si vous ajoutez un nouveau compte, complétez les champs suivants :
-
Nom : nom descriptif de votre connexion.
-
Description (facultatif) — Remarques concernant la connexion.
-
URL de confluence : URL de votre site Atlassian (par exemple,).
https://your-site.atlassian.net
-
-
(Facultatif) Sous Gestion des ACL, sélectionnez Utiliser les informations d'identification d'administrateur Atlassian pour fournir les informations d'identification d'administrateur Atlassian. Lorsque cette option est sélectionnée, entrez les informations suivantes :
-
Clé d'API : clé d'API d'administration Atlassian.
-
OrganizationID (UUID) — L'identifiant de votre organisation Atlassian.
-
ID de répertoire (UUID) : votre identifiant d'annuaire d'utilisateurs Atlassian.
Important
Les informations d'identification d'administrateur Atlassian sont requises pour activer les contrôles d'accès (ACL) au niveau du document dans Paramètres supplémentaires. Sans informations d'identification d'administrateur, l'option ACL est désactivée. Les informations d'identification d'administrateur ne peuvent pas être ajoutées une fois la base de connaissances créée. Pour connaître les étapes à suivre pour obtenir ces informations d'identification, consultezObtenir les informations d'identification d'administrateur Atlassian.
-
-
Choisissez Suivant.
-
Complétez la fenêtre contextuelle d'authentification Confluence Cloud qui s'affiche. Vérifiez les autorisations demandées et choisissez Accepter pour autoriser Amazon Quick à accéder à votre contenu Confluence.
Création de la base de connaissances
-
Sous Créer une base de connaissances, entrez le nom de votre base de connaissances.
-
(Facultatif) Entrez une description avec des notes sur la manière dont la base de connaissances sera utilisée.
-
Sous URL Confluence, collez les URL des espaces, blogs ou pages Confluence que vous souhaitez inclure. Choisissez Ajouter après chaque URL.
Note
Les URL qui suivent la structure
https://sont traitées comme des URL de page et non comme des URL d'espace. Pour indexer un espace entier, utilisez l'URL de l'espace sanscompany.atlassian.net/wiki/spaces/space-key/overview/overview(par exemple,https://).company.atlassian.net/wiki/spaces/space-key -
Choisissez Suivant : paramètres supplémentaires pour configurer les contrôles d'accès et les options d'indexation, ou choisissez Créer pour créer la base de connaissances avec les paramètres par défaut.
Configurer des paramètres supplémentaires
-
Pour activer les contrôles d'accès au niveau des documents, sélectionnez Contrôler l'accès aux documents avec des ACL. Cette option n'est disponible que si vous avez fourni des informations d'identification d'administrateur Atlassian dans Méthode d'authentification. Lorsque cette option est activée, Amazon Quick synchronise les listes de contrôle d'accès de Confluence et vérifie les autorisations de chaque utilisateur au moment de la requête. Pour plus d'informations sur le fonctionnement des contrôles d'accès, consultezDocument-level contrôles d'accès.
Si vous n'activez pas les ACL, l'accès est contrôlé au niveau de la base de connaissances. Toute personne ayant accès à la base de connaissances peut obtenir des informations à partir de l'ensemble de son contenu. Lorsque les ACL sont activées, l'accès est contrôlé au niveau du document. Les utilisateurs qui ont accès à la base de connaissances ne voient que les réponses des documents auxquels ils sont autorisés à accéder dans Confluence.
Important
La gestion des ACL ne peut pas être modifiée une fois la base de connaissances créée. Si vous devez modifier ce paramètre, vous devez créer une nouvelle base de connaissances.
Note
Si vous n'avez pas fourni d'informations d'identification d'administrateur Atlassian dans la méthode d'authentification, cette option est désactivée. Pour activer les ACL, choisissez Retour ou annulez l'assistant et recommencez avec un compte connecté incluant des informations d'identification d'administrateur.
-
Sous Multi-media Contenu, taille de fichier et modèles de fichiers, configurez les options d'indexation suivantes selon vos besoins :
-
Contenu visuel dans les documents — Indexez le contenu visuel tel que les images et les graphiques intégrés aux documents.
-
Fichiers audio — Indexez les pièces jointes des fichiers audio.
-
Fichiers vidéo — Indexez les pièces jointes aux fichiers vidéo.
-
Taille maximale d'un seul fichier : taille de fichier maximale pour les pièces jointes individuelles (par défaut : 50 Mo).
-
-
Choisissez Créer.
Types de contenu pris en charge
Pages et articles de blog de Confluence
Pièces jointes à des pages et à des articles de blog
Lorsque vous ajoutez l'URL d'un espace Confluence, Amazon Quick explore toutes les pages et tous les articles de blog contenus dans cet espace. Pour connaître les types de pièces jointes pris en charge et les limites de taille, consultezLimites de taille et de contenu des fichiers.
Gérer les bases de connaissances
Modifier les bases de connaissances existantes
-
Dans la console Amazon Quick, sélectionnez Knowledge bases.
-
Sélectionnez votre base de connaissances Confluence Cloud dans la liste.
-
Cliquez sur l'icône à trois points sous Actions, puis sélectionnez Modifier la base de connaissances.
-
Mettez à jour vos paramètres de configuration selon vos besoins et choisissez Enregistrer.
Dépannage
Pour modifier, partager ou supprimer votre intégration, consultezGestion des intégrations existantes.
Pour la résolution des problèmes généraux liés à la base de connaissances, notamment les problèmes de synchronisation et les documents manquants, consultezBases de connaissances sur le dépannage.
Autorisation de l'application OAuth bloquée
Symptômes :
Message d'erreur : « L'administrateur de votre site doit autoriser cette application pour le site
instance-name.atlassian.net avant que l'application puisse accéder à votre compte. »Choisir Accepter dans la boîte de dialogue de consentement n'a aucun effet.
Cause :
L'administrateur de votre site Atlassian a bloqué les applications OAuth installées par l'utilisateur. Lorsque ce paramètre est activé, seul un administrateur de site ou d'organisation peut autoriser de nouvelles applications tierces.
Étapes de résolution :
Utilisez l'une des options suivantes pour résoudre ce problème.
-
Option 1 (recommandée) : l'administrateur autorise directement l'application
Un administrateur de site Atlassian accède à Amazon Quick et lance une nouvelle configuration de base de connaissances avec Confluence Cloud.
Comme l'administrateur dispose d'autorisations au niveau du site, un écran de consentement clair apparaît sans erreur.
L'administrateur choisit Accepter pour installer l'application.
Une fois que l'administrateur a autorisé l'application, tous les autres utilisateurs du site peuvent se connecter sans problème.
-
Option 2 : autoriser temporairement les applications installées par l'utilisateur : un administrateur accède à Apps
admin.atlassian.com, Atlassian Apps, puis choisit le lien vers les applications tierces et Marketplace. Sous Paramètres, recherchez Applications installées par l'utilisateur et activez l'option Autoriser les applications utilisateur. Une fois que l'utilisateur a autorisé Amazon Quick, rétablissez le paramètre pour bloquer les applications utilisateur.
Important
L'autorisation d'administrateur s'applique par site Atlassian, et non par organisation. Si votre entreprise possède plusieurs sites (par exemple, team-a.atlassian.net etteam-b.atlassian.net), chaque site nécessite une autorisation distincte.
Note
Lorsque les applications installées par l'utilisateur sont débloquées (option 2), tout utilisateur du site peut autoriser n'importe quelle application OAuth. Re-enable le bloquer rapidement une fois que l'utilisateur s'est connecté.
La fenêtre contextuelle d'authentification échoue
Symptômes :
La fenêtre contextuelle d'authentification ne s'affiche pas ou se ferme immédiatement.
Une fenêtre contextuelle apparaît mais ne parvient pas à terminer le flux OAuth.
Étapes de résolution :
Vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick.
Vérifiez que votre instance Confluence Cloud est accessible depuis votre réseau.
Essayez d'utiliser un autre navigateur ou de vider le cache de votre navigateur.
Contenu manquant dans la base de connaissances
Symptômes :
La synchronisation de la base de connaissances est terminée mais le contenu attendu n'est pas indexé.
Les résultats de recherche n'incluent pas le contenu provenant d'espaces ou de pages spécifiques.
Un seul document est indexé pour un espace entier.
Étapes de résolution :
Vérifiez que l'utilisateur de Confluence Cloud qui s'est authentifié a accès aux espaces et aux pages que vous avez sélectionnés lors de la configuration.
Vérifiez que les types de contenu sélectionnés sont pris en charge (pages, articles de blog et pièces jointes).
Passez en revue la sélection de contenu dans la configuration de votre base de connaissances pour vous assurer que les espaces et les pages appropriés sont inclus.
-
Vérifiez la présence du suffixe dans vos URL Confluence.
/overviewLes URL qui se/wiki/spaces/terminent par sont traitées comme une URL de page unique, et non comme un espace complet. Si vous aviez l'intention d'indexer la totalité de l'espace, utilisez l'URL de l'espace sansspace-key/overview/overview(par exemple,https://).company.atlassian.net/wiki/spaces/space-key
ACL-related problèmes
Aucun résultat de la base de ACL-enabled connaissances
Vérifiez que l'utilisateur final s'est connecté à Confluence lorsqu'il y est invité lors de sa première requête. La connexion est requise pour la vérification des autorisations en temps réel.
Vérifiez que l'utilisateur final a accès au contenu Confluence pertinent dans son instance Confluence.
Documents ignorés lors de la synchronisation
Si les rapports de synchronisation indiquent des éléments dont le statut est IGNORÉ, vérifiez que l'utilisateur authentifié a accès aux espaces et aux pages Confluence inclus dans la base de connaissances.
Pour plus d'informations sur la vérification de l'accès aux documents, consultezVérifier l'accès aux documents (vérification ACL).
