課堂用得到的句子

提示詞:複製,貼到對話框

照上課順序編號 ①–⑪,跟投影片上的「📋 ③ 複製提示詞」同一個號碼。點上面的號碼跳過去,按「複製」再貼到 Claude Code 或對話視窗。

請看專案資料夾裡的[提示詞]資料夾，檔案第2堂_加入AI，完成AI串接，若中間有要安裝第三方庫，請檢查第三方庫安全性、開源，確認代碼安全性後再開啟.py
**不要修改 .env 的 AIB_DEMO 與 AIB_FETCH_ON_START

10/3到10/10帶小孩去東京 8 天，2 大人2小，每晚 5000 內，要近池袋、有浴缸、獨棟、評分4.8+

請看專案資料夾裡的[提示詞]資料夾，檔案第3堂_Agent，完成AI串接，若中間有要安裝第三方庫，請檢查第三方庫安全性、開源，確認代碼安全性後再開啟.py
**不要修改 .env 的 AIB_DEMO 與 AIB_FETCH_ON_START

10/3到10/10帶小孩去東京 8 天，2 大人2小，每晚 5000 內，要近池袋、有浴缸、獨棟，找不到就放寬點吧

推薦的評價中，有指出離地鐵站步行距離嗎?

/asus-skill-vetter:asus-skill-vetter project-to-agent

/project-to-agent

幫我安裝, .env我已經存好

幫我把我的財務支出做成Dashboard。

製作一個GSAP互動式HTML，主要是想告訴同事什麼是Agent，[GUI]是我未串Agent前的照片，[Agent]是我串了Agent後照片，我的過程主要經過了這個skill Phase1-Phase9步驟。
風格:[麥肯錫]
內容:
	-封面
	-Agent前/Agent後
	-經過了Skill Phase1-Phase9, Phase1-Phase9最重要的是什麼?
	-結論

我現在想要替Dashboard加入圓餅圖、長條圖。

跟著投影片做

課程 PPT:十五個動手步驟

投影片右上角的橘色號碼 ①–⑮ 就是這裡的十五個區塊。每一塊寫清楚要按哪個檔、螢幕上會看到什麼,提示詞按一下就複製,圖片點一下放大、可以左右翻。

①

純 Python:先把 AIB 住宿雷達裝起來PPT 第 12、13、15 頁・5 分鐘

1. 進到資料夾 [Agent_Airbnb教學_GUI開始]
2. 先按 setup.bat,等它裝完
3. 再按 start.bat,瀏覽器會自己打開
4. 在畫面上篩選 10/3–10/10、2 大 2 小、獨棟房屋,再按撈取

⬇ 下載 AIB 住宿雷達

這一版是純 Python:門檻是寫死的 if,打「別太吵」它看不懂。

②

加入 AI:貼提示詞,同時去申請 API KeyPPT 第 16、17、18 頁・10 分鐘

1. 打開 Claude desktop,選 [Agent_Airbnb教學_GUI開始] 這個專案資料夾
2. 貼上第 ① 句提示詞,送出後讓它自己做
3. 等它做的時候,去 Google AI Studio 申請一把免費的 API Key(不用信用卡)
4. 按 Copy key 複製起來,下一步要貼進 .env

📋 ① 複製提示詞🔑 開 AI Studio 申請 API Key

提示詞裡刻意要求:要裝第三方套件前先檢查安全性、是不是開源。

③

把 API Key 填進 .env,重跑,再問 AI 一句話PPT 第 20、21、24 頁・3 分鐘

1. 回到專案資料夾,找到 .env(不是 .env.example),用記事本打開
2. 把剛剛複製的 key 貼在等號後面,存檔
3. 再按一次 setup.bat,然後 start.bat
4. 在網頁上用第 ② 句問 AI,看它自己把條件填進表單

📋 ② 複製提示詞

祕密只放 .env。這個檔被 .gitignore 擋掉,不會跟著程式碼跑出去。

④

變成 Agent:只給目標,它自己決定怎麼做PPT 第 25、28 頁・10 分鐘

1. 回到 Claude desktop 原本那個視窗,貼上第 ③ 句提示詞
2. 等它做完,按小桌寵打開「3 Agent」那一頁
3. 用第 ④ 句只給目標,盯著對話視窗看它搜幾次、有沒有自己放寬
4. 再用第 ⑤ 句追問離地鐵站多遠

📋 ③ 複製提示詞📋 ④ 只給目標📋 ⑤ 追問地鐵站

第 27 頁會告訴你:它其中一個答案是編的 —— 護欄就是這樣被補出來的。

⑤

換你的專案:先把記帳 GUI 跑起來PPT 第 34、35 頁・3 分鐘

1. 進到 [Agent_記帳教學_GUI開始] 資料夾,按 start.bat
2. 隨便記兩筆、看一下統計,先摸熟它原本的樣子
3. 截圖存在專案資料夾裡,檔名 [GUI] —— 作業要用

⬇ 下載記帳 GUI

等一下就是把這支普通的小程式,用 skill 一步一步變成 agent。

⑥

裝 skill 之前:先掃一次它安不安全PPT 第 36 頁

1. 打開 Claude desktop,選 [Agent_記帳教學_GUI開始] 資料夾
2. 貼上第 ⑥ 句,讓 asus-skill-vetter 掃過 project-to-agent
3. 看結果:VERDICT 要是 PASS 才往下裝

📋 ⑥ 複製提示詞

純文件＋範本、稽核當下不執行任何東西 —— 這就是可以裝的意思。

🗺 第三段怎麼跑:按下去之後的順序簡報第 64 頁・這一段的骨架

1. 1觸發在專案資料夾打 /project-to-agent⑦
2. 2Phase 0⏸ 問你做到哪個範圍?走哪個對話介面?⑦
3. 3群 A｜Phase 1–2⏸ 等你點頭讀程式、挑工具候選,摘要講回來給你確認⑦
4. 4群 B｜Phase 3–4⏸ 等你拿 key選大腦、你貼 .env、連線測試過了才架核心⑧⑨
5. 5群 C｜Phase 5–7⏸ 問你三題兩步寫入、說謊偵測、權限白名單⑩⑪
6. 6群 D｜Phase 7.5–8b選通道,接上 Telegram 或本機網頁⑫
7. 7群 D｜Phase 9⏸ 讓你測停下來讓你實際用一輪,有問題當場改⑬⑮
8. 8群 E・F｜Phase 10–14選配:用不到就跳過,不是每個都要做選配

⏸ 標記的五個地方,它會停下來等你 —— 那五個就是你的把關點。它不是按一個鍵就全自動;會停下來問,才是你敢讓它動你專案的原因。▶ 看互動示範(網站第 19 頁)

⑦

啟動 skill:打一行指令,先回答兩題PPT 第 65、72、73 頁・3 分鐘

1. 在 [Agent_記帳教學_GUI開始] 資料夾打開 Claude desktop
2. 貼上第 ⑦ 句 /project-to-agent
3. Phase 0 它會問兩題:做到哪個範圍(MVP 1–8 或 15 個全跑)、走哪個對話介面
4. 群 A 會讀你的專案、挑出工具候選,等你點頭才往下

⬇ 下載 skill📋 ⑦ 複製提示詞

把邏輯從按鈕裡搬出來,你的視窗還在 —— 按鈕照用,只是多開一個「不用開視窗也能叫」的入口。

⑧

Phase 3:API Key 放進 .env,讓它自己裝PPT 第 76、77、78、79 頁・5 分鐘

1. 回專案資料夾找到 .env,填入 AI Studio 拿到的 API Key,存檔
2. 回它第 ⑧ 句「幫我安裝, .env我已經存好」
3. 它裝第三方套件前會先問過你,裝完自己跑連線測試
4. ⏸ 停一下 —— 連線測試過了嗎?過了才算 Phase 3 完成

📋 ⑧ 複製提示詞

祕密只放 .env。這一步沒過,後面整條都動不了。

⑨

Phase 4:規劃迴圈真的跑起來PPT 第 80、81 頁・5 分鐘

1. 看它把規劃迴圈接起來:看懂問題 → 選工具 → 執行 → 回答
2. 單元測試全過:工具註冊、驗證、兩段寫入、幻覺偵測
3. 端到端接真的 Gemini 跑一次,日期換算、分類判斷都要對

你的工具數、測試數會跟示範那張不一樣 —— 依你自己的專案而定,不用對齊。

⑩

Phase 5–6:兩步寫入＋抓它說謊PPT 第 82、84、85 頁・5 分鐘

1. 用第 ⑩ 句「幫我記今天午餐 180」
2. 它先回預覽(confirm=false),這時候還沒寫進去
3. 你回 yes,它才真的寫進 accounting.db
4. 看它有沒有「嘴上說已新增、其實沒呼叫」—— 有的話回覆前會加警告

核可權留在人手上。幻覺偵測只抓「謊稱已寫入」,不是通用事實查核。

⑪

Phase 7:三題都選最小範圍PPT 第 88、90 頁・5 分鐘

1. 它會問三題:匯出寫到哪、能讀哪、能不能刪
2. 三題都選最小範圍 —— 匯出只寫 exports、讀取只開專案、刪除不開
3. 答完才寫進 permissions.json
4. Phase 7.5 選介面:這次選本機網頁,Telegram 不做

只開這個專案資料夾,D 碟其他工作檔它完全碰不到。

⑫

Phase 8b:同一個 core,換成網頁版PPT 第 93、94、95 頁・5 分鐘

1. 雙擊 .bat,瀏覽器開 localhost:8501
2. 實際問一輪,看數字是不是工具查出來的
3. 中途按一次停止鍵,沒講完的不會存進去
4. 最後確認記帳資料筆數沒有被跑掉

桌面視窗和網頁版共用同一批 core 函式,換的只是一層殼。

⑬

Phase 9:跟你的 Agent 聊聊天PPT 第 102、103 頁・5 分鐘

1. Phase 9 它會停下來讓你先測一輪,有問題當場說,它就改
2. 用第 ⑨ 句「幫我把我的財務支出做成 Dashboard。」
3. 截圖存在專案資料夾,檔名 [Agent] —— 作業要用

📋 ⑨ 複製提示詞

⏸ 停一下 —— 你的 agent 有回你話了嗎?

⑭

作業:把今天做的事做成一頁 HTMLPPT 第 104、112 頁

1. 用第 ⑩ 句提示詞丟給 Claude(風格指定麥肯錫)
2. [GUI] 是你串 Agent 前的截圖、[Agent] 是串完之後的截圖,兩張都要放進專案資料夾
3. 內容要講到:Agent 前/後、走過 skill 的 Phase 1–9、哪一步最重要、結論
4. 繳交:兩張圖 ＋ 一個 HTML

📋 ⑩ 複製提示詞👀 看老師的示範作品另一個版本

兩張圖、一個 HTML,就說完你今天做了什麼。老師那份是範例,不是規定格式 —— 你的專案長什麼樣就寫什麼樣。繳交方式在簡報第 112 頁。

⑮

讓 Dashboard 長出圖PPT 第 105、106 頁・5 分鐘

1. 第一次回來的是表格不是圖 —— 它只做得到工具給它的事
2. 用第 ⑪ 句「我現在想要替 Dashboard 加入圓餅圖、長條圖。」
3. 跑完實際看一下圖有沒有真的出來

📋 ⑪ 複製提示詞

每一條回答＝它呼叫一次工具,數字是查出來的,不是編的。

課後・9/22 場

同學作品

這場同學交上來的作業。點卡片會開新分頁,不會蓋掉這一頁。

課後

老師分享區

課後想再看的東西都在這裡。點了會開新分頁,不會蓋掉這一頁。

上課前先下載

課程資料:三包檔案

照上課順序放。解壓縮後照卡片上的步驟開,不用等老師喊。三包都不含 API key,只有 .env.example —— 金鑰是你自己去申請、自己保管的東西。

名詞表

整站一個比喻 —— 你的公司請了一位新員工

每一頁裡的專有名詞第一次出現會是藍色虛線,點一下就在那一段底下展開兩句:「生活裡」一句比喻、「在電腦裡」一句正解。

打造你專屬的 AI Agent・Agent 實驗室

這個網站怎麼用

上課跟課後各有用途,照你現在的需要挑一個進去。整站同一個比喻:你的公司請了一位機器人新員工 —— 機器人是 Agent,小女孩是你,它身上的零件和鑰匙就是工具與護欄。

登場角色:整站都是同一群人在演

機器人員工 = Agent公司新來的機器人。會走去帳本寫、去開門、舉牌等你蓋章。少了哪個零件,就演給你看會出什麼錯。

小女孩 = 你(也是老闆)下指令、簽名、蓋章的人。它做對了她會跳起來,做錯了她會跑走。

橘貓 = 另一家模型第 123 頁的審查員:機器人說做完了,貓不採信,自己再驗一次。第 54 頁四隻貓是分工的專職小組。

成長樹 = 你的專案長到第幾層第二段的六群就是樹的六層:根、樹幹、籬笆、信箱、側枝、果子。少一層,上面的東西就掛不住。

痛點・PPT 第 5 頁

你是不是常常都在跟 AI 重新說明自己的專案?

這頁在問為什麼每開一個新視窗,你就得把專案從頭再講一次?

跟 AI 講了半天你的程式,換一個對話視窗,它就全忘了。按播放,過一天看看。

AI 每一次,都像第一次認識你的專案。

換個角度:這不是 AI 笨,是你每次都在「重新認識」它。像每次去診所都換一位醫生,病歷不跟著走。今天要解決的就是這件事。

STEP1・示範・PPT 第 10 頁

同一個需求,今天走三次長大三次

這頁在問同一句需求跑三次,每一次是誰在決定下一步?

需求從頭到尾沒變:「每天早上幫我撈符合條件的 Airbnb 房源」。先看純 Python,再看加了 AI,最後看交給 Agent。眼睛盯著同一個地方就好:誰在決定下一步。

需求從頭到尾沒變。變的是「誰在決定流程」。

換個角度:同一件跑腿。第一次你給他一張寫死的清單,他照著勾,清單外的話聽不懂;第二次他聽得懂你講的話了,但去哪幾家、先去哪家還是你排的;第三次你只說「找到就好」,路線他自己排 —— 所以你得先講好最多跑幾家。

STEP1・為什麼要 skill・PPT 第 32 頁

會動很容易,敢用才難:skill 補的是哪四個洞

這頁在問都會動,那用 skill 搭跟自己用提示詞搭,差在哪?

剛剛那支 Airbnb agent 是自己用提示詞搭的,會動,但有四個洞。同一句需求再跑一次,這次用 project-to-agent 這個 skill 搭,看每個洞是哪一步補上的。

skill 的目的不是讓它會動,是把護欄變成預設、把流程變成能套到任何專案的 15 步。

換個角度:自己搭,像新員工第一天就上工,規矩你想到一條才交代一條;用 skill 搭,像先讓他跑完公司的到職訓練 —— 改東西先請示、每件事留紀錄、哪些櫃子不能開,都是報到那天就講好的。

STEP2・觀念 2・PPT 第 41 頁

Agent vs 直接跟 LLM 聊天

這頁在問同一個模型、同一句話,agent 比聊天多做了什麼?

同一個模型、同一句話。先送給左邊,再送給右邊,看它們各自做了什麼。

差別不在模型多強,在於它有沒有手,以及能不能再跑一輪。

換個角度:ChatGPT 很聰明,但它只能跟你「講」。Agent 差在兩件事:它有手,而且做完會回頭看一眼,不對就再來。

STEP2・觀念 3・PPT 第 42 頁

自主程度是一條光譜,不是開關

這頁在問自主度要開多大才夠?開大了你得多付什麼?

同一個任務「整理這個月的報表」。拉動滑桿,看每一級是誰走去做報表:你自己跑,還是機器人去;它會做到哪裡停下來。開場的三個 Demo 就在這條線上:純 Python 是 Lv0,加 AI 是 Lv2,Agent 是 Lv3。

不是越自主越好 —— 自主度要配得上你願意承擔的驗證成本。

換個角度:Lv1 是實習生,每一步都問你;Lv3 是資深同事,交代一次自己做完再回報;Lv4 是外派主管,一週後才看到結果 —— 你得先想好怎麼盯。

STEP2・演化・PPT 第 58 頁

同一條攻擊鏈:殼擋得住哪三步

這頁在問壞人的指令藏在網頁裡,哪幾步擋得住、哪一步擋不住?

壞人的指令藏在網頁裡,agent 讀到就中。先看裸跑會一路破到底,再看有殼(沙盒、政策引擎、出口白名單)擋得住哪幾步。

第①步永遠擋不住。護欄只能蓋在後面三步。

換個角度:詐騙電話一定打得進來,你擋不掉;能擋的是「不告訴他帳號」「不匯款」「不開門」。這兩年變的不是模型,是外面那層殼。

STEP2・觀念 4・PPT 第 43 頁

為什麼「拆步驟」這麼重要

這頁在問一次叫它做五件事,錯了你怎麼知道錯在哪?

同一個任務、同一個錯。先看機器人抱著一包五件事一路衝到老闆桌上會怎樣,再看它一張一張票每過一關蓋一次章。

拆步驟,本身就是降低幻覺的方法。

換個角度:一次算完五題再對答案,跟每題算完就對一次,哪個容易找到錯?錯在第 3 關被蓋了 ✗,就只重跑第 3 關,前面兩關的章還在。

STEP2・吳恩達老師・PPT 第 45 頁(第 46、48、51、53 頁逐塊點亮)

四大設計模式:一個 Agent 怎麼疊著用

這頁在問四個模式是四選一,還是同一台機器人一起用?

先給地圖,等一下逐站走。四個模式不是四台機器,是同一台機器人做同一件事時的四個動作。按播放,看它整理報表這一輪,哪一步用到哪一個。

四大模式不是四選一,而是像積木一樣疊著使用。

換個角度:出國旅行 —— 先排行程(Planning)、用手機訂票(Tool Use)、出發前檢查護照(Reflection)、人多才分工(Multi-agent)。一般任務用前三塊,複雜任務才加第四塊。

STEP2・模式 ①・PPT 第 47 頁

Planning:先想好路線再出發

這頁在問沒有計畫的 agent,和先排好路線的,差在哪裡?

同一個目標「整理這個月報表」。先看沒有計畫的 agent 怎麼做,再看先拆好路線的 agent 怎麼做。

Agent 不是想到什麼做什麼,而是沿著可預期的計畫工作。

換個角度:你要出門旅行,會先排行程。重點是行程要貼在冰箱上 —— 計畫要能被你看見、被你改。看不見的計畫等於沒有計畫。

STEP2・模式 ②・PPT 第 49 頁

Tool Use:讓 AI 長出手腳

這頁在問你原本就有的那個函式,AI 為什麼叫不動?

你的專案裡本來就有 generate_report(month)。先看沒包成工具時 AI 怎麼回,再看包成工具之後。

{ "name": "generate_report",
  "parameters": { "month": "string" },
  "description": "產出該月報表" }

工具不是新功能,是把既有能力變成 AI 可以呼叫的介面。

換個角度:你的專案裡,哪一個功能最常手動跑?那就是第一個要包的工具。補充:MCP 是把工具接上 LLM 的標準介面,接一次到處能用。

STEP2・模式 ②・機制・PPT 第 50 頁

AI 到底怎麼呼叫你的 Python?

這頁在問AI 到底怎麼「執行」你電腦上的 Python?

先講結論:LLM 從頭到尾沒有碰你的電腦。這裡的機器人是只會寫便條的顧問,它手上只有一張工具清單(菜單);真正動手的,一直是右邊你自己的程式。

LLM 只負責說出要叫哪一個。動手的,從頭到尾都是你的 Python。

換個角度:顧問坐在窗口外,手上只有菜單,他能做的只有寫便條「用第 2 道」。便條要有人拿進廚房,煮的是廚房。菜單上沒有的菜他寫不出來;就算亂寫,廚房也不會照做。

STEP2・模式 ③・PPT 第 52 頁

Reflection:讓 AI 檢查自己的作業

這頁在問它寫完的東西,誰來挑錯?

同一份報表。先看機器人寫完初版直接送到老闆桌上會怎樣;再看它多走兩張桌子:自評桌畫紅圈、修訂桌改好,才送老闆。

會自我檢查的 agent,才敢讓它自己跑完。

換個角度:寫完作文回頭看有沒有錯字。多過兩張桌子要多花一倍的字數和時間(AI 按字數算錢),所以只放在「錯了代價很高」的步驟。

STEP2・模式 ④・PPT 第 54 頁

Multi-agent:多個專職角色協作

這頁在問什麼時候該拆成多個 agent,什麼時候不該?

一份年度分析報告,裝在一個任務資料夾裡。先看機器人一個人全包會怎樣,再看它當協調者,把資料夾交給研究、分析、撰寫、審查四個專職的人。

Multi-agent 是下一步,不是起手式。

換個角度:分組報告。人多不一定比較快,每交接一次都要溝通;能一個 agent 解決的,不要拆成三個。任務大到一個人裝不下時才拆。

STEP2・組成・PPT 第 55 頁

Agent 的 6 大組成要素

這頁在問少掉一個零件,這台機器人會變成什麼樣?

六個零件都在,交代「把昨天的 log 整理成報表」會順利完成。點任一個零件把它拔掉,再看機器人做同一件事會變成什麼樣。

剛剛的四大模式講「怎麼想」,這 6 大組成講「要蓋哪些零件」。

換個角度:一位員工 —— 大腦、手腳、工作習慣、筆記本、電話、公司規定。第二段的十五個步驟,就是把這六樣一個一個裝上去。

STEP2・運作・PPT 第 56 頁

規劃迴圈是怎麼跑起來的

這頁在問為什麼 agent 要跑好幾圈,不是回答一次就好?

「幫我把昨天的 log 跑成報表」。先看沒有迴圈的一次呼叫,再看迴圈怎麼一輪一輪跑到 done。

迴圈是 agent 的心跳。沒有迴圈,那只是一次函數呼叫。

換個角度:你講一句話 → 它想下一步 → 呼叫工具 → 看結果 → 沒完成就回第二步。每一輪它都會重看一次工具清單,所以新加的工具當場就能用。

STEP1・準備・PPT 第 33 頁

skill 是什麼?裝在哪?

這頁在問skill 到底是什麼?放在哪裡才會生效?

同一句話「幫我把這個專案變成 agent」。先看沒有 skill 的 AI 怎麼做,再看有 skill 的。

~/.claude/skills/project-to-agent/
└─ SKILL.md
   description: 把既有 Python 專案變成 agent…
   steps: Phase 0 → 1 → 2 → … → 14

skill 不是外掛程式,是一份寫給 AI 看的 SOP。

換個角度:新人報到,你給他一本作業手冊「什麼時候、該照什麼步驟做」。放進指定資料夾就生效,不用重開。裝別人的 skill 之前先驗,那是別人寫給你的 AI 的指令。

STEP3・心態・PPT 第 62 頁

為什麼是「包既有專案」,不是從零生程式

這頁在問從零生一支新程式,和包你現有的專案,哪個先能用?

同樣要一個記帳 agent。左邊是一塊空地,從種子開始種;右邊是你原本的 Python,一棵本來就有根有樹幹的老樹,只要接枝。比頭三天。

既有專案是種子,不是負債。

換個角度:你已經寫好的程式不用丟掉,它們就是材料。既有函數就是 agent 現成的手腳,新能力靠「加工具」慢慢長出來。

STEP3・藍圖・PPT 第 63 頁

15 個 Phase,分成 6 群

這頁在問15 個 Phase 為什麼不能跳?跳了會怎樣?

把 agent 想成公司地磚上一棵要一層一層長起來的樹。先看「跳步驟」:急著要手機能用,直接掛一團樹葉;再看「完整種法」:從 Phase 0 的藍圖地磚開始,一層驗收完才長下一層。

MVP ＝ Phase 1–8。一個 phase 做完驗收才往下,不要跳。

換個角度:種樹 —— 先扎根(群 A)、長樹幹(群 B)、圍籬笆(群 C)、掛信箱(群 D)、伸側枝(群 E)、結果子(群 F)。信箱掛在沒有根、沒有樹幹的一團葉子上,風一吹就掉。群 C 是必做,群 E、F 幾乎都是選配。

STEP3・流程・PPT 第 64 頁

跑一次,會發生什麼事

這頁在問按下去之後,它會一路跑完,還是會停下來問你?

上一頁是「樹有哪幾層」,這一頁是「按下去之後,樹怎麼長」。先看如果它一鍵全自動長完會怎樣,再看它實際上會在哪幾層停下來問你。

它不是按一個鍵就全自動。會停下來問,才是你敢讓它動你專案的原因。

換個角度:裝潢師傅不會自己決定拆哪面牆,每個關鍵點都會問你一次。五個 ⏸ 就是你的把關點:問範圍、要你點頭、等你拿金鑰、問權限、讓你測試。

STEP3・群 A・PPT 第 67 頁

打地基:把記帳 GUI 變成「Agent 工具」

這頁在問你專案裡哪些函式該包成工具,哪些不用?

Phase 1 讀專案、講回來給你確認;Phase 2 挑出能當工具的函式。先看 Phase 1,再看 Phase 2。

不 wrap 每個函數。挑你最常手動按的那幾個按鈕就好。

換個角度:判準三個字 —— 做一件事、輸入輸出明確、不需要視窗也能跑。換成你的專案:你最常按的那顆按鈕,底下是哪一個函式?

STEP3・動手・PPT 第 71 頁

把邏輯從按鈕裡搬出來

這頁在問agent 為什麼按不動你的按鈕?

全場最重要的一頁。左邊是拆之前:五件事全擠在一個按鈕裡。按播放,看哪幾行搬去右邊、哪幾行留下。

def submit_record(self):
    data = self._read_form()        ① 讀畫面
    if not _valid(data):            ② 檢查格式
        messagebox.showerror(…)
        return
    self.db.add(*data)              ③ 寫進 accounting.db
    self.reset_form()               ④ 清空表單
    self.refresh_all()              ⑤ 更新畫面

def add_record(date, cat, amount, confirm=False):
    if not _valid((date, cat, amount)):  ② 檢查格式
        return {"error": "日期或金額格式不對"}
    if not confirm:
        return {"preview": …}
    db.add(date, cat, amount)            ③ 寫進 accounting.db
    return {"ok": True, …}

agent 不會按你的按鈕。它只呼叫按鈕底下的函式。

換個角度:①讀畫面、④清空表單、⑤更新畫面 → 留在介面那一層;②檢查格式、③寫進 accounting.db → 搬進不需要視窗的 tools.py。現在打開你自己那支程式,找到按鈕接的那個函式,圈出「不需要畫面也能跑」的那幾行。

STEP3・動手・PPT 第 72 頁

拆完之後,你的視窗還在

這頁在問把邏輯搬出去,原本的視窗會不會壞掉?

很多人以為「把邏輯搬出去」要砍掉介面。按播放,看拆之前和拆之後按同一顆按鈕會發生什麼。

拆邏輯不會拆掉你的介面。GUI 照常用,agent 也叫得動。

換個角度:使用者完全看不出差別。你只是多開了一個「不用開視窗也能叫」的入口。

STEP3・群 B・PPT 第 74 頁

大腦與核心

這頁在問老闆說客戶資料不能外送,要改多少東西才換得掉模型?

Phase 3 選大腦,但重點不是選哪一家,是換的時候要付多大代價。老闆突然說「客戶資料不能外送,改用本機模型」。先看沒有統一入口會怎樣,再看有 factory 的做法。

from openai import OpenAI
client = OpenAI(api_key=KEY)
resp = client.chat.completions.create(
    model="gpt-4o", messages=msgs)
text = resp.choices[0].message.content
  # 重試、逾時、token 計數 … 另外 28 行

LLM_PROVIDER=gemini

client = llm_client()   # factory 依設定挑供應商
reply  = client.chat(messages)

不要被一家公司綁死,換模型應該是改設定不是改程式。

LLM_PROVIDER=ollama   # .env 改這一行
client = llm_client()   # 程式不動

換個角度:插座統一規格,電器隨便換;沒有統一規格,每換一台電器就要重拉一次電線。記帳這種小事免費模型就夠,真正的價值是「想換就能換」。

STEP3・群 C・防線 1・PPT 第 82 頁

兩步寫入確認(Phase 5)

這頁在問它要動你的帳本之前,誰說了算?

你說「幫我記今天午餐 180」。先看機器人聽完直接走去帳本寫會怎樣,再看它先填一張單據拿回你面前簽名,你點頭才去寫。

防 LLM 不經同意就改檔、發訊息 —— 鑰匙留在人手上。

add_entry("2026-08-30", "飲食", 180, confirm=False)
→ {"preview": "打算新增 08-30 飲食 180 元"}
add_entry(..., confirm=True)
→ {"ok": true}

換個角度:就像轉帳前跳出來的確認畫面,多按一下,但錢不會亂跑。換成你的專案:哪些動作是「做錯了會很麻煩」的?那幾個才要兩步確認。

STEP3・群 C・防線 2・PPT 第 83 頁

寫入幻覺偵測(Phase 6)

這頁在問它說「已經幫你記好了」,你憑什麼相信?

機器人嘴上說「已經幫你記下來了」。先看這句話直接送到你面前會怎樣,再看它先經過偵測器:偵測器不聽它說,親自去帳本看一眼。

可靠的 agent,不相信自己說「完成」,只相信可驗證的結果。

tool_calls 這一輪有 add_entry? → 否
accounting.db 修改時間 21:03 → 21:03(沒變)
筆數 53 → 53(沒多)
⇒ 回覆前加:⚠ 我沒有實際寫入

換個角度:員工說「報告交了」,你去信箱看一眼有沒有。只抓「謊稱已寫入但實際沒做」,不是通用事實查核 —— 這是 Reflection 的最小可用版。

STEP3・群 C・防線 3・PPT 第 86 頁

權限白名單(Phase 7,不可跳)

這頁在問它手上那把鑰匙,能開幾扇門?

機器人拿著一把鑰匙,一連要開三扇門:帳本、你的工作檔、放金鑰的保險箱。先看沒有白名單時三扇門都開得了,再看白名單怎麼擋。

agent 只能動你授權的資料夾,這是檔案系統的邊界。

{"read":   ["記帳專案/"],
 "write":  ["記帳專案/accounting.db", "記帳專案/agent/exports", "記帳專案/agent/uploads"],
 "delete": []}
// .env、*.key、*secret* 不管怎麼設都擋

換個角度:給清潔人員的鑰匙只開他要打掃的那幾間。一支只會記帳的小工具,也只給它這幾個檔 —— 範圍越小越好,不是越大越方便。

STEP3・群 D・PPT 第 89 頁

對話介面:同一個 core,三個介面

這頁在問換一個介面,後面的邏輯要不要跟著重寫?

桌面視窗、本機網頁、Telegram,三個櫃檯各收一張「午餐 180」的訂單。按播放,看機器人把三張訂單送到哪裡。

介面只是 Adapter。三個介面共用一個 core,邏輯永遠只有一份。

換個角度:同一間廚房,前面可以開櫃檯、外送、電話訂餐。Phase 9 通道專屬提示(選配):開場就注入今天日期與六個分類名稱。你的專案需要在外面用嗎?不需要就只做網頁版。

STEP3・群 D・PPT 第 94 頁

同一個 core,換一層殼:桌面 → 網頁

這頁在問桌面版和網頁版差這麼多,哪一行是一樣的?

左邊桌面版按鈕,右邊網頁版表單。長得不一樣。按播放,找出兩邊一模一樣的那一行。

ttk.Button(top, text="新增",
           command=self.on_add)
def on_add(self):
    r = core.add_entry(
        self.e_date.get(), …,
        self.e_amt.get(), confirm=True)
    if not r["ok"]:
        messagebox.showerror(…)

with st.form("add"):
    d   = st.text_input("日期")
    cat = st.selectbox("分類", CATEGORIES)
    amt = st.text_input("金額")
    if st.form_submit_button("新增"):
        r = core.add_entry(
            d, cat, amt, confirm=True)
        if not r["ok"]: st.error(…)

換介面就是換一層殼。邏輯只有一份,才不會愈改愈亂。

換個角度:第三層殼 bot_telegram.py 也一樣 —— 換掉的是「怎麼問你」,不是「怎麼算」。core.py 一個字都沒改。

STEP3・觀念・PPT 第 101 頁

那跟「只串一把 API key」差在哪?

這頁在問自己串一把 API key 不就好了,差在哪?

很多人會問:我自己串一把金鑰不就好了?只串 key 就是一台只有嘴巴和一把鑰匙的機器人,其他都沒蓋。先看它會怎麼做,再看蓋完整的那台。

差別不是模型,是它有沒有真的接到你的東西。

換個角度:只串 key = 會講話但看不到你資料的模型。問它八月花多少,它不知道;叫它記帳,它回你一段親切的話,然後什麼都沒發生。

STEP3・群 E・PPT 第 97 頁

給它手腳(本群全是選配)

這頁在問這些選配,哪一樣是你真的需要的?

群 E 是工具架上的四樣手腳,機器人走過去一樣一樣決定要不要拿。按播放,看每一樣怎麼決定,最後看唯一拿的那樣怎麼動。

選配的意思就是「真的可以不做」,不是「順便都做一做」。

換個角度:買車的選配,不是每一項都勾。記帳只讀寫兩個 json,開 shell 只是多開一個洞。所有週期任務都必須有「結束條件」。

STEP3・群 F・PPT 第 98 頁

讓它成長(本群全是選配)

這頁在問讓它自己長出新能力,要不要先問過你?

群 F 是讓這棵樹自己長:結新果(自我演化)、修枝(省 token)、根扎更深(長期記憶)。先看沒有園丁點頭它會長成什麼樣,再看每一樣都要蓋章的版本。

不是 AI 自己進化,是你點頭它才進化。

換個角度:員工可以提案,但簽核在主管手上;核心檔永不自動 merge。agent 越會記,治理責任越大 —— 長期記憶必須先問過才開。

STEP3・關鍵對照・PPT 第 109 頁

四大模式 ↔ 15 Phase 落在哪

這頁在問上午講的那四個模式,跑到這 15 個 Phase 哪裡去了?

第一段的四個模式,到了第二段沒有消失,只是換了名字。不用背對照表:讓機器人真的記一筆帳,每做到一步,就標出這一步是第一段的哪個模式、第二段的哪個 Phase。

概念跟實作是同一件事的兩個說法:一趟記帳裡,四個模式出現了三個。

換個角度:這門課走單 agent 多工具路線。Multi-agent 不做分工版,改用「互審版」—— 第 123 頁。

STEP3・演化・PPT 第 99 頁

自我演化:agent 自己長出新工具

這頁在問它自己寫的新工具,憑什麼可以掛上去?

你問了一個目前沒有工具能回答的問題。按播放,看機器人寫的一份草稿怎麼經過測試、拿回你面前蓋章,才掛進工具區。

不是 AI 自己進化,是 Human-governed Evolution。

換個角度:員工發現缺一個工具,自己畫了草圖,拿給你簽;你簽了才拿去做,做好當場就能用。中間那道核准是重點,沒有它這件事就很可怕。

補充・多模型・PPT 第 123 頁

換一家模型來審,抓到了什麼

這頁在問一個 AI 說「我做完了」,你要怎麼驗?

不是讓兩個 AI 分工,是讓它們互相盯。先看一個 AI 自己回報「做完了」,再看另一家不採信、自己再驗一次。

自我回報有結構性盲點。補得起來的,只有「不是同一個模型」的驗證者。

換個角度:自己校對自己的稿子,同一個盲點會看兩次。但這招更貴(約 15 倍 token),兩個模型也會一起錯 —— 判準是「這段的品質風險值不值得交叉檢查」,不是「會不會比較快」。