第三部分 · 打造

在你自己的電腦上打造代理程式

第三部分包含九個 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 階段要求你離開咖啡館情境，在熟悉的領域中記錄一個代理程式設計。一份可供審核的提交應包括：

先回到瀏覽器實驗室，練習「規則 → 提示詞 → Eval」。它教的是相同的控制權交接，卻不要求你安裝開發環境。