From 22897097516b9b5dc1eaaf9b7e4b86176782403c Mon Sep 17 00:00:00 2001 From: roy328line Date: Wed, 20 May 2026 22:17:51 +0800 Subject: [PATCH 1/3] Add 2026-05-20 learning notes: Frameworks + Hermes installation Added notes on frameworks and Hermes installation experience, including key insights and personal reflections. --- notes/roy328line.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/notes/roy328line.md b/notes/roy328line.md index 51925894a..306071734 100644 --- a/notes/roy328line.md +++ b/notes/roy328line.md @@ -15,6 +15,39 @@ AI x Web3 School ## Notes +# 2026-05-20 + +今日學習：Frameworks 模組深讀（LangChain / LangGraph / OpenAI Agents SDK / Hermes）+ Hermes 安裝實作 + +GitHub 筆記：https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-20.md + +## Frameworks 模組核心整理 + +**框架選擇第一原則**：先理解工作流，再決定用不用框架。框架是系統邊界的表達，不是智能本身。 + +**LangChain**：組件庫，適合快速接合模型能力與外部系統。警惕「抽象太早」——流程不清就套 chain 和 agent，後期排查困難。 + +**LangGraph**：狀態機架構，適合多輪工具調用、重試、人工確認、分支、長期運行的場景。判斷標準：只要開始關心「任務走到哪一步、是否可恢復、失敗後從哪繼續」，就應考慮 graph/state machine。 + +**OpenAI Agents SDK**：組織 Agent 工具、handoff、guardrails 和 tracing 的工程框架。關鍵仍是邊界：SDK 幫你執行流程，但你必須定義哪些工具可用、哪些需要確認、什麼算失敗。 + +**Hermes**：更適合理解為「面向工具調用和結構化輸出的模型/agent 生態」而非通用框架。核心提醒：模型本身的 tool calling 和 JSON mode 穩定性，會影響系統設計成本。工具調用能力弱的模型，再好的框架也要補大量 guard。 + +## Hermes 安裝實作心得 + +今日嘗試安裝並跑通 Hermes 環境，幾個關鍵心得： + +**環境依賴坑**：安裝前要確認 Python 版本和依賴兼容性。Hermes 對環境版本有要求，建議先用虛擬環境（venv 或 conda）隔離，避免污染系統環境。 + +**Tool Calling 測試**：跑第一個 tool calling 範例時，注意 function schema 格式需要嚴格對應。Hermes 模型在 JSON 輸出方面相當穩定，但 prompt 格式要按官方模板，不能隨意修改。 + +**與框架的差異感知**：Hermes 相比直接調用 API，多出了結構化的工具調用格式和更穩定的 JSON 輸出。實際使用中感受到：選擇「在模型層解決工具調用穩定性」還是「在框架層補 guard」是兩種不同的系統設計哲學。 + +**個人發想**：Hermes 的設計讓我重新思考「框架複雜度 vs 模型能力」的取捨——如果模型本身夠穩定（工具調用格式一致、JSON 輸出可預測），就可以少一層框架抽象，減少系統複雜度和調試成本。這對 AI x Web3 場景尤其重要：鏈上操作不可逆，任何解析失敗都可能造成資產風險。 + +明日計劃：繼續完善 Hermes 測試，準備測試網錢包實作（MetaMask + Sepolia 測試幣） + + # 2026-05-19 今日學習：深讀 Handbook Agent 模組（Tool Use / Planning / State / Reflection / Multi-Agent）+ 預習 Hermes Agent 架構 From f012ced333221c16dea0a4a5a2803d688509bc17 Mon Sep 17 00:00:00 2001 From: roy328line Date: Thu, 21 May 2026 22:24:46 +0800 Subject: [PATCH 2/3] Add daily check-in notes for May 21, 2026 Added daily check-in notes for May 21, 2026, including reflections on AI applications in Web3 and future plans. --- notes/roy328line.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/notes/roy328line.md b/notes/roy328line.md index 306071734..1ceb90e42 100644 --- a/notes/roy328line.md +++ b/notes/roy328line.md @@ -15,6 +15,31 @@ AI x Web3 School ## Notes +# 2026-05-21 + +今日學習：AI 下鄉計劃｜AI 在 Web3 的應用（Week 1 直播）+ 複習框架模組 + +GitHub 筆記：https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-21.md + +## AI 在 Web3 的應用｜核心整理 + +**AI × Web3 的核心張力**：用不確定的推理引擎（AI）驅動不可逆的執行系統（Web3）。解法方向：Simulation + Structured Output + Session Key + Human-in-the-loop + Audit Log。 + +**三個應用層次**： +- **Layer 1 輔助層**：AI 幫助理解鏈上資料，不直接執行（交易解釋、合約 ABI 翻譯、Gas 估算建議）。 +- **Layer 2 執行層**：AI 生成操作計劃，人工確認後執行（script 生成 → 人工審查 → 測試網驗證）。 +- **Layer 3 自動化層**：AI 在受限授權範圍內自動執行（Session Key 限時限額，最小權限原則）。 + +**AI 下鄉的核心設計原則**： +1. 降低 Web3 操作門檻，但不降低安全標準 +2. AI 解釋 ≠ AI 授權；AI 建議 ≠ AI 執行 +3. 每一個執行動作都需要可追溯的確認記錄 + +**個人反思**：AI 在 Web3 的真正價值，不是替代人判斷，而是讓人能夠在更多資訊下做出更好的判斷。 + +明日計劃：參加 5/22 Week 1 例會，整理本週學習成果，開始準備 Proof-of-Work Pack + + # 2026-05-20 今日學習：Frameworks 模組深讀（LangChain / LangGraph / OpenAI Agents SDK / Hermes）+ Hermes 安裝實作 From bd86e27c9cba8d2c315375181ac6065f8da8c4bf Mon Sep 17 00:00:00 2001 From: roy328line Date: Thu, 21 May 2026 22:38:08 +0800 Subject: [PATCH 3/3] Resolve conflicts: add 5/21 notes, align 5/20 with main Updated daily check-in notes with insights on frameworks and Hermes installation. --- notes/roy328line.md | 35 +++++++++++------------------------ 1 file changed, 11 insertions(+), 24 deletions(-) diff --git a/notes/roy328line.md b/notes/roy328line.md index 1ceb90e42..c0d9c16f2 100644 --- a/notes/roy328line.md +++ b/notes/roy328line.md @@ -44,37 +44,23 @@ GitHub 筆記：https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/ 今日學習：Frameworks 模組深讀（LangChain / LangGraph / OpenAI Agents SDK / Hermes）+ Hermes 安裝實作 -GitHub 筆記：https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-20.md +主要收穫： -## Frameworks 模組核心整理 - -**框架選擇第一原則**：先理解工作流，再決定用不用框架。框架是系統邊界的表達，不是智能本身。 - -**LangChain**：組件庫，適合快速接合模型能力與外部系統。警惕「抽象太早」——流程不清就套 chain 和 agent，後期排查困難。 - -**LangGraph**：狀態機架構，適合多輪工具調用、重試、人工確認、分支、長期運行的場景。判斷標準：只要開始關心「任務走到哪一步、是否可恢復、失敗後從哪繼續」，就應考慮 graph/state machine。 - -**OpenAI Agents SDK**：組織 Agent 工具、handoff、guardrails 和 tracing 的工程框架。關鍵仍是邊界：SDK 幫你執行流程，但你必須定義哪些工具可用、哪些需要確認、什麼算失敗。 - -**Hermes**：更適合理解為「面向工具調用和結構化輸出的模型/agent 生態」而非通用框架。核心提醒：模型本身的 tool calling 和 JSON mode 穩定性，會影響系統設計成本。工具調用能力弱的模型，再好的框架也要補大量 guard。 - -## Hermes 安裝實作心得 - -今日嘗試安裝並跑通 Hermes 環境，幾個關鍵心得： - -**環境依賴坑**：安裝前要確認 Python 版本和依賴兼容性。Hermes 對環境版本有要求，建議先用虛擬環境（venv 或 conda）隔離，避免污染系統環境。 - -**Tool Calling 測試**：跑第一個 tool calling 範例時，注意 function schema 格式需要嚴格對應。Hermes 模型在 JSON 輸出方面相當穩定，但 prompt 格式要按官方模板，不能隨意修改。 - -**與框架的差異感知**：Hermes 相比直接調用 API，多出了結構化的工具調用格式和更穩定的 JSON 輸出。實際使用中感受到：選擇「在模型層解決工具調用穩定性」還是「在框架層補 guard」是兩種不同的系統設計哲學。 - -**個人發想**：Hermes 的設計讓我重新思考「框架複雜度 vs 模型能力」的取捨——如果模型本身夠穩定（工具調用格式一致、JSON 輸出可預測），就可以少一層框架抽象，減少系統複雜度和調試成本。這對 AI x Web3 場景尤其重要：鏈上操作不可逆，任何解析失敗都可能造成資產風險。 +- 框架選擇第一原則：先理解工作流，再決定用不用框架。框架是系統邊界的表達，不是智能本身 + +- \- Hermes 讓我重新思考「框架複雜度 vs 模型能力」的取捨——模型本身工具調用夠穩定，就可以少一層框架抽象 + +- \- 安裝 Hermes 心得：建議用虛擬環境隔離依賴；function schema 格式需嚴格對應；prompt 格式要按官方模板 + 明日計劃：繼續完善 Hermes 測試，準備測試網錢包實作（MetaMask + Sepolia 測試幣） + +GitHub 筆記：https://github.com/IntensiveCoLearning/AI-Web3-School/pull/29 # 2026-05-19 + 今日學習：深讀 Handbook Agent 模組（Tool Use / Planning / State / Reflection / Multi-Agent）+ 預習 Hermes Agent 架構 GitHub 筆記：[https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-19.md](https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-19.md) @@ -100,6 +86,7 @@ Hermes Agent 預習：Skills 可復用高層指令集 / Long-term Memory 跨 ses + 今日學習：深讀 AI x Web3 School Handbook 模組 A（LLM / Prompt / Context / Agent）+ 模組 B（Wallet / Smart Contract / Account Abstraction） GitHub 筆記：[https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-18.md](https://github.com/roy328line/ai-web3-school-cohort-0/blob/main/daily/2026-05-18.md)