View a markdown version of this page

问题排查 - Amazon Quick
安装和启动问题连接问题性能问题文件访问问题浏览器自动化问题计划任务问题管理客服工时消耗了解会话使用限制MCP 服务器问题导出诊断重置应用程序获得更多帮助

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

问题排查

以下各节介绍您在使用 Amazon Quick 桌面应用程序时可能遇到的常见问题以及如何解决这些问题。

安装和启动问题

macOS 显示 “开发者身份不明” 警告

如果 macOS 因为来自身份不明的开发者而阻止您打开 Amazon Quick 桌面应用程序，请按照以下步骤允许打开。

  1. 在 Mac 上打开 “系统设置”。

  2. 选择 Privacy & Security (隐私与安全性)。

  3. 滚动到 “安全” 部分，然后选择有关 Quick 的消息旁边的 “无论如何打开”。

  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. 检查您的互联网连接是否活跃且稳定。

微软 Teams 连接失败

如果与微软 Teams 的连接失败，请按照与 Slack 或 Outlook 相同的步骤进行操作。确认贵组织的管理员没有限制第三方应用程序的访问权限。

连接显示 “未同步” 状态

如果连接显示 “未同步” 状态，请尝试以下步骤。

  1. 确认您的互联网连接处于活动状态。

  2. 在 “设置” > “功能” > “连接器” 中断开服务并重新连接。

  3. 如果问题仍然存在，则第三方服务可能会中断。查看服务的状态页面。

Google 工作空间连接失败

如果与谷歌服务（Gmail、谷歌日历、谷歌云端硬盘、谷歌文档、谷歌表格、谷歌幻灯片、Google Meet 或谷歌分析）的连接失败，请验证以下内容。

  1. 您的 Google 帐号不受贵组织管理员政策的限制。

  2. 您已在登录流程中授予所需的 OAuth 权限。

  3. 您使用的是正确的谷歌账号登录。

Sign-in 或者企业网络或 VPN 上的响应失败

只有当您连接到公司网络、VPN 或安全 Web 网关时，Amazon Quick 桌面应用程序才可能无法登录或加载响应，但在断开连接时可以正常工作。发生这种情况时，贵组织的网络可能会阻塞或检查连接。与您的网络管理员一起完成以下步骤。

  1. 确认您的网络可以访问所需的 Amazon Quick 域名。有关要添加到允许列表中的域名列表，请参阅网络访问和必需的域。

  2. 如果您的组织检查加密流量（TLS 或 SSL 检查），则操作系统的证书存储必须信任检查证书颁发机构，或者必须将 Amazon Quick 域排除在检查范围之外。您的网络管理员可以确认检查是否处于活动状态并配置任一选项。

如果在您的网络管理员确认域名可以访问并解决任何检查问题后问题仍然存在，请导出您的应用程序日志（参见导出诊断）并联系 Su AWS pport。

性能问题

反应缓慢

如果快速响应速度很慢，请尝试以下步骤。

  1. 切换到快速响应模式以获得更快的响应。在聊天输入区域中选择回复偏好选择器，然后选择快速。

  2. 降低思维精力。较低的思维努力（Off 或 Low）会产生更快的响应。

  3. 关闭未使用的应用程序以释放系统资源。

  4. 检查您的互联网连接速度。AI 模型请求需要与 API Gateway 建立网络连接。

高内存使用量

如果 Amazon Quick 桌面应用程序使用了过多的内存，请尝试以下步骤。

  1. 减少在 “设置” > “我的电脑” 中编入索引的文件夹数量。对不需要语义搜索的文件夹禁用语义搜索，因为语义搜索使用的资源比关键字搜索多。

  2. 放下 “设置” > “自定义” > “性能” 中的 “最大并行任务数” 滑块。默认值是 50。减少此值会限制并发后台操作的数量。

  3. 重新启动应用程序以清除缓存的数据。

  4. 在 “设置” > “我的电脑” > “搜索索引” 中调整搜索索引限制。降低存储限制、用于索引的最大文件大小或索引滑块的最大文件夹大小。

注意

当可用磁盘空间低于 8.0 GiB 时，搜索索引会自动暂停。

文件访问问题

Quick 找不到文件

如果 Quick 找不到您在聊天中引用的文件，请验证以下内容。

  1. 该文件的父文件夹将添加到 “设置” > “我的电脑” > “本地文件夹” 中。Quick 只能访问您明确授予访问权限的文件夹中的文件，但系统临时目录除外，这些目录始终可以访问。在 Windows 上C:\TEMP，这些是C:\TMP、\TEMP、和\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. 如果使用默认模式，Quick 会使用您的个人资料副本启动单独的 Chrome 实例。确保您的系统上安装了 Chrome。

计划任务问题

计划任务未运行

计划任务在您的计算机上本地运行。如果代理未按计划时间运行，请验证以下内容。

  1. 您的计算机已在预定时间开机并处于唤醒状态。

  2. Amazon Quick 桌面应用程序正在运行。

  3. 代理已启用。查看任务控制中的切换开关，可从顶部栏访问。

  4. 您的互联网连接已激活。访问互联服务或 AI 模型的代理需要网络连接。

重要

如果在安排代理运行时您的计算机已关闭或应用程序已关闭，则代理要等到下一个预定时间才会运行。

代理产生意想不到的结果

如果计划任务产生意外结果，请尝试以下步骤。

  1. 从顶部栏中打开 “任务控制”，然后选择代理。

  2. 查看 “提示” 选项卡，验证代理的说明是否正确。

  3. 检查 “功能” 选项卡，验证连接的 MCP 服务器是否正确。

  4. 考虑在 “概述” 选项卡中更改模型。使用 B alan ce d 或 Smar t 执行更复杂的代理任务。

  5. 选择 “运行” 按钮（播放图标）以手动触发代理并观察结果。

管理客服工时消耗

如果您正在监控或减少座席工时消耗，请考虑以下配置。

  • 计划任务-考虑减少在后台运行的任务数量。每次计划任务执行都会消耗代理时间。

  • 响应模式和思维水平-使用快速响应模式，将思维水平设置为关闭，完成更简单的任务。思维水平较高（低、中、高）的@@ 平衡模式和智能模式每次互动消耗的代理时间更长。将响应模式和思维水平与任务的复杂性相匹配。

了解会话使用限制

您可以通过在桌面应用程序的左下角选择您的配置文件来查看当前的会话使用情况。会话使用限制是一种服务保护限制，它会随着时间的推移分配您的每月代理工时数分配，而不是允许一次性使用全部配额。

当您达到会话限制时，桌面应用程序会显示一条消息，表明您的会话分配已被使用。限制在滚动窗口上重置，随着时间的推移逐渐恢复。

如果您经常遇到此限制，请参阅管理客服工时消耗。

MCP 服务器问题

MCP 服务器无法连接

如果 MCP 服务器无法连接，请根据连接类型尝试以下步骤。

本地 MCP 服务器：

  1. 验证命令是否正确且可执行文件已安装在您的系统上。

  2. 检查参数是否以空格分隔且格式正确。

  3. 如果服务器启动时间超过 30 秒（可配置为 5 到 300 秒），请增加 “超时” 值。

  4. 验证是否正确设置了所有必需的环境变量。

远程 MCP 服务器：

  1. 验证 URL 是否正确且服务器正在运行。

  2. 如果需要身份验证，请验证 Toke n 值是否为有效的不记名令牌。

  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\过时的日志。

重置应用程序

如果其他故障排除步骤无法解决您的问题，则可以通过清除所有数据来重置应用程序。

警告

此操作不可逆。它会删除所有 Quick 数据，包括对话、缓存的消息、知识图表、保存的凭据和用户首选项。应用程序在清理后退出。

  1. 打开 “设置” > “自定义”。

  2. 滚动到 “危险区域” 部分。

  3. 选择 “清除所有数据”。

  4. 确认该操作。

  5. 要在 macOS 上完全卸载，请拖Amazon Quick.app至 “垃圾箱”。在 Windows 上，打开 “设置” > “应用程序” > “已安装的应用程序”，找到 Amazon Quick，然后选择 “卸载”。

获得更多帮助

如果上述故障排除步骤无法解决您的问题，则可以使用以下资源。

  • 导出诊断信息并与您的支持团队共享。

  • 有关企业帐户的问题，请联系贵组织的 IT 管理员。

  • 请访问 Amazon Quick 文档以获取最新指南。