為什麼我的 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 console (Amazon Q Business 主控台)。
2. 在導覽窗格中，選擇 Applications (應用程式)，然後選取您應用程式的名稱。
3. 在 Enhancements (增強功能)下，選擇 Data sources (資料來源)。
4. 在 Data sources (資料來源) 下，搜尋您的資料來源名稱，並確認上次同步狀態為已完成。
5. 在 Index (索引) 下，檢查文件計數屬性，以確認您已將文件新增至索引。
6. 檢閱同步執行歷史記錄報告以，確認您的文件是否已同步。
7. 建立針對文件內文中資訊的提示。
8. 將提示傳送給 Amazon Q Business，然後等待回應。
9. 若要確認 Amazon Q Business 是否參考正確的文件，請檢查 Amazon Q Business 在回應中傳回的引文。

檢查文件的 ACL

**注意：**如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息，請參閱對 AWS CLI 錯誤進行疑難排解。此外，請確定您使用的是最新的 AWS CLI 版本。

如果您使用有效的提示但仍然遇到錯誤，請檢查來源文件的 ACL。當您為連接器開啟 ACL 時，Amazon Q Business 只會傳回文件 ACL 中包含您使用者名稱的文件。

**注意：**您可以關閉 ACL。但是，您必須刪除資料來源並重新建立它。

若要確認來源文件是否出現在 ACL 中，請完成下列步驟：

1. 開啟 Amazon Q Business console (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。