第三部分 · 构建

在你自己的电脑上构建智能体

第三部分包含九个 TypeScript 引导关卡（第 0–8 关），外加第 9 关迁移项目。本页会帮你准备好本地工具，验证离线的第 0 关，然后把你带到代码仓库；网站不会假装自己能看到你的本地进度。

这是启动台，不是在线 IDE

你的代码、模型密钥、输出和进度都会留在本地克隆中。这个静态网站既不会运行课程，也不会读取 course/progress.json。

课程本身是英文的。网站有九种语言，但各阶段的说明、咖啡馆菜单和二十个测试用例没有翻译：翻译被测量的输入会改变这个练习——实验室的用例保持英文，也是同一个原因。

实验室做完了？第 1–4 关会是复习——这一次由你自己写代码。

1. 克隆并安装
克隆公开仓库，进入该目录，并安装锁定版本的依赖项。
这次克隆和安装会把整个网站拉下来——好几百 MB，因为课程与网站共用同一份依赖清单。课程本身只引入一个包。网络慢的话，请留出几分钟。
```
git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci
```
2. 完成第 0 关唯一的编辑
打开 course/stage0-hello/run.ts，把空的 QUESTION 字符串替换成你自己的问题。
```
export const QUESTION = "What should I notice about an API?";
```
3. 不使用密钥，运行并检查
离线模式使用随课程提供、结果确定的替代模型。这是最安全的预检：不会请求服务商，不会产生私密记录，也不会收取 token 费用。
```
npm run course:offline
npx tsx course/stage0-hello/run.ts --offline
npx tsx course/check.ts 0 --offline
```

PASS  you asked the model something
PASS  an answer came back

  stage 0 complete.

不需要密钥，也不会发起付费请求。它可以验证代码路径，但不能展示模型回答的变化。

--offline

默认的实时服务商。终端进程会读取 DEEPSEEK_API_KEY；实时关卡会产生 DeepSeek 费用，并输出实测花费。

export DEEPSEEK_API_KEY=your_key_here

可选的本地服务商，供你比较。请设置密钥和 CAFE_PROVIDER。Claude 的价格可能高得多，因此运行前请先查看输出的费用估算。

export ANTHROPIC_API_KEY=your_key_here
export CAFE_PROVIDER=anthropic

离线模式免费。实时总费用会随所选模型、token、缓存和服务商当前价格变化。课程里的费用估算都有日期限制；最终账单以服务商控制台为准。

课程检查器会在本地写入 course/progress.json。网站无法看到该文件，因此不会为第三部分显示百分比或“继续学习”状态——只有你在下方为自己做的标记。

npx tsx course/report.ts
# reads course/progress.json in this clone

这里没有任何东西会检查你的作业。如果你已经完成这些关卡，可以自己给自己做个标记。它只保存在这个浏览器里，不会发送到任何地方，你也可以随时清除。

第 9 关要求你离开咖啡馆场景，在熟悉的领域里记录一个智能体设计。一份可供审核的提交应包括：

先回到浏览器实验室，练习“规则 → 提示词 → 评测”。它教的是同一种控制权交接，却不要求你安装开发环境。