让 Bot 开一个 Project:和单个 Cloud Agent 有什么不同
非官方教程。核对日期:2026-10-17。Project 在公开文档里的定义几乎只有更新日志的一句话。下面把这句话和 Cloud Agent 的文档分开写,不把社区对比文里的结论补进去。
先说结论
2026-09-18 的更新日志写明:你向 Bot 提出要求时,它可以启动一个 Project。Project 是一个 Cloud Agent,它会规划这项工作,并运行它自己的 Agent。 这和“Bot 自己在云电脑上做”以及“只派一个 Cloud Agent”不是同一句说明。
三种派法
| 派法 | 官方怎么描述 | 本站怎么用这句话 |
|---|---|---|
| Bot 自己做 | Bot 使用账号共用的云电脑:浏览器、命令行、文件。见 文件与结果 和 工作方式 | 不需要改 Git 仓库的活,放在这里 |
| 单个 Cloud Agent | Bot 可以把写代码的工作交给 Cloud Agent。做完后,Bot 把最终报告里引用的图片、视频和其他文件拷到自己的电脑上,并附在回复里。桌面端的 Cloud Agent 卡片展示同样的文件 | 一项边界清楚的代码改动。指定模型的步骤见 派 Cloud Agent 并指定模型 |
| Project | 更新日志 2026-09-18:A Bot can start a Project when you ask for one: a Cloud Agent that plans the work and runs its own agents. | 你希望它先规划、再自己去跑多个 Agent 时,在对话里明确说要开 Project |
Cloud Agents 文档另外写明:它们可以在多个仓库组成的环境里协调修改,并在改过的仓库里打开 pull request;也可以并行跑很多个,不要求你的笔记本一直开着。Cloud Agents
“迁移类大活、一次开很多 PR”是本站对上面两句的理解,不是更新日志的原句。更新日志没有举例子。
第 1 步:在对话里明确说要开 Project
官方写的条件是 when you ask for one(当你要求时)。它没有写一个专门的按钮名字。本站因此建议你在消息里写出 Project 这个词,并写上仓库、目标和怎样算做完。后面这三项是本站加的,用来减少它做错仓库;不是更新日志里的必填栏。
请开一个 Project,不要只在你自己的云电脑上改。
仓库:我的用户名/仓库名
目标:……
做完的标准:有一个可打开的 pull request,列出改了哪些文件。不要合并。
如果开不了 Project,停下来说明原因,不要改成直接在云电脑上改仓库。启动 Cloud Agent 之前,Cursor 文档写明:账号管理员需要先接好源代码(GitHub、GitLab、Bitbucket Cloud 或 Azure DevOps)。你对仓库要有读写权限。排错节写明:Agent 跑不起来时,检查是否已登录、仓库权限,以及是否在付费的 Cursor 计划上。Cloud Agents
第 2 步:叫停
2026-09-17 的更新日志写明:你让一个 Bot 停下时,它也会停下它转交给别的 Bot 的工作,以及它启动的 Cloud Agent。
更新日志没有单独写“停 Project”这个词。Project 在 9 月 18 日被定义成一种 Cloud Agent。把 9 月 17 日这句理解为也覆盖它启动的 Project,是本站把两句放在一起读的结果。你要停的时候,直接对那个 Bot 说停。工作方式文档里的原句是发送 Stop now。停住不会撤销已经做完的事。工作方式
第 3 步:额度,只写文档里有的
Cloud Agents 文档的 Billing 一节 写明:
- Cloud Agents 按所选模型的 API 价格收费。
- 你可以选上下文窗口;更大的上下文会增加 token 用量和费用。
- 第一次使用时会要求你设置花费上限(spend limit)。
同一页的排错写明,Agent 不启动时需要付费的 Cursor 计划。它没有写:这笔费用从 Grok Bot 的每周额度里扣,还是另外算在 Cursor 的 On-demand 里。
Grok Bot 的套餐帮助 讲的是 Grok Bot 自己的每周用量、预充值和按量费用,没有出现 Project 或 Cloud Agent。
社区说法,本站不写进步骤
有社区文章说“Cloud Agent 的工作算 Cursor 计划用量”。这句话对不上上面两份官方文档的原句,本站不把它当成 Project 的计费规则。看费用时,以 Cloud Agents 文档的 API 计价和你账号里的花费上限为准。
你和 Bot 的对话本身仍走 Grok Bot 的用量。这是套餐帮助对 Grok Bot 用量的说明,不是对 Project 的说明。
第 4 步:到哪里看结果
官方写明的位置:
- Cloud Agent 做完后,Bot 把报告里引用的文件附在回复里;桌面端卡片里可以打开图片和视频。文件与结果
- 2026-09-29:Bot 详情里的 Tasks 标签、Coding 列表会去掉已删除或已过期的 cloud agent 运行;卡住的状态显示 Status unavailable。更新日志
- 2026-09-01,v0.34.0:消息里的 pull request 链接显示编号、标题,以及 open、draft、merged 或 closed。
- 2026-10-05,v0.68.0:鼠标悬停 pull request 链接时,预览卡片显示状态和标题。
更新日志没有写一个名叫 “Projects” 的独立标签。本站不编这个入口。
我们的建议
- 一个小改动,用单个 Cloud Agent,并在任务里写明仓库和“不要合并”。
- 只有你确实希望它自己再去规划、再启动 Agent 时,才说 “开一个 Project”。
- 第一次先看花费上限那一屏,确认 API 计价你能接受,再把仓库范围放大。
- 要停就对启动它的那个 Bot 说 Stop now,然后到 Cursor 的 Cloud Agent 页面确认还在不在跑。更新日志写 Bot 会停掉它启动的 Cloud Agent;本站没有替你点过这一下。
还没法证实的
- Project 的费用是否计入 Grok Bot 每周额度:两份官方文档都没写。已从步骤里拿掉。
- “Grok Bot 和 Cursor Projects 该用哪个”:Cursor 论坛和第三方博客有讨论。本站没有把那些帖子的结论写进来,因为它们不是 cursor.com 或 x.ai 的文档。
- 详情面板里有没有单独的 Project 按钮:更新日志只说“当你要求时”。
可直接复制的提示词
请先用三句话说明:这件事你打算自己在云电脑上做、派一个 Cloud Agent,还是开一个 Project。
我回复“开 Project”之后再启动。
仓库只使用我写下的那一个。验收标准是出现可审查的 pull request,不要合并。
启动后告诉我去哪里看它。我说 Stop now 时,停掉你为此启动的 Cloud Agent。常见问题
Q:Project 是不是 Cursor 里那个 Projects 功能?
A:更新日志把它定义成一种 Cloud Agent,没有写它等于 Cursor 产品里另一个名叫 Projects 的界面。本站不把两个名字当成同一个按钮。
Q:花的是 Grok Bot 每周额度吗?
A:文档没有这样写。写了的是 Cloud Agent 按模型 API 价格收费,并且第一次要设花费上限。
Q:说停之后,PR 会不会消失?
A:更新日志只说停掉 Cloud Agent。没有说会关闭已经打开的 pull request。停住也不撤销已经做完的事。
参考来源(核验 2026-10-17)
- https://x.ai/changelog/bot (2026-09-18、2026-09-17、2026-09-29、v0.34.0、v0.68.0)
- https://cursor.com/docs/cloud-agent
- https://docs.x.ai/grok-bot/files-and-results
- https://cursor.com/docs/grok-bot/work
- https://cursor.com/help/grok-bot/plans