Agent Tasks

运行任务并查看结果

创建一个智能体任务、读懂并批准计划、什么会进入 git、把工作退回再跑一轮,以及运行失败或撞上提供方限额时会发生什么。

创建任务

打开项目的 任务 页面,或者实例控制台的任务标签页,创建一个任务。您要给它:

  • 一个标题和一段描述。 用自然语言说明要改什么。细节有用:同样的需求,多写两句上下文得到的计划,比光有需求好得多。
  • 要在哪个实例中工作。 这决定智能体读哪个代码库,以及结果推送到哪个分支。
  • 技能与附件,可选。 技能是您的团队规范;附件是智能体应当拿到的上下文文件,比如一份规格说明,或者问题的截图。

创建任务需要智能体任务权限。如果项目的订阅未付款、项目已经转为只读,那么创建任务会和其他所有操作一样被拒绝。

面向生产实例 时,您需要在创建任务时输入 confirm,此后这个任务就被记录为生产任务。

阅读计划

智能体接手任务,读取代码库,然后写回一份计划。到这一步为止,还没有任何东西被改动。

请读计划本身,而不只是它的第一行。这是您在代码写出来之前发现理解偏差的唯一机会,而读它的代价,远低于事后拆解一次糟糕改动的代价。

然后做选择:

  • 批准并执行,智能体去实施这份计划。
  • 要求修改,描述哪里不对,它会带着您的反馈重新规划。
  • 重新规划,原样重跑一次规划,适用于第一次尝试是失败了、而不是做错了的情况。带指引重新规划 做的是同一件事,外加您的一段说明。
  • 取消任务,把它停掉。

批准需要计划批准权限。

有时智能体会把计划报告为 已阻止:它判断自己无法安全地完成这项工作,或者需求不够清楚。已阻止的计划始终等着有人来处理,即使项目上开着自动执行也一样。

什么会进入 git

您批准之后,智能体在实例的容器内做出更改、提交,并推送到该实例所在的分支。这次推送会重新部署实例,因此结果就跑在您能看到的地方。

没有拉取请求。提交直接落在实例所部署的那个分支上,这就是为什么您选哪个实例很重要,也是为什么生产环境被两道确认挡在外面。

如果一次运行跑完之后发现什么都不需要改,它会直说,而不是编一个提交出来。

结果不对的时候

在任务上使用 开始下一轮。描述哪里不对,智能体会 在自己已经推送的代码基础上 规划一次修复,而不是从头来过。任何东西运行之前您都要先批准新计划,现有的提交会留在分支上。

轮次会记录在任务上,所以您可以看到一件工作过了几轮,以及每一轮改了什么。

出问题的时候

  • 实例用这次运行提交的代码起不来。 CICDoo 会把那些提交移到一个救援分支上,重置实例的分支,并把 Odoo 重新拉起来。什么都没有被推送,也什么都没丢:如果您还想要,那些工作就在救援分支上。
  • 推送失败。 工作会留在容器的工作区里,而不是消失。
  • 运行撞上了您提供方的用量上限。 任务会暂停,并告诉您限额什么时候重置。继续 会从那个点接着执行已批准的计划;这还是同一轮,只是被打断过,不是新的一轮。
  • 运行不再回报。 如果容器在干活的中途死掉,任务会被标记为失败,而不是永远悬着。如果智能体在那之后才姗姗来迟地回报,结果依然会被采纳。

关注用量

任务的 用量 标签页列出它背后的每一次运行:属于哪一轮、哪个阶段,由谁触发,结果如何,输入和输出了多少 token,以及耗时多久。/agent 页面把这些数据跨项目汇总,并给出最近 30 天、90 天或 12 个月的图表。

重试和失败也会计入。这是有意为之:它们消耗了真实的智能体时间,一个试了四次的任务,就该看起来像试了四次。

下一步

关于这些时间如何计量和支付,见 智能体时间与充值。关于开启这项功能并连接一个 CLI,见 设置智能体任务

如果遇到问题,请从工单页面或聊天窗口提交支持工单。

仍未解决?在应用中提交工单,或与工程师沟通