本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
疑難排解
下列各節說明使用 Amazon Quick 桌面應用程式時可能遇到的常見問題,以及如何解決這些問題。
安裝和啟動問題
- macOS 會顯示「無法識別開發人員」警告
-
如果 macOS 因為來自無法識別的開發人員而無法開啟 Amazon Quick 桌面應用程式,請使用下列程序來允許它。
在 Mac 上開啟系統設定。
選擇 Privacy & Security (隱私權與安全性)。
捲動至安全區段,然後選擇 Quick 訊息旁的 Open Anyway。
確認您要開啟應用程式。
注意
第一次啟動時,您的作業系統可能會提示您確認是否要開啟應用程式。選擇開啟以繼續。
- 應用程式不會啟動
-
如果 Amazon Quick 桌面應用程式未啟動,請嘗試下列步驟。
重新啟動您的電腦,然後再次嘗試開啟應用程式。
確認您的作業系統符合最低需求。
檢查您是否有足夠的可用磁碟空間。
如果問題仍然存在,請刪除
~/.quickwork/目錄 (macOS) 或%USERPROFILE%\.quickwork\目錄 (Windows),然後重新安裝應用程式。
警告
刪除
~/.quickwork/(macOS) 或%USERPROFILE%\.quickwork\(Windows) 目錄會移除所有本機資料,包括對話、知識圖表、記憶體和儲存的登入資料。此步驟僅用於最後的手段。
連線問題
- Slack 或 Outlook 連線失敗
-
如果與 Slack 或 Microsoft Outlook 的連線失敗,請嘗試下列步驟。
在設定 > 功能 > 連接器中中斷連線服務。
選擇登入並完成身分驗證流程,以重新連接服務。
確認您的帳戶在第三方服務中具有必要的許可。
檢查您的網際網路連線是否作用中且穩定。
- Microsoft Teams 連線失敗
-
如果與 Microsoft Teams 的連線失敗,請遵循與 Slack 或 Outlook 相同的步驟。確認您的組織的管理員未限制第三方應用程式存取。
- 連線顯示「未同步」狀態
-
如果連線顯示「未同步」狀態,請嘗試下列步驟。
確認您有作用中的網際網路連線。
在設定 > 功能 > 連接器中中斷和重新連線服務。
如果問題仍然存在,第三方服務可能會遇到中斷。檢查服務的狀態頁面。
- Google Workspace 連線失敗
-
如果與 Google 服務的連線 (Gmail、Google Calendar、Google Drive、Google Docs、Google Sheets、Google Slides、Google Meet 或 Google Analytics) 失敗,請確認下列事項。
您的 Google 帳戶不受組織的管理員政策限制。
您已在登入流程中授予必要的 OAuth 許可。
您使用正確的 Google 帳戶登入。
效能問題
- 回應緩慢
-
如果快速回應緩慢,請嘗試下列步驟。
切換到快速回應模式以加快回應速度。在聊天輸入區域中選擇回應偏好設定選擇器,然後選取快速。
降低思考工作量。較低的思考力 (關或低) 可產生更快的回應。
關閉未使用的應用程式以釋放系統資源。
檢查您的網際網路連線速度。AI 模型請求需要與 API Gateway 的網路連線。
- 高記憶體用量
-
如果 Amazon Quick 桌面應用程式使用過多的記憶體,請嘗試下列步驟。
減少設定 > 我的電腦中編製索引的資料夾數量。停用不需要的資料夾的語意搜尋,因為語意搜尋使用的資源多於關鍵字搜尋。
降低設定 > 自訂 > 效能中的平行任務上限滑桿。預設值為 50。減少此值會限制並行背景操作的數量。
重新啟動應用程式以清除快取的資料。
在設定 > 我的電腦 > 搜尋索引中調整搜尋索引限制。降低儲存限制、索引的檔案大小上限,或索引滑桿的資料夾大小上限。
注意
當可用磁碟空間低於 8.0 GiB 時,搜尋索引會自動暫停。
檔案存取問題
- 快速找不到檔案
-
如果 Quick 找不到您在聊天中參考的檔案,請確認以下內容。
檔案的父資料夾會新增至設定 > 我的電腦 > 本機資料夾。除了一律可存取的系統暫時目錄之外,Quick 只能存取您明確授予存取權之資料夾中的檔案。在 Windows 上,這些是
C:\TEMP、\TEMP、C:\TMP和\TMP。在 macOS 和 Linux 上,這些是/tmp、/var/tmp和/usr/tmp。選擇 + 新增資料夾以授予其他資料夾的存取權。
新增資料夾後,Quick 可以立即讀取其中的檔案。搜尋的索引會在背景中進行。
- 搜尋不會傳回任何結果
-
如果檔案搜尋未傳回任何結果,請嘗試下列步驟。
確認已開啟設定 > 我的電腦 > 本機資料夾中資料夾的關鍵字搜尋。展開 資料夾以查看其索引切換。
檢查索引狀態。檔案和項目計數的就緒狀態會確認索引已完成。
如果您最近新增了資料夾,請等待索引完成。狀態會顯示進度。
檢查檔案是否不大於設定 > 我的電腦 > 搜尋索引中索引限制的檔案大小上限。索引期間會略過大於此限制的檔案,但仍可透過直接檔案存取供代理程式使用。
如需更廣泛的搜尋,請在 資料夾上啟用語意搜尋,以允許自然語言查詢。
瀏覽器自動化問題
- 瀏覽器自動化無法運作
-
如果 Quick 無法瀏覽網頁,請嘗試下列步驟。
確認瀏覽器自動化已在設定 > 功能 > 工具中啟用。
如果使用「使用我的 Chrome」模式,請在設定 > 自訂 > 瀏覽器中驗證設定。開啟 Chrome 並導覽至
chrome://inspect/#remote-debugging。選擇啟用遠端偵錯。返回快速並選擇測試連線以驗證連線。如果使用預設模式, 會使用設定檔的副本快速啟動個別的 Chrome 執行個體。請確定您的系統已安裝 Chrome。
排程任務問題
- 排程任務未執行
-
排程任務會在您的電腦本機執行。如果代理程式未在排定的時間執行,請驗證下列項目。
您的電腦已在排程時間開啟並喚醒。
Amazon Quick 桌面應用程式正在執行。
代理程式已啟用。檢查任務控制中的切換,可從頂端列存取。
您的網際網路連線已啟用。存取連線服務或 AI 模型的代理程式需要網路連線。
重要
如果您的電腦關閉,或應用程式在代理程式排程執行時關閉,代理程式會等到下一次排程的時間才會執行。
- 客服人員產生非預期的結果
-
如果排程的任務產生非預期的結果,請嘗試下列步驟。
從頂端列開啟任務控制,然後選取代理程式。
檢閱提示索引標籤,確認客服人員的指示正確無誤。
檢查功能索引標籤,確認已連接正確的 MCP 伺服器。
請考慮在概觀索引標籤中變更模型。針對更複雜的客服人員任務使用平衡或智慧。
選擇執行按鈕 (播放圖示) 以手動觸發代理程式並觀察結果。
管理客服人員使用時數
所有桌面活動都會耗用客服人員時數。如果您要監控或減少客服人員使用時數,請考慮下列組態。
-
本機檔案索引 – 考慮停用本機資料夾的語意搜尋和知識圖表擷取。對於語意搜尋,Web 體驗中的 Spaces 透過直接檔案上傳或知識庫整合提供相同的功能,而不會耗用桌面代理程式時數。
-
活動饋送頻率 – 考慮增加超過預設值的活動饋送重新整理間隔。您可以在設定 > 自訂 > 活動摘要中設定此項目。
-
排程任務 – 考慮減少在背景中執行的任務數量。每個排程任務執行都會耗用客服人員時數。
-
回應模式和思考層級 – 針對更簡單的任務,使用快速回應模式,並將思考層級設定為關閉。具有較高思考層級 (低、中、高) 的平衡和智慧模式每次互動會耗用更多客服人員時數。將回應模式和思考層級與任務的複雜性配對。
MCP 伺服器問題
- MCP 伺服器無法連線
-
如果 MCP 伺服器無法連線,請根據連線類型嘗試下列步驟。
本機 MCP 伺服器:
確認 命令正確,且您的系統已安裝 可執行檔。
檢查引數是否以空格分隔且格式正確。
如果伺服器需要超過 30 秒才能啟動 (可設定為 5 到 300 秒),請增加逾時值。
確認已正確設定任何必要的環境變數。
遠端 MCP 伺服器:
確認 URL 正確且伺服器正在執行。
如果需要身分驗證,請確認權杖值是有效的承載權杖。
檢查您的網路連線和任何防火牆設定。
匯入的 MCP 伺服器:
驗證組態檔案路徑是否正確。
確保來源應用程式 (Kiro、Claude Code、AIM 等) 已正確安裝。
匯出診斷
如果您需要共用診斷資訊以進行故障診斷,您可以從應用程式匯出診斷日誌。
開啟設定 > 自訂。
捲動至故障診斷區段。
從下拉式清單中選取時間範圍 (例如,過去 2 小時)。
選擇匯出診斷,將診斷日誌儲存到您的桌面。
重設應用程式
如果其他疑難排解步驟無法解決您的問題,您可以透過清除所有資料來重設應用程式。
警告
此動作不可復原。它會移除所有快速資料,包括對話、快取訊息、知識圖表、儲存的登入資料和使用者偏好設定。應用程式會在清除後結束。
開啟設定 > 自訂。
捲動至危險區域區段。
選擇清除所有資料。
確認動作。
若要在 macOS 上完全解除安裝,請拖曳
Amazon Quick.app至 Trash。在 Windows 上,開啟設定 > 應用程式 > 安裝的應用程式,尋找 Amazon Quick,然後選擇解除安裝。
取得其他協助
如果上述疑難排解步驟無法解決您的問題,您可以使用下列資源。
匯出診斷並與您的支援團隊共用。
開發人員功能表 – 選擇連線狀態點 (右上角的綠點),以存取任務控制、指標浮水印、偵錯面板和記憶體面板以進行進階診斷。
如有企業帳戶問題,請聯絡組織的 IT 管理員。
如需最新指引,請參閱 Amazon Quick 文件。