为什么我的 Amazon Q Business Web 体验返回错误消息“抱歉，我找不到相关信息来完成您的请求”？

解决方法

出现错误消息“抱歉，我找不到相关信息来完成您的请求”可能是由于以下原因造成的：

• 您在文档中使用了错误的提示。
• 该文档存在访问控制列表 (ACL) 问题。

检查提示是否有效

Amazon Q Business 不返回对元数据或聚合提示的响应，也不允许您按 ID 或名称查询特定文档或项目。

例如，Amazon Q Business 无法响应以下提示：

• “目前有多少票证是开放的？”
• “打印与我的项目相关的 Jira 票证列表。”
• “对哪些数据来源进行了索引？”
• “数据中包含什么？”

当您发送类似于“在 XYZ 项目中查找文档并对其进行汇总”的查询时，Amazon Q Business 找不到具体的文档。但是，Amazon Q Business 可能会回复所有提及 XYZ 项目的文档，然后汇总内容。

创建针对特定文档的提示

在构造提示时，最佳做法是使用以下结构元素：

• 主要任务： 您希望 Amazon Q Business 提供的操作或信息。
• 上下文： Amazon Q Business 完成请求可能需要的其他上下文。
• 输入数据： 可能影响响应的其他数据点。
• 输出请求： 您希望 Amazon Q Business 提供响应的格式。

以下示例提示使用 Windows 笔记本电脑用户手册 PDF 文件作为数据来源：

“对于无法连接到 Wi-Fi 的 Windows 笔记本电脑，故障排除步骤是什么？ 我尝试更新它并重置 Wi-Fi 驱动程序，但问题仍然存在。将步骤设置为项目符号列表格式。”

前面的提示包含以下四个元素：

• 主要任务： 故障排除步骤有哪些
• 上下文： 适用于无法连接 Wi-Fi 的 Windows 笔记本电脑
• 输入数据： 我尝试更新它并重置 Wi-Fi 驱动程序，但问题仍然存在
• 输出请求： 将步骤设置为项目符号列表格式

**注意：**要查看示例提示，请激活 Amazon Q Business 中的快速提示。

要创建针对特定文档的提示，请完成以下步骤：

1. 打开 Amazon Q Business 控制台。
2. 在导航窗格中，选择 Applications（应用程序），然后选择应用程序的名称。
3. 在 Enhancements（增强功能）下，选择 Data sources（数据来源）。
4. 在 Data source（数据来源）下，搜索您的数据来源名称并确认 Last sync status（上次同步状态）为 Completed（已完成）。
5. 在 Index（索引）下，检查文档数量属性以确认您已将文档添加到索引中。
6. 查看同步运行历史记录报告以确认您的文档已同步。
7. 创建特定于文档正文中信息的提示。
8. 将您的提示发送给 Amazon Q Business，然后等待响应。
9. 要确认 Amazon Q Business 引用的文档正确无误，请查看 Amazon Q Business 在响应中返回的引文。

检查文档的 ACL

**注意：**如果您在运行 AWS 命令行界面 (AWS CLI) 命令时收到错误，请参阅 AWS CLI 错误故障排除。此外，请确保您使用的是最新版本的 AWS CLI。

如果您使用的是有效提示但仍然遇到错误，请检查源文档的 ACL。当您为连接器启用 ACL 时，Amazon Q Business 仅返回在文档 ACL 中包含您的用户名的文档。

**注意：**您可以关闭 ACL。但是，必须删除数据来源并重新创建。

要确认您的源文档显示在 ACL 中，请完成以下步骤：

1. 打开 Amazon Q Business 控制台。
2. 在导航窗格中，选择 Applications（应用程序），然后选择应用程序的名称。
3. 在导航窗格的 Enhancements（增强功能）下，选择 Data sources（数据来源）。
4. 在 Data source（数据来源）下，搜索您的数据来源名称，然后选择您的数据来源。
5. 选择 Sync run history（同步运行历史记录）选项卡，然后从 Actions（操作）列中选择 View report（查看报告），以打开 Amazon CloudWatch Logs Insights 的新选项卡。
6. 选择 Run query（运行查询）。
7. 在报告中找到您的源文档，然后在 ACL 列中查看文档的 ACL。
8. 检查 ACL，以确保您的用户名与 AWS IAM Identity Center 中的电子邮件 ID 相匹配。
9. 如果用户名和电子邮件 ID 不匹配，请在用户存储功能中更新您的别名，以包括 ACL 中的用户名。运行 update-user AWS CLI 命令：

   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"}]'

   **注意：**将 your_q_business_application_id 替换为您的应用程序 ID，将 your_q_business_user_email 替换为您的用户电子邮件地址，将 your_user_id_from_data_source 替换为来自数据来源的用户 ID。
10. （可选）要验证您的别名是否已更新，请运行 get-user AWS CLI 命令：

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

**注意：**将 your_q_business_application_id 替换为您的应用程序 ID，将 your_q_business_user_email 替换为您的用户电子邮件地址。 同步您的数据来源以更新文档的 ACL。