第三部分 · 打造

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

第三部分包含九個 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 課程↗