Pourquoi mon expérience Web Amazon Q Business renvoie-t-elle le message d'erreur « Sorry, I could not find relevant information to complete your request » (Désolé, je n'ai pas trouvé d'informations pertinentes pour traiter votre requête) ?

Résolution

Le message d'erreur « Sorry, I could not find relevant information to complete your request » (Désolé, je n'ai pas trouvé d'informations pertinentes pour traiter votre requête) peut s'afficher pour les raisons suivantes :

• Vous utilisez des instructions incorrectes pour le document.
• Il existe des problèmes de liste de contrôle d'accès (ACL) pour le document.

Vérifier si les instructions sont valides

Amazon Q Business ne renvoie pas de réponses aux méta-invites ou aux invites d'agrégation et ne vous permet pas d'interroger des documents ou des projets spécifiques par ID ou nom.

Par exemple, Amazon Q Business ne peut pas répondre aux invites suivantes :

• « Combien de tickets sont actuellement ouverts ? »
• « Imprimez la liste de tickets Jira liés à mon projet. »
• « Quelles sources de données ont été indexées ? »
• « Que contiennent les données ? »

Lorsque vous envoyez une requête similaire à « Trouvez le document sur le projet XYZ et résumez-le », Amazon Q Business ne trouve pas le document en question. Toutefois, Amazon Q Business peut répondre avec tous les documents qui mentionnent le projet XYZ, puis en résumer le contenu.

Créer des invites qui ciblent des documents spécifiques

Lorsque vous structurez votre invite, il est recommandé d'utiliser les éléments structuraux suivants :

• Demande principale : L'action ou les informations que vous souhaitez qu'Amazon Q Business fournisse.
• Contexte : Le contexte supplémentaire dont Amazon Q Business peut avoir besoin pour traiter la requête.
• Données d'entrée : Points de données supplémentaires susceptibles d'influencer la réponse.
• Demande de sortie : Format dans lequel vous souhaitez qu'Amazon Q Business fournisse la réponse.

L'exemple d'invite suivant utilise un fichier PDF du manuel d'utilisation d'un ordinateur portable Windows comme source de données :

« Quelles sont les étapes de dépannage pour un ordinateur portable Windows qui ne parvient pas à se connecter au Wi-Fi ? J'ai essayé de le mettre à jour et de réinitialiser les pilotes Wi-Fi, mais les problèmes persistent. Formatez les étapes sous forme de puces. »

L'invite précédente contient les quatre éléments suivants :

• Demande principale : Quelles sont les étapes de dépannage
• Contexte : Pour un ordinateur portable Windows qui ne peut pas se connecter au Wi-Fi
• Données d'entrée : J'ai essayé de le mettre à jour et de réinitialiser les pilotes Wi-Fi, mais les problèmes persistent
• Demande de sortie : Formater les étapes sous forme de puces

Remarque : Pour consulter des exemples d'invites, activez les invites rapides dans Amazon Q Business.

Pour créer des invites ciblant des documents spécifiques, procédez comme suit :

1. Ouvrez la console Amazon Q Business.
2. Dans le volet de navigation, choisissez Applications, puis sélectionnez le nom de votre application.
3. Sous Améliorations, choisissez Sources de données.
4. Dans Source de données, recherchez le nom de votre source de données et vérifiez que le statut de la dernière synchronisation est Terminé.
5. Sous Index, vérifiez l'attribut Nombre de documents pour confirmer que vous avez ajouté des documents à l'index.
6. Consultez le rapport historique des exécutions de synchronisation pour vous assurer que votre document est synchronisé.
7. Créez des invites spécifiques aux informations contenues dans le corps du document.
8. Envoyez votre invite à Amazon Q Business, puis attendez une réponse.
9. Pour vérifier qu'Amazon Q Business fait référence au document approprié, vérifiez la citation renvoyée par Amazon Q Business dans la réponse.

Vérifier les ACL des documents

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Si vous utilisez des invites valides et que l'erreur persiste, vérifiez les ACL de vos documents sources. Lorsque vous activez les listes de contrôle d'accès pour votre connecteur, Amazon Q Business renvoie uniquement les documents qui incluent votre nom d'utilisateur dans l'ACL du document.

Remarque : Vous pouvez désactiver les ACL. Cependant, vous devez supprimer la source de données et la recréer.

Pour vérifier que vos documents source apparaissent dans les listes de contrôle d'accès, procédez comme suit :

1. Ouvrez la console Amazon Q Business.
2. Dans le volet de navigation, choisissez Applications, puis sélectionnez le nom de votre application.
3. Dans le volet de navigation, sous Améliorations, sélectionnez Sources de données.
4. Sous Source de données, recherchez le nom de votre source de données, puis sélectionnez votre source de données.
5. Choisissez l'onglet Historique des exécutions de synchronisation, puis choisissez Afficher le rapport dans la colonne Actions pour ouvrir un nouvel onglet pour Amazon CloudWatch Logs Insights.
6. Sélectionnez Exécuter la requête.
7. Recherchez votre document source dans le rapport, puis vérifiez la colonne ACL pour les ACL de votre document.
8. Vérifiez l'ACL pour vous assurer que votre nom d'utilisateur correspond à votre adresse e-mail dans AWS IAM Identity Center.
9. Si le nom d'utilisateur et l'ID d’e-mail ne correspondent pas, mettez à jour votre alias dans le magasin d’identifiants pour inclure le nom d'utilisateur de l'ACL. Exécutez la commande update-user de l'interface de ligne de commande AWS :

   aws qbusiness update-user \
     --application-id your_q_business_application_id \
     --user-id your_q_business_user_email \
     --user-aliases-to-update '[{"userId": "your_user_id_from_data_source"}]'

   Remarque : Remplacez your_q_business_application_id par l'ID de votre application, your_q_business_user_email par votre adresse e-mail utilisateur et your_user_id_from_data_source par votre ID utilisateur provenant de votre source de données.
10. (Facultatif) Pour vérifier que votre alias a été mis à jour, exécutez la commande get-user de l'interface de ligne de commande AWS :

aws qbusiness get-user --application-id your_q_business_application_id --user-id your_q_business_user_email

Remarque : Remplacez your_q_business_application_id par l'ID de votre application, et your_q_business_user_email par votre adresse e-mail utilisateur. Synchronisez votre source de données pour mettre à jour les ACL de vos documents.