会话与追问
一个会话就是围绕一个仓库、一个分支的一段对话,由若干轮组成。每一轮是你的一条消息加上 Agent 的一次执行,有自己的预算、结果和回执。
开始一个会话
点左栏的「新任务」,选仓库和分支,选 Ask 或 Code,发出消息。第一条消息会成为会话标题。
会话开始时,分支会解析成一个提交,整个会话都固定在这个提交上。Agent 在这个会话里做的一切,都从这个提交加上本会话之前的改动开始。想基于分支上更新的提交工作,就开一个新会话。
一条消息最多 30,000 个字符。
追问
上一轮结束并结算之后,才能在「继续追问,或描述下一步修改…」里继续写。在那之前,输入框下面会提示「等待当前轮次结算后可继续追问。」
追问的这一轮:
- 从本会话目前为止的全部改动开始,在一个新的沙箱里恢复出来。
- 能看到之前最多五轮里你的请求和 Agent 的总结。
- 有自己的模式、模型和预算,所以同一个会话里可以在 Ask 和 Code 之间切换。
- 用一个新的执行环境,之前几轮执行过的命令不会重放。
「会话面板」里的差异始终是相对固定提交的全部改动,不只是最后一轮。
会话列表
左栏把你的会话分成几组:
| 分组 | 最新一轮的状态 |
|---|---|
| 「等待你」 | 失败、已取消,或用量待核对 |
| 「运行中」 | 排队中或执行中 |
| 「可审阅」 | 已成功完成 |
列表里只有你自己发起的会话。管理员还可以查看所有人的会话,见组织会话。
一轮在跑的时候
这一轮会显示当前阶段:「拉取源码」「探测验证」「运行」「验证」「收集产物」。在这之前可能要等执行环境(「已提交,等待分配执行环境。」)。超过 5 分钟还没分到,页面会提示。你可以继续等,也可以取消这一轮,把预算释放出来。
「工具步骤」会随着 Agent 干活不断更新。每一步都有命令或文件修改、输出和退出码。
要停掉一轮,打开「会话面板」点「取消本轮」。先关掉沙箱,再结算。已经用掉的部分照常收费,但不会超过这一轮的预算。
点「开启完成通知」,一轮结束时浏览器会通知你。页面在后台时,标签页标题会变成「任务已完成 · Yi Code」。
一轮结束之后
每一轮最后都有验证结果和回执:「本轮费用」、预算和固定的提交。「会话面板」里还有整个会话的费用、改动、「查看差异」和「原始日志与产物」:
| 文件 | 内容 |
|---|---|
changes.patch | 本会话相对固定提交的全部改动,Git 补丁格式 |
tests.txt | 验证结果和原因,以及改动前后两次运行的输出 |
report.md | 这一轮的结果、失败原因(如有)、验证结果、用到的知识源和 Agent 的总结 |
memory-draft.md | Agent 对项目记忆提出的修改,见项目记忆 |
归档与恢复
做完了就在「会话面板」里点「归档会话」。归档的会话不再出现在主列表里。点列表底部的「已归档」可以查看,点「返回近期会话」回去。
打开一个已归档的会话,点「恢复会话」就能恢复。它的各轮、结果和 PR 都保留,可以继续追问。有一轮正在跑的会话不能归档,先取消这一轮或等它结束。
提交结果未确认
开始一轮会冻结额度,所以浏览器会把每次提交保存下来,直到服务端确认。如果恰好这时网络断了,会看到「上一次任务提交结果尚未确认」。点「检查提交结果」查一下,或者点「重试原提交」把同一个请求原样再发一次。服务端认得出重复提交,会返回原来那一轮,不会再开第二轮。
这需要浏览器允许这个标签页使用 session storage。被禁用时 Yi Code 不会提交,并提示「无法保存任务提交状态,请允许此标签页使用浏览器存储后重试。」
组织会话
所有者和管理员可以在「设置」里点「加载组织会话」,查看组织里的每个会话。他们不能接着别人的会话追问,也不能替别人发布。页面会提示「你正在查看组织会话,只有发起人可以继续或发布。」