第三部分 · 构建

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

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

打开 TypeScript 课程↗返回浏览器实验室

这是启动台，不是在线 IDE

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

开始之前

  • 你能够读写基础 TypeScript，包括函数、对象、循环和 await。
  • 你已安装 Git、Node.js 20.9 或更高版本，并备有终端和代码编辑器。
  • 九个引导关卡（第 0–8 关）预计需要两到三小时；第 9 关迁移项目为开放式任务，你可以随时停下，以后再继续。

先运行离线的第 0 关

  1. 1. 克隆并安装

    克隆公开仓库，进入该目录，并安装锁定版本的依赖项。

    git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci

  2. 2. 完成第 0 关唯一的编辑

    打开 course/stage0-hello/run.ts，把空的 QUESTION 字符串替换成你自己的问题。

    export const QUESTION = "What should I notice about an API?";

  3. 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

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

export DEEPSEEK_API_KEY=your_key_here

Claude

可选的本地服务商，供你比较。请设置密钥和 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 关要求你离开咖啡馆场景，在熟悉的领域里记录一个智能体设计。一份可供审核的提交应包括：

  • 问题边界，以及允许模型决定什么；
  • 一个能打破简单规则、真实而具体的失败输入；
  • 一小组带证据的评测用例，而不只是挑出来的优秀输出；
  • 在最不可逆的操作之前，由代码强制执行的闸门；
  • 服务商、工具和不可信输入的边界；
  • 一段关于失败、取舍和下一项测试的简短回顾。

如果本地设置对你来说太难

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

返回浏览器实验室打开 TypeScript 课程↗