了解日常使用 Bot 的方方面面：创建和管理 Bot、消息沟通与协作、它们共享的计算机，以及将完成的工作转化为技能和例程。
Bot¶
Bot 是拥有名称、作业、专属对话和会随时间积累的工作上下文的持久化 AI 队友。当工作有明确不同的目标、工具集、工作方式、批准边界或定期安排时，请创建单独的 Bot。Talent Scout、Expense Manager 和 Bug Reproduction 等作业可为 Bot 提供指引，并使其保存的上下文可复用；General Helper 则两者皆无。请用可操作的方式描述角色：
负责每周账户健康状况评审。获取产品用量和支持
信号，标记客户流失或扩张的迹象，并为客户成功
团队生成关联观察清单。未经批准，绝不联系客户或更改
账户。
创建 Bot¶
- 在侧边栏中选择 新建，或按 Cmd+N，然后选择 创建新智能体。
- 打开 Bot 操作，选择 编辑配置文件，设置名称、头衔、描述和头像。
- 发送第一个真实任务，并明确完成目标；起始提示词请参阅使用场景。
当某项作业需要长期负责的 Bot 时，现有 Bot 也可以推荐或创建专注于该作业的 Bot。
编辑 Bot¶
发现会影响后续工作的长期偏好、边界或职责时，请更新描述。任务相关的说明请通过对话提供；应持续适用的规则请写入描述：
- 描述。“未经批准，绝不发送外部消息。”
- 消息。“为这十二个账户起草后续跟进。”
整理你的 Bot 列表¶
将活跃的 Bot 固定到侧边栏顶部，并使用侧边栏分区按项目、客户或业务对其分组；分区会在桌面端和 iOS 之间同步。从侧边栏隐藏可将 Bot 从主列表中移除，而不会删除其工作内容或暂停其例程；可通过显示隐藏的聊天将其恢复。复制 Bot 可将某个角色复用于不同的职责范围，例如每个区域配备一个账户健康状况 Bot：副本会保留配置文件、设置、已启用的技能、例程和头像，但不包含对话历史、已学习的记忆或附件，因此请先重命名并赋予新的职责范围，再分配任务。
分享 Bot¶
如需让其他人基于同一个 Bot 开始使用，请分享公开链接。该链接会公开共享的配置 (身份、描述、技能和例程) ，因此请先移除 API 密钥、内部 URL 和客户数据。接收者会将副本添加到自己的账户；他们不会获得你的计算机、登录信息或对话历史记录。添加共享 Bot 即表示接受当时显示的第三方 bot 条款。
在团队版和企业版方案中，管理员可控制成员是否可以公开发布 Bot 模板。
请参阅模板共享。
删除 Bot¶
删除 Bot 会移除其配置文件、对话和例程。共享计算机上的文件和登录信息不按 Bot 隔离，可能仍会保留；请另行清理。如果之后可能还需要这些工作，请改为隐藏 Bot。
Bot 会记住什么¶
Bot 会保留稳定的偏好、重要事实和工作摘要，无需重放此前的每条消息，也能长期保持其角色。记忆不能替代权威来源：将不断变化的事实保留在源系统中；对于影响重大的决策，要求 Bot 引用或重新获取当前数据；直接纠正过时的假设；将安全边界写在描述中，而不是记忆中。
消息与协作¶
Grok Bot 旨在提供如同与团队成员沟通般的体验。请求可以自然表达，但请明确预期结果和决策边界：Bot 可以更改哪些内容，以及在哪一步必须停下，由你接手。
向 Bot 发送消息¶
在对话中，您可以粘贴文本、链接和图像，附加文件，通过 / 引用已保存的技能，通过 @ 提及 Bot、群组、例程或插件，回复消息或作出回应，并在工作进行中发送新指令。会话记录会与普通消息一同显示工具活动、计算机使用情况、已创建的文件、问题和批准请求。
您发送的私信优先于后台工作，并可改变当前轮次的处理方向。如需立即停止工作，请发送“立即停止”；停止不会撤销 Bot 已完成的操作。
附加文件和链接¶
支持的输入包括图像、音频、视频、PDF、Office 文档、CSV、JSON、YAML、源代码、HTML、电子邮件文件和笔记本。过大、加密、损坏或不常见的文件可能无法读取；请将不常见的格式导出为 PDF、CSV、纯文本或图像。
| 限制 | 值 |
|---|---|
| 每条消息的附件数 (桌面端) | 6 |
| 文档、图像和音频 | 每个 25 MB |
| 视频 | 200 MB |
告诉 Bot 每个附件的内容及其用途：
PDF 是已签署的政策文件。电子表格是本月的交易记录。
根据政策文件核对电子表格，为每个异常情况引用相关的政策
条款，并返回一份新的电子表格和简短摘要。请勿修改原始文件。
如果 Bot 能通过其计算机或插件访问该页面，即可粘贴链接；如果页面是私有的，请通过计算机登录或连接插件。在输入凭据或批准外部操作之前，务必检查链接的目标地址。
群组聊天¶
当多个 Bot 需要协作达成同一目标，并且交接过程需要对所有人可见时，可使用群组。选择 新建，选取两到六个 Bot，然后说明目标以及谁负责下一步。正常发送消息即可让 Bot 自行决定由谁回复；输入 @ 可将请求交给某位队友，@everyone 则用于向全组发送更新。一个实用的开场方式是为每个阶段指定一位负责人：
@Researcher 收集源材料，并为每项主张添加链接。@Writer 将
调研结果整理成发布草稿。@Reviewer 根据
来源检查草稿，并仅列出阻塞性问题。不要发布任何内容。
你在群组中发送的消息可以包含附件。Bot 向群组交接的消息仅支持文本，因此当某个 Bot 需要检查图片时，应直接将图片发送给该队友。
在 Bot 之间交接工作¶
一个 Bot 可以向另一个 Bot 发送异步消息，后者会被唤醒并处理请求，也可以稍后回复；你可以在对话中看到交接过程。当一个 Bot 负责源系统，另一个 Bot 负责交付成果，或者某项长时间运行的作业需要在无需你逐步协调的情况下继续执行时，交接尤为适用。确保每个阶段只有一个负责人；并行交接会导致重复工作和大量无关更新。
请求可供评审的结果¶
明确产物及其验收标准：附有来源链接的文档、列定义清晰的电子表格、包含屏幕截图和日志的文件夹，或尚未发送的草稿。对于影响重大的工作，请让 Bot 区分从源系统中获取的事实、假设、已完成的操作、等待批准的操作以及未解决的问题。
高质量的结果应能独立评审：直接来源链接、能看到相关状态的屏幕截图、时间戳、简洁的操作日志，以及明确列出 Bot 无法验证的所有内容。对于快速变化的数据，不要只依赖屏幕截图。生成的文件和链接会以卡片形式显示，您可以预览、保存或提供反馈；请让 Bot 修订现有产物，而不要创建互不关联的副本。
如果反馈只适用于某项结果或某个批准请求，请在线程中回复；表情回应仅用于轻量确认，不应仅凭表情回应作出安全关键决策。您可以通过搜索和命令面板，在各个 Bot 中查找之前的消息、文件、链接和例程。搜索功能在灰度发布期间的可用性可能有所不同；如果无法获得跨对话的结果，请打开相应的 Bot 并使用其对话历史。
计算机和应用¶
您的 Bot 在配备浏览器、命令行和文件系统的持久化云端计算机上工作。即使合上笔记本电脑，工作也会继续；文件、登录状态和浏览器会话会在不同任务间保留。
您账户中的所有 Bot 都使用同一台计算机：浏览器会话、文件和命令行凭据均会共享，一个 Bot 可以接着完成另一个 Bot 已保存的工作。每个 Bot 都有自己的屏幕，因此多个 Bot 可以并行使用浏览器和桌面工具 (每个屏幕每次只能执行一个计算机使用任务) 。但这些屏幕是工作界面，并非安全边界。如果不希望其他 Bot 能够使用某项凭据，请勿将其存放在计算机上。不同用户之间严格隔离：每位用户都拥有专用的硬件隔离计算机。请参阅用户隔离方式。
查看电脑¶
在对话中打开 智能体电脑，即可查看点击、输入、页面跳转和当前状态。工作继续进行时，你可以退出预览；关闭应用不会停止云端工作。
在敏感操作时接管¶
遇到密码、通行密钥、双因素验证码、CAPTCHA、付款或身份验证，以及需要人工操作的网站时，Bot 会将电脑控制权交给你。接管后，仅完成受阻的步骤，然后让 Bot 继续。Bot 不会输入凭据，也无法看到你的密码；已登录会话会保留供后续任务使用，并在你的各个 Bot 之间共享。某些网站会使会话过期或要求重新验证；请让 Bot 暂停并通知你，不要绕过检查。
对于受支持的连接，如果出现安全机密信息请求，请在其中输入相应值：该字段会被遮蔽，不会记录在会话记录中，也不会显示给模型。切勿将密码或一次性验证码粘贴到普通聊天中。请参阅安全存储机密信息。
连接插件¶
插件让 Bot 能够以结构化方式使用 Gmail、Notion 和 Slack 等服务；相比在网站上逐一点击操作，通常更可靠。在侧边栏中打开 插件，或按照聊天中的 连接 卡片操作，然后在浏览器中完成服务提供商的登录；设置步骤和已知问题请参阅 连接插件。
- 插件在整个账户范围内可用。 已安装的插件可供你运行的每个 Bot 使用。
- 插件登录信息不会存留在计算机上。 OAuth token 存储在 Cursor 的连接器后端，Bot 可以调用工具，但不会获取这些 token。
- 团队策略同样适用。 被团队连接器策略阻止的插件会显示 已被团队管理员禁用。阻止插件并不会阻止访问该服务的网站。要阻断这第二条路径，需要使用 网络控制，该功能仅限企业版。请参阅网络策略。
文件与工作区¶
计算机提供位于 /workspace 的共享工作区。请将需要长期保留的项目文件存放在结构清晰的项目文件夹中。文件、浏览器状态和受支持的登录状态可在常规计算机更新和恢复后保留；临时目录、手动安装的软件包以及未提交的应用状态均可能被替换，请将重要结果复制到工作区或附加到对话中。
更新、恢复或重置¶
应用和电脑会分别更新。电脑无法访问时，请按破坏性从低到高的顺序尝试：
- 在错误状态下重试，或重新打开对话。
- 重新启动 Grok Bot app，并检查是否有应用更新。
- 如果无法访问状态下提供此选项，选择 恢复智能体电脑。
- 使用 更新智能体电脑，基于最新镜像重新构建。
- 仅在万不得已时使用 重置智能体电脑。
恢复和更新会保留持久文件和登录信息。重置会将电脑恢复到已同步的持久状态，任何尚未同步的内容都不会恢复。对话存储在电脑之外，因此即使重置也不会丢失。请参阅 恢复 Grok Bot 电脑数据。
你的本地计算机独立于云端计算机¶
云端计算机与你面前的计算机相互独立。Bot 仅会根据本地执行策略在你的本地计算机上运行命令：默认逐条命令确认，也可设置为始终允许、每次询问或从不允许。该策略是独立的控制项，与管理云端计算机上操作的批准不同。请参阅本地执行。
技能和例程¶
技能是一组可复用的指令，用于说明如何完成某项任务。例程指定某个 Bot 何时运行工作流，可以按计划运行，也可以在受支持的事件发生后运行。先从一次性任务开始，确保其稳定可靠，再将方法保存为技能，最后才将其自动化。
保存技能¶
技能可记录步骤、决策规则、预期输出和安全边界，并可供所有 Bot 使用 (Bot 可能仍需相关插件或登录) 。直接提出请求：
将我们用于此任务的流程保存为名为“每周账户
健康状况”的技能。包括源系统、风险定义、输出格式，以及
联系客户始终需要批准这条规则。
实用的技能会说明何时使用、所需的输入和访问权限、工作流程、如何验证结果、应返回什么，以及哪些操作需要批准。在 composer 中输入 / 可引用技能。如果私有技能未显示在 / 菜单中，请在 设置 > 插件 > 你的 下为当前 Bot 启用它。
通过演示教会工作流¶
无需描述每个步骤，只需演示一次浏览器工作流，Bot 就会将其转化为技能草稿。在打开计算机视图的一对一对话中，选择教会任务，描述预期结果，然后执行工作流。教学过程最多会记录十分钟的可见计算机操作，不会录制麦克风音频；请勿在演示中包含机密信息，凭据请通过安全机密信息请求提供。学到的技能仍为草稿：添加决策规则、失败处理和批准边界，然后在安排执行前使用安全输入进行测试。
“教会任务”功能正在逐步推出。如果看不到该控件，请让
Bot 根据书面说明和已完成的任务创建技能。
创建例程¶
请应负责该定期作业的 Bot 执行以下操作：
每个工作日上午 8:00，针对当前账户列表运行“每日客户风险”技能。在此对话中发布关联的关注列表。不要
联系客户。如果源数据不可用，请报告失败，
不要使用旧数据。
确认负责的 Bot、日程和时区、输入来源、预期结果、批准边界，以及来源缺失时的处理方式。例程会在云端运行，即使笔记本电脑已关闭。一个 Bot 最多可拥有 50 个例程，每个例程保留最近 20 条运行记录；删除例程会立即生效且无法撤销，删除 Bot 则会同时删除其例程。
Cursor 账户集成也可以通过事件启动例程，例如 Slack 消息或 GitHub 通知；它们与 Slack 或 GitHub 插件相互独立。定义范围明确的匹配规则和清晰的响应，例如“当 #customer-escalations 中的消息包含工单链接和短语 ‘needs repro’ 时，在 staging 环境中复现该问题，并在此对话中发布复现包”。避免使用“每条新消息”这类宽泛的监听器，因为它们会产生噪声、消耗用量，并会对不相关的输入采取操作。
测试和管理例程¶
创建或编辑例程后，使用测试运行，并检查它是否选用了最新输入、符合输出格式、保留了来源记录、在预期的批准环节停止，以及是否明确显示失败状态。
测试运行会执行实际操作。它可能会访问网站、更改文件，并
调用已连接的工具。请使用安全的输入，并让写入操作经过
批准。
打开 Bot，依次选择查看对话详情和例程，即可启用、暂停、测试、编辑、查看运行历史记录或删除例程。长时间未使用后，Grok Bot 可能会询问是否继续运行例程；如果您未响应，它会暂停这些例程。
例程和人一样，都是通过可靠表现赢得信任：在执行前自动完成准备工作；发送、购买、删除、发布以及更改生产环境都需经过批准；对于缺失或过时的来源，应报告问题而非设法绕过；网站、插件或来源格式变更后，应重新测试。
