# L4 Hermes Agent 完整課程規劃

版本：v1.1
作者：Morris
適用層級：L4 Autonomous Agent
參考素材：知識型 Agent 架構之內部實作經驗（Hermes Agent）

> 註：本課程之概念取自內部知識型 Agent 實作經驗，僅作為教學用途。課程**只教方法論與設計原則**，不含內部程式碼、工具腳本、設定細節或專屬實作。學員上線時應依自身環境設計實作。

---

## 1. L4 重新定位

L4 不只是「讓 AI 自己跑任務」。在本方法論中，L4 Hermes Agent 的定位是：

> 把 L1 Chat、L2 Skill、L3 Workflow 升級成可持續運行的知識型 Agent 作業系統。

Hermes Agent 不是單一 Prompt，也不是只會觸發 API 的機器人。它應該具備：

1. **可持續的任務記憶**：以 Markdown 知識庫作為知識真相來源。
2. **可查詢的索引能力**：以索引資料庫（可由 Markdown 重建的衍生快取）作為查詢加速層。
3. **可組合的技能**：以「1 個主控技能 + 數個專業技能」組成 Agent 能力。
4. **可驗證的工具鏈**：用 deterministic 工具完成寫入、索引、驗證、抽取、快取、刪除保護與紀錄等「帳務性」工作。
5. **可排程的工作節奏**：用夜間消化、晨間簡報、定期探勘、晚間預覽、週度知識圖整合形成固定營運節奏。
6. **可治理的人機協作**：高風險動作保留人工 Gate，所有輸出需有證據、Log、來源與審核紀錄。

因此，L4 課程的重點不是讓學員相信 Agent 很厲害，而是讓企業知道如何把 Agent 放進可控流程中，讓它每天穩定產生可驗證的工作成果。

---

## 2. L4 知識型 Agent 的七大設計原則

這七個原則是 L4 課程的思想核心。學員若只學工具操作而不懂這些原則，做出的 Agent 會停在「會跑的 demo」，無法變成「會長大的組織能力」。

### 2.1 白天輕、夜間重

Agent 的工作節奏應該分時：

- **白天**：只做輕量、即時的事 — 收檔案、回答問題、記錄任務。不打斷使用者。
- **夜間**：做重量、批次的事 — 消化當天收進來的資料、寫入知識庫、建立跨參照、重建知識圖。

這讓 Agent 在使用者上班時「不吵」，下班後「自己長大」。

### 2.2 知識複利閉環

知識型 Agent 的價值來自**閉環自我成長**，而不是單次處理：

```text
吃進資料 → 抽出關鍵字候選 → 人工勾選 → 加入觀察清單
   ↑                                          ↓
再吃進來  ←  進待辦佇列  ←  自動探勘外部來源  ←
```

每一次 ingest 都讓下一次 ingest 更聰明。閉環任何一環斷掉（例如忘了抽關鍵字），知識庫就停止成長。

### 2.3 人類提報永遠優先於自動探勘

任務有兩個來源，優先級不同：

- **P1 — 人類提報**：使用者主動丟進來的，**當晚必清**。
- **P2 — 自動探勘**：Agent 自己從外部找到的，排在 P1 之後。

Agent 不能因為「自己找到一堆有趣的東西」就把使用者交辦的事往後延。人的需求永遠優先。

### 2.4 寫讀同源

查詢的答案可以選擇「回寫」進知識庫。於是：

> 問問題這個行為，本身也在養大知識庫。

下一次有人問類似問題，就能撈到上次整理好的答案。讀與寫共用同一個知識源，不是兩套系統。

### 2.5 工具做帳務、LLM 做判讀，不可互換角色

明確分工：

| 角色 | 負責 | 為什麼 |
|---|---|---|
| **Deterministic 工具** | 寫檔、索引、SQL upsert、格式驗證、多格式抽取、紀錄 append | 這些要 100% 準確、可重複，不該由 LLM 來「猜」 |
| **LLM / Agent** | 閱讀、分析、判斷、跨資料推理、合成答案 | 這些需要理解與判斷，工具做不到 |

兩者角色互換就會出事 — 讓 LLM 去算雜湊或寫資料庫會出錯，讓工具去判斷「這篇論文重不重要」則做不到。

### 2.6 失敗模式驅動學習

把**真實事故**記錄下來，當成 Agent 與團隊的教材：

> 「2026-XX-XX：Agent 沒先讀現況就直接寫入，造成重複頁面、沒有 Log」→ 修正：任何寫入前一定先 orient（讀目的、結構、索引、現況）。

每個失敗模式都對應一條「不可重蹈」的規則。L4 課程要教學員建立自己的「失敗模式清單」。

### 2.7 為什麼不只用 RAG

L4 要讓學員理解「知識型 Agent」與「純 RAG」的差別：

| 方案 | 問題 |
|---|---|
| **純 RAG** | 每次查詢都從原始文件重看一遍 — 成本隨資料量線性上升，知識**不複利** |
| **筆記軟體** | 需要人親自整理 — 人變成瓶頸 |
| **知識型 Agent（L4）** | Agent 在夜間先把資料「消化」成結構化知識頁與知識圖，查詢時走索引與圖譜，知識會**複利成長** |

L4 不是反對 RAG，而是讓 RAG 成為「知識型 Agent」的其中一個檢索階段，不是全部。

---

## 3. 課程目標 / Learning Objectives

> 本節以 [`ONLINE_COURSE_DESIGN_METHODOLOGY.md`](ONLINE_COURSE_DESIGN_METHODOLOGY.md) §4 的 Bloom 公式撰寫：**[動詞] + [內容] + [情境]**，可驗收、可量測。

### 3.1 給 CLP 用的 4 條主 LO（學員選課前看見的承諾）

完成 L4 課程後，學員能夠：

1. **應用** §2 七大設計原則（白天輕夜間重 / 知識複利閉環 / P1>P2 / 寫讀同源 / 工具 LLM 分工 / 失敗模式驅動 / 為何不只用 RAG），**檢視** 自己的 Agent 設計，**產出** 一份七原則自評表。（Apply）
2. **設計** 一個部門級 Hermes Agent 的使用情境，**定義** 任務邊界 / 輸入來源 / 人工 Gate / IPOE，**產出** 1 頁 Agent 任務卡 + 1 份權限矩陣。（Create）
3. **建構** Hermes Agent 的 8 件知識作業結構（目的檔 / 領域結構檔 / 收件匣 / 任務佇列 / 觀察清單 / 任務追蹤檔 / 知識庫 / 索引快取），**完成** ingest / query / update / lint / 簡報 / 探勘 / 知識圖 7 條運作流程的端到端 dry-run。（Create）
4. **評估** 部門候選任務的 L4 適配度，**判斷** 哪些任務適合 L4、哪些須留在 L1-L3、哪些延後到 L5；**產出** 1 份 L4 任務候選清單 + 1 份 L1-L5 分流地圖。（Evaluate）

### 3.2 細部能力清單（章節對應）

| 主 LO | 對應細部能力 |
| --- | --- |
| LO1（原則） | 區辨 Hermes Agent vs L1 Chat / L2 Skill / L3 Workflow；解釋為什麼不只用 RAG |
| LO2（任務設計） | 設計使用情境 / 任務邊界 / 輸入來源 / 人工 Gate；定義 IPOE |
| LO3（知識架構） | 建立 8 件知識作業結構；設計 7 條運作流程；接入 L2 Skill + L3 Workflow |
| LO4（治理 & 分流） | 建 Agent Runbook / 權限表 / 證據表 / Stage Gate / 上線檢查表；做 L1-L5 任務分流 |

### 3.3 互動學習設計（Engagement + Formative + Summative）

> 對照 [`ONLINE_COURSE_DESIGN_METHODOLOGY.md`](ONLINE_COURSE_DESIGN_METHODOLOGY.md) §5.1 + §7 + §9.4。

**Engagement activity（開頭 10 分鐘內必須有）：**

> **學員寫下「你部門最常重複、最浪費時間的 3 件工作」**，分享討論：哪些**已經有 L2 Skill / L3 Workflow 可解**？哪些**真的需要 L4 Agent 來累積知識**？哪些**根本不該自動化（人類判斷不可取代）**？10 分鐘，把 §2 七大設計原則的第 2.3 條（P1>P2）變成個人感受。

**Formative gates（章節結尾的快速自我檢核）：**

| 章節 | Formative 檢核 | 時長 |
|---|---|---|
| §2 七大原則結尾 | 學員拿自己 §3.3 寫的 3 個工作，用七原則自評表判斷 | 15 分鐘 |
| §7.1 Foundation 結尾 | 每人交 1 頁 Agent 任務卡（部門 / 邊界 / 輸入 / Gate） | 20 分鐘 |
| §7.2 Builder ingest 後 | 同儕互審 ingest 結果（log / 關鍵字 / index 看一眼） | 15 分鐘 |
| §7.2 Builder Gate 4 前 | Skill Library 完整性檢查（mission / inputs / outputs / owner / version 五欄齊全） | 10 分鐘 |

**Summative gate（全課程結尾）：**

對應 **Gate 4A-4E**（見 §10）。包含 12 個產出 → 詳見 §12 Deliverables。

### 3.4 Reference materials 清單

| 類型 | 檔名 / 位置 | 用途 | 狀態 |
|---|---|---|---|
| 七大設計原則自評表 | 上方 §2 已定義 7 條 | 學員自評 Agent 設計 | ☑ 已有 |
| Skill Library JSON 範本 | 下方 §3.5 | 統一所有 Skill 規格 | ☑ 已加（§3.5） |
| 目的檔範例 | 下方 §3.6 | 學員填空式起步 | ☑ 已加（§3.6） |
| Hermes Agent 架構圖 | 下方 §3.7 ASCII 圖 | Foundation 課用 | ☑ 已加（§3.7） |
| Agent 任務卡 1 頁範本 | [`_deliverables/L4_AGENT_TASK_CARD.md`](_deliverables/L4_AGENT_TASK_CARD.md) | §7.1 課堂作業；IPOE / Human Gate / KPI / 風險 / Gate 4 | ☑ 已加 |
| Agent Runbook 範本 | [`_deliverables/L4_HERMES_AGENT_RUNBOOK.md`](_deliverables/L4_HERMES_AGENT_RUNBOOK.md) | 上線後維運 SOP、故障處理、Rollback、升版、Post-mortem | ☑ 已加 |

### 3.5 Skill Library JSON 範本（高優先補強）

每個 Skill 用統一 schema 描述，方便跨 Agent 重用、版本管理、權限控制：

```json
{
  "skill_name": "Keyword Extraction",
  "version": "1.0.0",
  "owner": "knowledge_team@company.com",
  "mission": "從技術文件、SOP、報告中提取關鍵詞，用於知識索引與檢索",
  "inputs": {
    "document": {
      "type": "string | path",
      "description": "PDF / docx / md 檔案路徑或內容"
    },
    "doc_type": {
      "type": "enum",
      "values": ["SOP", "article", "report", "meeting_minutes"],
      "description": "影響關鍵詞抽取策略"
    }
  },
  "outputs": {
    "keywords": {
      "type": "array<string>",
      "description": "≤ 10 個關鍵詞，按重要性排序"
    },
    "confidence": {
      "type": "float",
      "range": [0, 1],
      "description": "整體抽取信心度；< 0.5 須人工確認"
    }
  },
  "human_gate": {
    "trigger_condition": "confidence < 0.5 OR doc_type == 'report'",
    "reviewer_role": "knowledge_owner",
    "sla_hours": 24
  },
  "depends_on": [],
  "used_by_agents": ["KnowledgeIngestAgent", "QueryAgent"]
}
```

### 3.7 Hermes Agent 架構圖（高優先補強）

> 對應 §3.4 reference materials 「Hermes Agent 架構圖」要求。Foundation 課（§7.1）用這張圖建立全體共識。

```text
                ┌─────────────────────────────────────────┐
                │   人類使用者 / Human Caller             │
                │   (CEO / 部門主管 / 知識工作者)         │
                └────────────────┬────────────────────────┘
                                 │ Query
                                 ▼
       ┌────────────────────────────────────────────────────┐
       │                Hermes Agent  Core                  │
       │  ┌──────────────────────────────────────────────┐  │
       │  │  Mission File (mission.md, §3.6)             │  │
       │  │  • Allowed / Forbidden input types           │  │
       │  │  • Decision boundary                         │  │
       │  └──────────────────────────────────────────────┘  │
       │                                                    │
       │  ┌──────────────┐  ┌──────────────┐  ┌──────────┐  │
       │  │ Orient first │→│   Query        │→│ Update   │  │
       │  │ (read state) │  │ (look-up,      │  │ (write   │  │
       │  │              │  │  reasoning)    │  │  back)   │  │
       │  └──────────────┘  └──────────────┘  └──────────┘  │
       │           │              │                │        │
       │           ▼              ▼                ▼        │
       └────────┬─────────────┬────────────┬───────────────┘
                │             │            │
   ┌────────────▼────┐ ┌──────▼──────┐ ┌───▼────────────────┐
   │ Knowledge Base  │ │ Index Cache │ │ Task Tracking File │
   │ (purpose +      │ │ (fast       │ │ (provenance + log) │
   │  domain struct) │ │  lookup)    │ │                    │
   └────────┬────────┘ └──────┬──────┘ └────────────────────┘
            │                 │
            │                 │
        ┌───▼─────────────────▼───┐
        │  Skill Library (§3.5)   │  ← L2 Skills 由此接入
        │  (JSON schema, owner,   │
        │   human_gate, version)  │
        └────────────┬────────────┘
                     │
                     ▼
       ┌──────────────────────────────────────────────┐
       │  Background Workers (夜間 / Off-peak)        │
       │  • Ingest    (新文件 → 解析 → 抽取 → 寫入)   │
       │  • Lint      (knowledge base 一致性檢查)     │
       │  • Briefing  (每日早報 / 趨勢摘要)           │
       │  • Discovery (新 source 探勘)                │
       └──────────────────────────────────────────────┘
                     ▲
                     │
                     │  夜間自動 ingest
       ┌─────────────┴─────────────────┐
       │   External Sources             │
       │   • L3 Workflows (n8n)         │
       │   • Inbox (Email / Notion)     │
       │   • Watchlist (RSS / Twitter)  │
       │   • Manual upload              │
       └────────────────────────────────┘
```

**七大運作流程在圖中的對應：**

| Flow | 圖中對應 |
|---|---|
| ingest | External Sources → Background Workers (Ingest) → Knowledge Base |
| query | Human Caller → Hermes Core (Query) → Knowledge Base + Index Cache |
| update | Hermes Core (Update) → Knowledge Base + Task Tracking File |
| lint | Background Workers (Lint) → Knowledge Base 一致性檢查 |
| 簡報 | Background Workers (Briefing) → Morning report |
| 探勘 | Background Workers (Discovery) → 新 source 加入 Watchlist |
| 知識圖整合 | Knowledge Base 內部跨檔串連（隱含於 ingest + lint 階段）|

**§2 七大設計原則在圖中的位置：**

- 「白天輕夜間重」→ Background Workers 都跑在 off-peak
- 「知識複利閉環」→ Update 路徑回寫 Knowledge Base，下次 query 看得到
- 「P1>P2」→ Mission File 定義 Allowed / Forbidden（P2 直接被擋）
- 「寫讀同源」→ Knowledge Base 同時是寫入目標 + 查詢來源
- 「工具 / LLM 分工」→ Skill Library 切出可重用的工具呼叫；LLM 只在 orient / reasoning 階段
- 「失敗模式驅動學習」→ Task Tracking File 留下所有錯誤，下一輪 ingest 修正規則
- 「為何不只用 RAG」→ Background Workers 預先把文件「結構化」存入 Knowledge Base，query 時走 Index + Skill，不是每次都做 vector search

### 3.6 目的檔（mission.md）範例

每個 Hermes Agent 一個目的檔，作為 Agent 第一次啟動時讀的「人生說明書」：

```markdown
# Mission (For relevance filtering)
本 Agent 服務製造業品保部門，協助累積 QC SOP、不良品案例、製程改善知識。

## Allowed input types
- QC 報告（每日 / 週 / 月）
- 物料規格表
- 製程 SOP
- 不良品分析報告

## Forbidden input types
- 組織人事資料
- 財務數據
- 客戶 PII（姓名 / 電話 / Email）
- 跨部門資料（行銷 / HR）—— 請走對應部門的 Agent

## Output style
- 摘要 ≤ 200 字
- 引用必須註明來源檔 + 段落
- 數據與規格直接列表，不做主觀詮釋

## Decision boundary
- Confidence < 0.7：必須人工確認，不自動寫入知識庫
- 出現上述 Forbidden 類型：立刻 reject 並通知 owner
- 跨 SOP 衝突：標註衝突，不選邊
```

---

## 4. 適合對象

| 對象 | 課程重點 |
|---|---|
| 部門主管 | Agent 能解決什麼管理問題、如何驗收成果、如何設 Gate |
| IT / 系統部門 | 部署、權限、資料路徑、工具、排程、Log、索引與維運 |
| 流程 Owner | 哪些工作可以交給 Agent 準備、整理、提醒、追蹤 |
| 知識工作者 | 如何把文件、資料、研究、會議與任務轉成 Agent 可長期累積的知識庫 |
| 顧問 / PM | 如何用 L4 作為 AI 轉型診斷後的 PoC 或導入方案 |

---

## 5. 課前條件

| 項目 | 最低要求 |
|---|---|
| L1 | 已有 OpenWebUI 或等效 Chat AI 入口 |
| L2 | 至少有 1-3 個可重複使用的 Skill 或 Prompt SOP |
| L3 | 至少有 1 個可呼叫的 n8n Workflow 或 API 流程 |
| 資料 | 有可訓練的範例文件、SOP、FAQ、報告、研究資料或客戶案例 |
| 治理 | 已定義不可碰資料、人工審核點、輸出責任人 |
| 技術 | 已確認雲端、Hybrid 或全地端部署模式 |

---

## 6. L4 Input / Process / Output / Evidence

| 類別 | 定義 |
|---|---|
| Input | 客戶任務、部門文件、PDF、SOP、FAQ、研究資料、API 回傳、n8n Workflow 結果、L2 Skill、目的檔、領域結構檔、觀察清單、任務佇列、權限表 |
| Process | orient-first、bootstrap、ingest、來源分析、關鍵字抽取、索引更新、query、update、lint、自主探勘、簡報、知識圖整合、人工審核 |
| Output | 知識庫頁面、來源分析、概念/實體/主張頁面、查詢回答、每日簡報、待審觀察清單、任務追蹤清單、Agent 執行紀錄、改善建議、上線報告 |
| Evidence | 環境健檢結果、技能安裝清單、設定檔、知識庫檔案、Log、索引查詢結果、佇列/觀察清單/任務檔、簡報 email、n8n 執行紀錄、人工審核紀錄、Gate 簽核 |

---

## 7. 完整課程版本

### 7.0 Lecture Map（依 [`ONLINE_COURSE_DESIGN_METHODOLOGY.md`](ONLINE_COURSE_DESIGN_METHODOLOGY.md) §5.3 切細）

#### 7.0.1 §7.1 Foundation 完整 Lecture Map（~50 lectures × 平均 4.4 min = 220 min / 3.5 hr，含 buffer）

> 講座類型代碼：**TH** = Talking Head / **S** = Screencast / **SL** = Slides / **VS** = Visual / **PR** = Practice / **EN** = Engagement / **RC** = Recap。

##### Section 0 — Introduction（10 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 0.1 | 歡迎來到 L4 Hermes Agent | TH | 3 | 講師介紹 + 為什麼知識型 Agent 是部門級競爭力轉折 |
| 0.2 | 你會學到什麼 | TH+SL | 2 | 4 條主 LO 預告 |
| 0.3 | **Engagement：寫下 3 個部門最浪費時間的工作** | EN+PR | 5 | 學員 brainstorm → 投票最值得 L4 解決的 1 個 |

##### Section 1 — L4 定位（30 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 1.1 | L1 Chat 的極限 | SL | 4 | 無記憶 / 無治理 |
| 1.2 | L2 Skill 的極限 | SL | 4 | 無上下文累積 |
| 1.3 | L3 Workflow 的極限 | SL | 4 | 無自主判斷 |
| 1.4 | 什麼是 Hermes Agent | SL+VS | 5 | 知識累積 + 自主編排 |
| 1.5 | L4 vs RAG | SL | 4 | 為什麼不只用 RAG |
| 1.6 | L4 不是萬靈丹 | TH | 5 | 何時不該用 L4 |
| 1.7 | 章節 recap | RC | 4 | L1-L4 對位圖 |

##### Section 2 — 七大設計原則（40 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 2.1 | 原則 1：白天輕夜間重 | SL | 5 | 何時 ingest，何時 query |
| 2.2 | 原則 2：知識複利閉環 | SL | 5 | 每次 update 都讓下次更聰明 |
| 2.3 | 原則 3：P1 > P2 | SL | 5 | Mission File 守第一道門 |
| 2.4 | 原則 4：寫讀同源 | SL | 5 | Knowledge Base 是雙向 |
| 2.5 | 原則 5：工具 / LLM 分工 | SL | 5 | Skill 是工具，LLM 是 orchestrator |
| 2.6 | 原則 6：失敗模式驅動學習 | SL | 5 | Task Tracking File 的價值 |
| 2.7 | 原則 7：為何不只用 RAG | SL | 5 | 結構化 ingest vs 即時 retrieval |
| 2.8 | **Formative：拿 §3.3 任務跑七原則自評** | PR | 5 | 學員自評 |

##### Section 3 — Hermes 架構（40 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 3.1 | 架構圖總覽（§3.7） | SL+VS | 5 | 5 個核心元件 |
| 3.2 | Mission File | S | 4 | 第一道門 |
| 3.3 | Knowledge Base | S | 5 | 結構化 vs 純 vector |
| 3.4 | Index Cache | S | 5 | 為什麼要 cache |
| 3.5 | Skill Library | S | 5 | JSON schema 統一 |
| 3.6 | Task Tracking File | S | 5 | provenance + 失敗紀錄 |
| 3.7 | Background Workers | SL | 5 | 4 大背景任務 |
| 3.8 | 章節 recap | RC | 6 | 架構 + 7 條 flow 對應 |

##### Section 4 — 企業情境（40 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 4.1 | 製造業：QC 知識累積 | SL | 6 | Use case + Skill 組合 |
| 4.2 | 醫院：病例知識整合 | SL | 6 | 跨科別查詢 |
| 4.3 | 客服：FAQ + 案例知識 | SL | 5 | 持續長大的 FAQ |
| 4.4 | 法務：合約 / 法規追蹤 | SL | 5 | 監管變動感知 |
| 4.5 | 行銷：競品 + 內容資料庫 | SL | 5 | 內容再利用 |
| 4.6 | 研發：論文 / 專利 / 內部研究 | SL | 5 | 知識圖譜起步 |
| 4.7 | **Formative：選 1 個情境配 §3.3 的任務** | PR | 8 | 學員配對 |

##### Section 5 — IPOE 與 Stage Gate（30 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 5.1 | IPOE 四欄回顧 | SL | 5 | Input / Process / Output / Evidence |
| 5.2 | Gate 4A：環境可用 | SL | 5 | 5 個 evidence |
| 5.3 | Gate 4B：知識底座可用 | SL | 5 | 領域結構檔 + 索引 |
| 5.4 | Gate 4C：Ingest 閉環 | SL | 5 | 來源頁 + Log |
| 5.5 | Gate 4D：查詢更新可用 | SL | 5 | query record + diff |
| 5.6 | Gate 4E：營運治理可用 | SL | 5 | 排程 + 簡報 + 失敗模式 |

##### Section 6 — Workshop：Agent 任務卡草稿（40 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 6.1 | 任務卡 1 頁範本介紹 | SL | 5 | 部門 / 邊界 / 輸入 / Gate |
| 6.2 | 範例任務卡 demo | S | 5 | 製造業 QC Agent 範本 |
| 6.3 | 學員開始填卡（前 15 分） | PR | 15 | 用自己 §3.3 任務 |
| 6.4 | 同儕互審（10 分） | PR | 10 | 找盲點 |
| 6.5 | 章節 recap | RC | 5 | 任務卡 5 欄檢查 |

##### Section 7 — Conclusion（10 min）

| # | Lecture title | Type | Min | Content / Hook |
| --- | --- | --- | --- | --- |
| 7.1 | 課程回顧 | TH | 3 | 4 個 LO + 任務卡草稿 |
| 7.2 | L4 Builder / Operator 預告 | SL | 3 | §7.2 / §7.3 下一步 |
| 7.3 | L5 銜接：何時該升 Multi-Agent | TH | 2 | 升級 trigger |
| 7.4 | 恭喜 + 下一步 | TH | 2 | 結語 |

#### 7.0.2 §7.2 Builder Lecture Map（stub）
`8 hours = ~120 lectures。Section 結構：Intro → 環境健康檢查 → 技能安裝 → 設定初始化 → Bootstrap 知識庫 → Ingest 實作 → Query / 寫讀同源 → L2/L3 接入 → Gate 4 驗收 → Conclusion。`

#### 7.0.3 §7.3 Operator Lecture Map（stub）
`2 days = ~240 lectures。Section 結構：Intro → Orient-first SOP → Update mode → Lint/schema → 自主探勘 → 簡報節奏 → 知識圖整合 → 排程/Runbook → 失敗模式演練 → Governance → Demo day。建議切成 4 個半日 mini-course。`

---

### 7.1 L4 Foundation：3 小時

目標：讓主管與種子團隊理解 Hermes Agent 的價值、限制與驗收方式。

| 時間 | 主題 | 內容 | 產出 |
|---|---|---|---|
| 30 分 | L4 定位 | Agent vs Chat vs Skill vs Workflow | L4 共識圖 |
| 40 分 | 七大設計原則 | 第 2 節七大原則：白天輕夜間重、知識複利、P1>P2、寫讀同源、工具/LLM 分工、失敗模式、為何不只用 RAG | 設計原則檢核表 |
| 40 分 | Hermes 架構 | 知識庫、索引快取、技能組成、工具鏈、結構契約、政策 | Hermes 架構圖 |
| 40 分 | 企業情境 | 研發、製造、醫院、客服、法務、行銷案例 | L4 情境候選清單 |
| 30 分 | IPOE 與 Stage Gate | Input / Process / Output / Evidence、Gate 4A-4E 與人工審核 | L4 IPOE 表、Gate 表 |
| 40 分 | 工作坊 | 選一個部門任務改寫成 Hermes Agent 任務 | Agent 任務卡草稿 |

### 7.2 L4 Builder：1 天

目標：建立可運行的 Hermes Agent PoC。

| 時間 | 主題 | 內容 | 產出 |
|---|---|---|---|
| 60 分 | 環境健康檢查 | 環境健檢、gateway、model、權限與路徑確認 | 環境檢查紀錄 |
| 60 分 | 技能安裝 | 安裝主控技能與專業技能 | 技能安裝清單 |
| 60 分 | 設定初始化 | 設定知識庫路徑、語言、索引、通知收件人、探勘時間窗 | Agent 設定檔 |
| 90 分 | Bootstrap 知識庫 | 建立知識庫、領域結構檔、目的檔、索引快取 | 初始知識庫 |
| 90 分 | Ingest 實作 | 匯入一份 PDF / SOP / FAQ，產生來源分析 | 來源頁與 Log |
| 60 分 | Query / 寫讀同源 | 用引用回答問題，將查詢結果回寫知識庫 | Query record |
| 60 分 | L2/L3 接入 | 呼叫 Skill 與 n8n Workflow，形成 Agent 任務鏈 | Agent test run |
| 60 分 | Gate 4 驗收 | 檢查 evidence、權限、Log、人工審核 | Gate 4A-4C 紀錄 |

### 7.3 L4 Operator：2 天

目標：讓 Hermes Agent 從 PoC 變成可維運的部門作業。

| 時間 | 主題 | 內容 | 產出 |
|---|---|---|---|
| 90 分 | Orient-first SOP | 每次 Agent 開工前先讀取領域結構、結構契約、目的檔、收件匣、索引、Log | Agent 開工 SOP |
| 90 分 | Update mode | 讓 Agent 修改既有知識頁，保留 diff、原因與 log | 更新紀錄 |
| 90 分 | Lint / schema | 檢查 frontmatter、cross-ref、缺漏欄位、壞連結 | Lint report |
| 90 分 | 自主探勘 | 設定觀察清單，從外部來源收集 metadata，不直接 ingest（落實 P1>P2） | P2 佇列 |
| 90 分 | 簡報節奏 | 產生晨間簡報、晚間預覽、定期 ping（落實白天輕夜間重） | 簡報報告 |
| 90 分 | 知識圖整合 | 找概念關聯、矛盾、缺口與下一步任務 | Graph insight |
| 90 分 | 排程 / Runbook | 夜間消化、晨間簡報、探勘 ping、週度 lint | 維運排程表 |
| 90 分 | 失敗模式演練 | 建立部門自己的失敗模式清單與對應規則 | 失敗模式清單 |
| 90 分 | Governance | 權限、資料分級、人工 Gate、fallback、事故處理 | L4 治理表 |
| 90 分 | Demo day + Roadmap | 每組展示一個 Hermes Agent 完整閉環、規劃 L4-to-L5 | Demo、驗收、Roadmap |

---

## 8. 技能組成：主控技能 + 專業技能

L4 Hermes Agent 的能力不是一個大 Prompt，而是「1 個主控技能 + 數個專業技能」的組合。課程教學員理解這個組合模式，而非背特定技能名稱。

| 技能類型 | 課程定位 | 學員要會什麼 |
|---|---|---|
| **主控技能（知識庫管理）** | Hermes Agent 的協調中樞 | bootstrap、ingest、query、update、lint、知識圖整合、schema 演進 — 主控技能負責「編排」，把工作分派給專業技能 |
| **來源分析技能** | 嚴謹來源分析 | 將 PDF、文章、報告、法規、影片逐一轉成結構化分析 |
| **關鍵字抽取技能** | 知識擴張 | 從新資料抽出關鍵字候選，交由人工 approve / reject（閉環的關鍵一環） |
| **自主探勘技能** | 自主發現 | 根據觀察清單到外部來源找 metadata，加入佇列，但不直接 ingest |
| **簡報生成技能** | 營運節奏 | 產生晨間簡報、晚間預覽、定期 ping、週度知識圖摘要 |

> **技能組合原則**：主控技能只負責「編排與決策」，專業技能只負責「單一專精工作」。新增能力時是「加一個專業技能」，不是「把主控技能改肥」。這讓 Agent 能力可擴充、可審查、可替換。

---

## 9. L4 Stage Gate 控制

| Gate | 檢查問題 | 必備 Evidence | 判定 |
|---|---|---|---|
| Gate 4A：環境可用 | Hermes、模型、gateway、權限是否可用？ | 環境健檢結果、model list、gateway status | Pass / Fail |
| Gate 4B：知識底座可用 | 知識庫、領域結構、目的、索引是否建立？ | 領域結構檔、目的檔、索引快取、初始化 log | Pass / Fail |
| Gate 4C：Ingest 閉環可用 | Agent 能否吃文件、分析、寫入、索引、留 Log、抽關鍵字？ | 來源頁、概念/實體/主張頁、log、索引查詢、關鍵字候選 | Pass / Fail |
| Gate 4D：查詢與更新可用 | Agent 能否用證據回答、回寫結果、保留紀錄？ | query record、update diff、引用來源、人工審核紀錄 | Pass / Fail |
| Gate 4E：營運與治理可用 | 是否有排程、簡報、觀察清單、佇列、人工 Gate、失敗模式清單？ | 排程設定、簡報、佇列、觀察清單、權限表、失敗模式清單、Gate 簽核 | Pass / Fail |

未通過 Gate 4A-4C 時，不進入部門上線。未通過 Gate 4D-4E 時，可以做展示，但不能宣稱為可營運的 L4 Agent。

---

## 10. L4 控制表

| 控制項 | 欄位 | 說明 |
|---|---|---|
| Agent 任務卡 | 角色、任務、使用者、資料源、禁止事項、人工 Gate | 定義 Agent 能做什麼與不能做什麼 |
| Input Register | 文件、API、Workflow、Skill、資料等級、Owner | 確認 Agent 吃進來的資料可用且可授權 |
| Process Map | orient、ingest、query、update、簡報、探勘、lint | 確認每一步有 SOP |
| Output Register | 知識頁、報告、摘要、提醒、任務、更新 | 確認輸出可被業務使用 |
| Evidence Register | Log、索引、引用、執行紀錄、審核紀錄 | 確認成果可驗證 |
| Risk Register | 幻覺、錯誤引用、資料外洩、過度自動化、未授權修改 | 確認風險有控制 |
| 失敗模式清單 | 事故描述、根因、對應規則 | 落實「失敗模式驅動學習」原則 |
| Stage Gate | 4A-4E | 確認能否進下一階段 |

---

## 11. 課堂練習

### 練習 1：L4 任務拆解

將「每週整理客訴與改善建議」改寫為 Hermes Agent 任務。

必填：

- 使用者是誰？
- Agent 哪些事白天做、哪些事夜間做？（落實原則 2.1）
- 需要吃哪些文件、系統與 Workflow？
- 哪些動作只能產生草稿，不能自動送出？
- 主管用什麼 evidence 驗收？

### 練習 2：建立目的與領域結構

為一個部門 Agent 建立：

- 目的檔（為什麼做這個 Agent — 相關性過濾依據）
- 領域結構檔（來源類型、概念類型、禁止事項、領域紅旗）

### 練習 3：Ingest 一份資料並走完閉環

輸入一份 PDF、SOP、FAQ 或報告，產出：

- 來源分析
- 來源頁
- 關鍵字候選（閉環關鍵一環，不可略過）
- log
- 索引查詢結果

### 練習 4：產生簡報

根據收件匣、任務佇列、觀察清單、任務追蹤檔產生一份主管可讀的晨間簡報。

### 練習 5：建立失敗模式清單

每組依原則 2.6，寫出 3 個自己部門可能遇到的 Agent 失敗模式，並為每個失敗模式定一條「不可重蹈」規則。

### 練習 6：設計 Gate 4

每組設計自己的 Gate 4A-4E 判定表，並說明哪些 evidence 不足時不能上線。

---

## 12. L4 Deliverables

| Deliverable | 說明 | 驗收方式 |
|---|---|---|
| L4 Hermes Agent 任務卡 | 定義角色、任務、邊界、工具、人工 Gate | 部門主管簽核 |
| 七大設計原則檢核表 | 用第 2 節原則檢視自己的 Agent 設計 | 顧問審核 |
| L4 IPOE 表 | 定義 input、process、output、evidence | 顧問與 IT 審核 |
| Hermes Agent 架構圖 | 說明知識庫、索引、技能組成、工具、排程、OpenWebUI / n8n 的關係 | 課堂展示 |
| 初始知識庫 | 建立目的、領域結構、收件匣、佇列、觀察清單、任務檔 | 檔案與截圖 |
| Ingest 測試紀錄 | 至少匯入 1 份真實或樣本文件並走完閉環 | 來源頁、log、索引、關鍵字候選 |
| Query / Update 測試紀錄 | 至少完成 3 個可追溯查詢與 1 次回寫 | query record、update diff |
| 簡報範本 | 晨間簡報或週度簡報 | 報告樣本 |
| 失敗模式清單 | 部門自己的失敗模式與對應規則 | Owner 簽核 |
| L4 Stage Gate 表 | Gate 4A-4E | 簽核紀錄 |
| 維運 Runbook | 排程、監控、fallback、人工審核、事故處理 | IT / Owner 驗收 |

---

## 13. 產業調整

| 產業 | L4 推薦切入點 | 特別注意 |
|---|---|---|
| 研發製造業 | 技術文件知識庫、客訴摘要、異常原因整理、ERP 異常報告草稿 | 不直接改 ERP 核心資料，先做建議與追蹤 |
| 行銷服務業 | 提案素材庫、競品監控、活動簡報、客戶週報草稿 | 可較快導入外部探勘，但需標記來源可信度 |
| 醫院 / 醫療 | 院內 SOP 查詢、客服 FAQ 草稿、品質事件摘要、研究文獻簡報 | 不做診斷與治療建議，高風險內容必須人工審核 |
| 法務 / 金融 | 法規追蹤、案例摘要、風險提醒、投研資料整理 | 強化引用、版本、審核、資料留存與合規 |
| 內部管理 | 會議紀錄、任務追蹤、政策問答、跨部門進度簡報 | 明確資料權限與責任歸屬 |

---

## 14. 部署模式調整

| 模式 | L4 課程調整 |
|---|---|
| 雲 AI | 快速展示 Agent 閉環，適合 PoC、知識整理、非機敏文件 |
| Hybrid | 文件與索引可留在內部，模型或部分 API 走雲端，適合多數企業導入 |
| 全地端 | 強化模型、gateway、內網資料、權限、Log、備份、稽核與維運，課程需增加技術實作時間 |

---

## 15. L4 到 L5 的銜接條件

只有當 L4 已具備以下能力時，才建議進入 L5 ClawTeam：

1. 至少 1 個 Hermes Agent 通過 Gate 4A-4E。
2. Agent 的 input、process、output、evidence 都可追溯。
3. 已有穩定的知識庫記憶、Log、索引與簡報節奏。
4. 七大設計原則皆已落實（特別是知識複利閉環與失敗模式清單）。
5. 已有至少 2 個可重複呼叫的 L2 Skill。
6. 已有至少 1 個穩定的 L3 Workflow。
7. 高風險決策有人工 Gate 與責任 Owner。

L5 不是把多個不穩定 Agent 放在一起，而是讓已經可治理的 L4 Agent 進入團隊協作。
