View a markdown version of this page

疑難排解 - Amazon Quick
安裝和啟動問題連線問題效能問題檔案存取問題瀏覽器自動化問題排程任務問題管理客服人員使用時數了解工作階段用量限制MCP 伺服器問題匯出診斷重設應用程式取得其他協助

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

疑難排解

下列各節說明使用 Amazon Quick 桌面應用程式時可能遇到的常見問題，以及如何解決這些問題。

安裝和啟動問題

macOS 會顯示「無法識別開發人員」警告

如果 macOS 因為來自無法識別的開發人員而無法開啟 Amazon Quick 桌面應用程式，請使用下列程序來允許它。

  1. 在 Mac 上開啟系統設定。

  2. 選擇 Privacy & Security (隱私權與安全性)。

  3. 捲動至安全性區段，然後選擇 Quick 訊息旁的 Open Anyway。

  4. 確認您要開啟應用程式。

注意

第一次啟動時，您的作業系統可能會提示您確認是否要開啟應用程式。選擇開啟以繼續。

應用程式不會啟動

如果 Amazon Quick 桌面應用程式未啟動，請嘗試下列步驟。

  1. 重新啟動您的電腦，然後再次嘗試開啟應用程式。

  2. 確認您的作業系統符合最低需求。

  3. 檢查您是否有足夠的可用磁碟空間。

  4. 如果問題仍然存在，請刪除~/.quickwork/目錄 (macOS) 或%USERPROFILE%\.quickwork\目錄 (Windows)，然後重新安裝應用程式。

警告

刪除 ~/.quickwork/(macOS) 或 %USERPROFILE%\.quickwork\(Windows) 目錄會移除所有本機資料，包括對話、知識圖表、記憶體和儲存的登入資料。此步驟僅用於最後的手段。

連線問題

Slack 或 Outlook 連線失敗

如果與 Slack 或 Microsoft Outlook 的連線失敗，請嘗試下列步驟。

  1. 在設定 > 功能 > 連接器中中斷連線服務。

  2. 選擇登入並完成身分驗證流程，以重新連線服務。

  3. 確認您的帳戶在第三方服務中具有必要的許可。

  4. 檢查您的網際網路連線是否作用中且穩定。

Microsoft Teams 連線失敗

如果與 Microsoft Teams 的連線失敗，請遵循與 Slack 或 Outlook 相同的步驟。確認您組織的管理員未限制第三方應用程式存取。

連線顯示「未同步」狀態

如果連線顯示「未同步」狀態，請嘗試下列步驟。

  1. 確認您有作用中的網際網路連線。

  2. 在設定 > 功能 > 連接器中中斷和重新連線服務。

  3. 如果問題仍然存在，第三方服務可能會遇到中斷。檢查服務的狀態頁面。

Google Workspace 連線失敗

如果與 Google 服務的連線 (Gmail、Google Calendar、Google Drive、Google Docs、Google Sheets、Google Slides、Google Meet 或 Google Analytics) 失敗，請確認下列事項。

  1. 您的 Google 帳戶不受組織的管理政策限制。

  2. 您已在登入流程中授予必要的 OAuth 許可。

  3. 您使用正確的 Google 帳戶登入。

企業網路或 VPN 上的登入或回應失敗

只有在連線至公司網路、VPN 或安全 Web 閘道時，Amazon Quick 桌面應用程式可能無法登入或載入回應，但中斷連線時仍可正常運作。發生這種情況時，組織的網路可能會封鎖或檢查連線。與您的網路管理員一起完成下列步驟。

  1. 確認您的網路可存取所需的 Amazon Quick 網域。如需要新增至允許清單的網域清單，請參閱 網路存取和必要的網域。

  2. 如果您的組織檢查加密流量 (TLS 或 SSL 檢查），作業系統的憑證存放區必須信任檢查憑證授權單位，否則 Amazon Quick 網域必須排除在檢查之外。您的網路管理員可以確認檢查是否處於作用中狀態，並設定任一選項。

如果問題在您的網路管理員確認網域可連線並解決任何檢查問題後仍然存在，請匯出您的應用程式日誌 （請參閱匯出診斷) 並聯絡 AWS Support。

效能問題

回應緩慢

如果快速回應緩慢，請嘗試下列步驟。

  1. 切換到快速回應模式以加快回應速度。在聊天輸入區域中選擇回應偏好設定選擇器，然後選取快速。

  2. 降低思考工作量。較低的思考力 （關或低） 可產生更快的回應。

  3. 關閉未使用的應用程式以釋放系統資源。

  4. 檢查您的網際網路連線速度。AI 模型請求需要與 API Gateway 的網路連線。

高記憶體用量

如果 Amazon Quick 桌面應用程式使用過多記憶體，請嘗試下列步驟。

  1. 減少設定 > 我的電腦中編製索引的資料夾數量。停用不需要的資料夾的語意搜尋，因為語意搜尋使用的資源多於關鍵字搜尋。

  2. 降低設定 > 自訂 > 效能中的平行任務上限滑桿。預設值為 50。減少此值會限制並行背景操作的數量。

  3. 重新啟動應用程式以清除快取的資料。

  4. 在設定 > 我的電腦 > 搜尋索引中調整搜尋索引限制。降低儲存限制、索引的檔案大小上限，或索引滑桿的資料夾大小上限。

注意

當可用磁碟空間低於 8.0 GiB 時，搜尋索引會自動暫停。

檔案存取問題

快速找不到檔案

如果 Quick 找不到您在聊天中參考的檔案，請確認下列事項。

  1. 檔案的父資料夾會新增至設定 > 我的電腦 > 本機資料夾。除了一律可存取的系統暫時目錄之外，Quick 只能存取您明確授予存取權之資料夾中的檔案。在 Windows 上，這些是 C:\TEMP、\TEMP、 C:\TMP和 \TMP。在 macOS 和 Linux 上，這些是 /tmp、 /var/tmp和 /usr/tmp。

  2. 選擇 + 新增資料夾以授予其他資料夾的存取權。

  3. 新增資料夾後，Quick 可以立即讀取其中的檔案。搜尋的索引會在背景中進行。

搜尋不會傳回任何結果

如果檔案搜尋未傳回任何結果，請嘗試下列步驟。

  1. 確認在設定 > 我的電腦 > 本機資料夾中的資料夾已開啟關鍵字搜尋。展開 資料夾以查看其索引切換。

  2. 檢查索引狀態。檔案和項目計數的就緒狀態會確認索引已完成。

  3. 如果您最近新增了資料夾，請等待索引完成。狀態會顯示進度。

  4. 檢查檔案是否不大於設定 > 我的電腦 > 搜尋索引中索引限制的檔案大小上限。索引期間會略過大於此限制的檔案，但仍可透過直接檔案存取供代理程式使用。

  5. 如需更廣泛的搜尋，請在 資料夾上啟用語意搜尋，以允許自然語言查詢。

瀏覽器自動化問題

瀏覽器自動化無法運作

如果 Quick 無法瀏覽網頁，請嘗試下列步驟。

  1. 確認瀏覽器自動化已在設定 > 功能 > 工具中啟用。

  2. 如果使用「使用我的 Chrome」模式，請在設定 > 自訂 > 瀏覽器中驗證設定。開啟 Chrome 並導覽至 chrome://inspect/#remote-debugging。選擇啟用遠端偵錯。返回快速並選擇測試連線以驗證連線。

  3. 如果使用預設模式， 會使用設定檔的副本快速啟動個別的 Chrome 執行個體。請確定您的系統已安裝 Chrome。

排程任務問題

排程任務未執行

排程任務會在您的電腦本機執行。如果代理程式未在排定的時間執行，請確認下列事項。

  1. 您的電腦已在排程時間開啟並喚醒。

  2. Amazon Quick 桌面應用程式正在執行。

  3. 代理程式已啟用。檢查任務控制中的切換，可從頂端列存取。

  4. 您的網際網路連線已啟用。存取連線服務或 AI 模型的代理程式需要網路連線。

重要

如果您的電腦關閉，或應用程式在代理程式排程執行時關閉，代理程式會等到下一次排程的時間才會執行。

客服人員產生非預期的結果

如果排程的任務產生非預期的結果，請嘗試下列步驟。

  1. 從頂端列開啟任務控制，然後選取代理程式。

  2. 檢閱提示索引標籤，確認客服人員的指示正確無誤。

  3. 檢查功能索引標籤，確認已連接正確的 MCP 伺服器。

  4. 請考慮在概觀索引標籤中變更模型。針對更複雜的客服人員任務使用平衡或智慧。

  5. 選擇執行按鈕 （播放圖示） 以手動觸發代理程式並觀察結果。

管理客服人員使用時數

如果您要監控或減少客服人員使用時數，請考慮下列組態。

  • 排程任務 – 考慮減少在背景中執行的任務數量。每個排程任務執行都會耗用客服人員時數。

  • 回應模式和思考層級 – 針對更簡單的任務，使用快速回應模式，並將思考層級設定為關閉。具有較高思考層級 （低、中、高） 的平衡和智慧模式每次互動會耗用更多客服人員時數。將回應模式和思考層級與任務的複雜性配對。

了解工作階段用量限制

您可以在桌面應用程式的左下區域中選取設定檔，以檢視目前的工作階段用量。工作階段用量限制是一種服務保護限制，可將您的每月客服人員時數分配分配隨時間分配，而不是允許一次使用完整分配。

當您達到工作階段限制時，桌面應用程式會顯示一則訊息，指出已使用您的工作階段配置。限制會在滾動視窗上重設，隨著時間逐漸復原。

如果您經常遇到此限制，請參閱 管理客服人員使用時數。

MCP 伺服器問題

MCP 伺服器無法連線

如果 MCP 伺服器無法連線，請根據連線類型嘗試下列步驟。

本機 MCP 伺服器：

  1. 確認命令正確，且您的系統已安裝可執行檔。

  2. 檢查引數是否以空格分隔且格式正確。

  3. 如果伺服器需要超過 30 秒才能啟動 （可設定為 5 到 300 秒），請增加逾時值。

  4. 確認已正確設定任何必要的環境變數。

遠端 MCP 伺服器：

  1. 確認 URL 正確且伺服器正在執行。

  2. 如果需要身分驗證，請確認權杖值是有效的承載權杖。

  3. 檢查您的網路連線和任何防火牆設定。

匯入的 MCP 伺服器：

  1. 驗證組態檔案路徑是否正確。

  2. 確保來源應用程式 (Kiro、Claude Code、AIM 等） 已正確安裝。

匯出診斷

如果您需要共用診斷資訊以進行故障診斷，您可以從應用程式匯出診斷日誌。

  1. 開啟設定 > 自訂。

  2. 捲動至故障診斷區段。

  3. 從下拉式清單中選取時間範圍 （例如，過去 2 小時)。

  4. 選擇匯出診斷，將診斷日誌儲存至桌面。

如果您無法開啟應用程式以匯出診斷，您可以直接在機器上的下列位置找到日誌檔案。

  • macOS – ~/Library/Application Support/QuickWork/ 用於目前日誌，以及~/Library/Logs/QuickWork/用於已標註日期的日誌。

  • Windows – %APPDATA%\QuickWork\ 用於目前日誌，以及%APPDATA%\QuickWork\logs\用於已標註日期的日誌。

重設應用程式

如果其他疑難排解步驟無法解決您的問題，您可以透過清除所有資料來重設應用程式。

警告

此動作不可復原。它會移除所有快速資料，包括對話、快取訊息、知識圖表、儲存的登入資料和使用者偏好設定。應用程式會在清除後結束。

  1. 開啟設定 > 自訂。

  2. 捲動至危險區域區段。

  3. 選擇清除所有資料。

  4. 確認動作。

  5. 若要在 macOS 上完全解除安裝，請拖曳Amazon Quick.app至 Trash。在 Windows 上，開啟設定 > 應用程式 > 安裝的應用程式，尋找 Amazon Quick，然後選擇解除安裝。

取得其他協助

如果上述疑難排解步驟無法解決您的問題，您可以使用下列資源。

  • 匯出診斷並與您的支援團隊共用。

  • 如有企業帳戶問題，請聯絡組織的 IT 管理員。

  • 如需最新指引，請參閱 Amazon Quick 文件。