Skip to content

快速开始 ​

从登录到在 GitHub 上拿到一个 Draft PR。大约 15 分钟,大部分时间在等这一轮跑完。

开始之前

你需要一个已开通 Yi Code 的组织里的账号,组织里要有额度。组织还没开通的话,请申请试用。

1. 登录 ​

  1. 打开 https://code.theyilabs.com,点「使用组织账号登录」。页面可能显示产品原来的名称「Preworld Code」。
  2. 用 Yi Labs 账号登录,选择你的组织。

进来后看到的是「想在代码里完成什么?」。左栏底部的钱包显示组织当前可用的额度。

如果页面提示「组织尚未开通或已停用,请联系管理员。」,说明组织没有开通 Yi Code,或者已经停用。见组织、登录与角色。

2. 连接 GitHub ​

  1. 点「连接 GitHub」,会打开 GitHub 上 Yi Code 这个 App 的安装页。
  2. 选 GitHub 账号或组织,选「Only select repositories」,勾上允许 Agent 处理的仓库。
  3. 点 Install。GitHub 接着会让你授权这个 App,用来证明刚装的这个安装确实属于你的 GitHub 账号。这一步不会保存你个人的 GitHub 令牌。

完成后回到「想在代码里完成什么?」。以后要增减仓库,点输入框下面的「管理 GitHub 仓库」。

一个安装只能连到一个 Yi Code 组织。细节见 Pull Request 与 GitHub。

3. 选仓库和分支 ​

在输入框下面打开「选择仓库」,选一个。「选择分支」默认是仓库的默认分支,需要的话改一下。

发出第一条消息时,分支会解析成它当时的提交,这个会话的每一轮都基于这个提交。之后再推到这个分支上的提交,不会进入这个会话。

4. 选 Ask 或 Code,选模型和预算 ​

  • Ask 只回答问题,不改仓库。还不熟悉代码的话,先用它。
  • Code 会改代码。跑完后你先看差异,什么都不会自动推到 GitHub。

点「预算」打开「本轮预算(USD)」和「模型」。预算是这一轮最多能花的钱,开始时从额度里冻结,结束时按实际费用扣掉,剩下的释放。每种模式都有最低预算。预算不够或额度不足时,输入框下面的提示会说明。见预算与计费。

5. 发出消息 ​

写下你要做的事。比如在 Ask 里问「解释这个仓库的结构」,在 Code 里写「parse_date 收到空字符串时返回 None,并补一个测试」。点箭头,或按 Ctrl+Enter(Mac 上是 ⌘+Enter)。

这一轮会依次显示进度:「拉取源码」「探测验证」「运行」「验证」「收集产物」。在这之前可能要先排队等执行环境。Ask 每轮最长 15 分钟,Code 最长 60 分钟。

想在跑完时收到浏览器通知,点顶部的「开启完成通知」。

6. 看结果 ​

一轮结束后能看到:

  • Agent 的回答,以及「工具步骤」里它执行的每条命令、每次文件修改。
  • 验证结果:「验证通过」「验证失败」或「未验证」,跑的是哪条命令、原因是什么(见验证)。
  • 回执:「本轮费用」、预算,以及会话固定的提交。

右侧「会话面板」里有整个会话的费用、改动(增删行数、文件数)、「查看差异」,还有「原始日志与产物」,里面是补丁和测试输出。

7. 创建 Draft PR ​

第一次发布前,先绑定你自己的 GitHub 账号:在「会话面板」的「GitHub 发布身份」下点「绑定个人 GitHub」,到 GitHub 上授权。PR 用你的授权创建,你的账号要对仓库有写权限。

Code 这一轮成功了、差异也没问题,就点「创建 Draft PR」,在「确认将已审阅的差异发布为 GitHub Draft PR?」里确认。

Yi Code 会把改动推到一个新分支,名字是 preworld/ 加会话 ID,并向你选的分支开一个 Draft PR。「查看 Draft PR」会链接过去。不会合并,合并由你们在 GitHub 上做。

最新一轮是 Ask、没有成功、会话没有任何改动,或者还没绑定 GitHub 账号时,这个按钮是灰的。

8. 追问 ​

在「继续追问,或描述下一步修改…」里写下一步。新的一轮从这个会话目前为止的全部改动开始,有自己的预算。跑完后审阅,点「更新 Draft PR」,同一个 PR 上会多一个新提交。不会强推。

接下来 ​

  • 会话与追问:会话列表、归档、取消一轮。
  • 验证:三种结果的含义,怎样让一轮得到验证。
  • 常见问题:按钮一直是灰的,或者一轮失败了。