# 用 Claude Desktop 建立企業 AI 知識庫
## 課程大綱與學員提示詞｜審閱稿

開場與結業都問同一題：「今天收到這個破損紙箱，依我們公司的文件，我現在該怎麼做？」開場要把規則傳給 Claude；結業只附當天的照片，Claude 透過連接器，以當前使用者的身分讀取已發布的規則並標明出處。

### 課前素材

第一輪發四份原始文件。學員在第三堂親手建立 MD 和索引。以下商品、職務分工、分機與授權均為課堂模擬。

| 文件 | 可回答的問題 |
|---|---|
| 外銷出貨與包裝驗收標準.txt | 外箱損傷要與哪個完整箱面比較？超過多少需要回報？ |
| 異常通報與升級流程.docx | 一般異常由收貨員先報倉管主管，交品管複驗。若品管確認指定外銷玻璃商品本體破裂，品管主管須提報總經理。品管確認須補換貨，由採購聯絡供應商；確認影響交期，由業務通知客戶。 |
| 來料檢驗作業說明.pptx | 如何拍照、記錄、檢驗商品並留存結果？備同版 PDF 供上傳。 |
| 通報窗口與聯絡表.xlsx | 採購、業務、品管、總經理室的課堂虛構分機各是什麼？備 CSV 供上傳。 |

第二輪分次發三張立體箱體照片。K 設計為低於 5% 的極小角損，R 為 5% 到 30% 間的局部凹損，M 為約 50% 的大範圍變形。這些比例是製圖目標。課堂只判斷是否明顯超過門檻，畫面不足時回到條文的補拍或量測流程。學員只見中性檔名，老師保留答案。外箱受損超過該箱面 30% 才回報；剛好 30% 依一般程序記錄及來料檢驗。

## 第一堂｜在一般對話分兩次上傳

**1．先讀公司文件。** 選 Claude Desktop 的對話氣泡、新增對話，再從輸入框的「＋」加入四份原始文件。

> 這四份文件是本次的公司知識庫。請列出你實際讀到的檔名，告訴我驗收門檻、通報層級、檢驗步驟與分機各要查哪份。先等我下一則傳照片。

**2．一張照片是一筆獨立到貨。** 每次只附一張圖，三次使用相同問題。請學員核對，外觀看起來不同的兩箱，是否可能依同一條文採相同處置。

> 這是另一筆獨立到貨。請先描述照片可見的損傷，再找公司知識庫裡適用的條文。告訴我是否達到通報門檻、現在誰要做什麼，附檔名與頁碼、條款或工作表。看不清的地方寫待確認。公司文件沒寫的處置請標「未載明」。

**3．只改變一個事實。** 延用嚴重外箱損傷案例，第二輪才給品管的檢驗結果。

> 補充品管紀錄：這箱裝的是流程文件指定的外銷玻璃商品，品管已確認商品本體破裂。目前沒有交期變動或補換貨決議。請重新查通報流程和聯絡表。哪個事實改變了通報層級？由誰報給誰、聯絡分機為何？每個答案附來源。

## 第二堂｜固定工作區，每次只帶新照片

**4．第二種做法：直接選「01_原始規則」。**

① 解壓縮下載的課堂素材包。
② 在 Claude Desktop 選 Code → 這台電腦，點資料夾選擇器。
③ 打開解壓後的教材，選取裡面的「01_原始規則」。四份規則已經在裡面。

> 請顯示目前工作資料夾的名稱與位置。列出這裡的四份規則檔，各用一句話說明它能回答什麼問題。

**5．在同一個工作區開新對話，再附上照片。**

① 在 Code 裡開新對話，確認資料夾仍是「01_原始規則」。若顯示別處，選回它。

② 從「03_到貨照片」把「到貨-K.png」拖到新對話的訊息輸入框。看到縮圖後，貼上右側問題。

> 這是今天到貨的紙箱。請讀取目前工作區的規則，依照片判斷是否要通報、誰負責、下一步做什麼，並列出檔名與條款。看不清楚的地方請指出來。

## 第三堂｜整理 MD，區分知識與逐筆資料

**為什麼要轉成 MD？**

- **後續查詢通常更快。** Word、Excel 要先解析文件結構、表格或儲存格。第一次轉成 MD 後，Claude 再查規則時，就能從索引直接讀相關的純文字條款。
- **讓 AI 先梳理一次。** 請 AI 依驗收順序整理整個資料夾：先看破損比例，再查通報對象，最後找聯絡窗口。把散在不同檔案的規則串起來，回答時較不易漏步驟。
- **整理後仍能核對原文。** 例如「剛好 30%」走一般驗收，「超過 30%」才進入通報流程。每條 MD 都標上原檔、條號與版本，方便回查包-02 的用字。

> 請先閱讀「01_原始規則」，依「判斷門檻 → 通報對象 → 聯絡窗口」擬一份 MD 索引草稿。每一步列出對應原檔和條號或工作表，再示範「剛好 30%」應查哪一條。

**6．先分清規則與紀錄。**

> 請分出會反覆使用的規則，以及每次收貨才產生的資料。用一筆驗收紀錄示範如何依單號查到照片、品管結果與通報狀態，沒有的值留空。

**7．切回課程資料夾，讓 Claude 按主題整理文件。**

在 Code 點資料夾選擇器，從「01_原始規則」往上一層，選取解壓後的課程資料夾。

確認能同時看到「01_原始規則」和「03_到貨照片」，再貼右側提示詞。

```text
課程資料夾
├─ 01_原始規則／（讀取原檔）
└─ 知識庫／（Claude 建立，存放 MD）
```

> 請讀取「01_原始規則」內的四份原檔，在它旁邊建立「知識庫」資料夾。保留原檔，把相關條文按主題整理到驗收標準.md、通報流程.md、來料檢驗.md、聯絡窗口.md，存入「知識庫」。
>
> 再建立「知識庫/索引.md」，連到四頁。示範「外箱破損超過 30% 要找誰？」如何從驗收標準連到通報流程，再找到窗口。標出原檔與條號或工作表，保留通-02 的升級條件。最後列出五個 MD 的路徑。

**8．比較整理前後。** 兩個新工作階段各附同一張圖，第一次指定原始文件，第二次指定索引。記錄實際花費的時間、打開哪些檔案，以及條文是否正確。

> 請用這次指定的資料來源回答同一筆到貨：依哪條規則，誰現在該做什麼？請列出實際讀取的檔名，標示仍待確認的事項。

## 第四堂｜Google Drive 與 GitHub 的分工

**9．比較兩種工具。**

> 拿同一條驗收門檻為例，說明 Google Drive 和 GitHub 如何分享、查看版本、提出修改及審查差異。說明如何從 GitHub 的 MD 回查 Drive 的原始規範。

**10．加入課程 Repo。** 學員註冊或登入 GitHub，把已驗證的 email 發到課程群組；講師依名單發出協作者邀請，學員自行接受。共編練習庫只含虛構資料；結業角色測試使用無 Repo 直接讀權的讀者帳號，以驗證 Worker 的授權。

> 請帶我確認 GitHub 帳號使用的 email、接受老師的課程 Repo 邀請，回來後檢查能否開啟 Repo。在哪一步需要我本人登入或接受邀請，請告訴我。

**11．提交、審查並追溯。**

> 在課程 Repo 用我的分支提交 MD 和索引，建立 Pull Request，請同學核對門檻、升級條件及原始來源。待老師合併後，請列出修改者、合併版本及能回查原檔的連結。

## 第五堂｜在 Cloudflare Worker 裡建立簡易 CRM

**午休實作｜一個 Worker 整合知識庫、小型 CRM 與 LINE 通訊**

午休前，先到第 22 頁複製提示詞並送出。讓 Claude 在午休時建立 Worker；下午回來一起測試。

> 請在課程 Repo 的 worker/ 建立可執行的 Cloudflare Worker，整合知識庫、小型 CRM、LINE Server 與遠端 MCP。沿用現有專案，啟動本機預覽並跑測試。
>
> CRM 管三類：員工、KB 知識、LINE 通訊。員工、資料夾、每份 MD 各有 ID；每位 LINE 聯絡人與每段對話也各有 ID。提供 boss、staff 示範帳密；boss 可讀寫全庫，staff 只能讀獲准範圍。
>
> 實作 POST /line/webhook，驗證簽章並接收文字、圖片。訊息連到發話人和對話；依權限查 MD、附條號與版本，回到原 LINE 對話。
>
> CRM 右上角加「產生 MCP 連結」：選獲准的對話及 KB 資料夾，核發可撤銷的唯讀 key，一鍵複製完整 HTTPS 網址（/mcp?api_key=…）。Claude 連接器用它讀對話、查 MD。
>
> 用「外箱某一面破損 50%」模擬收件，展示聯絡人、對話及引用的包-02；實測 staff 越權、寫入及撤銷後讀取均遭拒。交付預覽網址、測試結果及 LINE Secrets、webhook 設定步驟。

| CRM 物件 | 練習欄位 | 舉例 |
|---|---|---|
| 員工 | 員工 ID、登入帳號、密碼雜湊、職等、可讀知識範圍 | 老闆、一般員工 |
| KB 知識 | 物件 ID、類型（資料夾／檔案）、名稱、父資料夾 ID、Repo 路徑、來源版本 | 「收貨驗收」資料夾、「外箱驗收標準.md」檔案 |
| LINE 通訊 | 聯絡人 ID、對話 ID、發話人、來源及可見範圍 | 一位聯絡人可出現在私訊與群組兩段對話中 |

| 職等 | 課程預設帳號 | 預設權限 |
|---|---|---|
| 老闆 | boss | 可讀寫全部課程知識物件，設定員工可見範圍 |
| 一般員工 | staff | 可搜尋及讀取獲准範圍，不可寫入 |

兩組帳密由課程初始化程序預建。每個教學環境產生一組固定的老闆密碼及一組固定的員工密碼，交給講師作登入示範，學員免註冊。舉例：兩種職等都能看「收貨驗收」，「管理層／總經理室聯絡表」限老闆讀寫。發布後的知識內容以 GitHub 版本為依據；老闆寫入用一篇練習文件示範，保留對應的提交紀錄。

**12．管理三類物件、示範兩個員工帳號。**

> 請在 CRM 展示員工、KB 知識、LINE 通訊三類物件。用同一人在私訊與收貨群組各問一次包-02 的例子，列出一位聯絡人、兩段對話，以及兩次答覆引用的 MD 和版本。

**13．用網站確認角色與物件權限。** 點資料夾可以看見有權讀取的子物件，點檔案可以看內容與來源版本；能寫入的人可以更新課程草稿。

> 請讓我用預設帳密登入 Worker。先用 staff 打開驗收規則，確認無法修改草稿，也無法透過搜尋或直接輸入 ID 讀取受限聯絡表。再用 boss 開啟兩個資料夾，修改練習草稿的一行文字，儲存到課程 Repo 並顯示提交紀錄。請提供實際測試網址和結果。

**14．寫 Worker 時搜尋 LINE Server。** 課程延伸沿用相同 CRM 權限。

> 請在 GitHub 搜尋 LINE Server，比較 Claude 使用的 LINE MCP 與接收 LINE 圖片事件的 Worker webhook。選出適合收件的 repo，讀授權及 README、下載並記錄 commit，用測試事件確認圖片訊息 ID。說明如何將 LINE 使用者對應到 CRM 員工，讓後續查詢沿用該員工的權限。

## 第六堂｜從員工、資料夾或檔案產生 MCP，接回 Claude Desktop

**15．選擇產生 MCP 的對象。** 在員工、資料夾和檔案詳情頁都設「產生 MCP」。員工頁固定該員工的身分範圍；資料夾頁把範圍縮到該資料夾及獲准的子物件；檔案頁只涵蓋該檔。每份連線設定輸出名稱、遠端 HTTPS MCP 網址、對象與可用操作。所有設定共用同一個 Worker，服務端每次呼叫都要核對登入身分與設定範圍。

| 從哪裡產生 | 可交給 Claude 的工作 |
|---|---|
| 一般員工資料頁 | 查詢該員工有權讀取的規則；無寫入工具 |
| 老闆資料頁 | 老闆登入後可查全庫、修改課程草稿並留下版本 |
| 「收貨驗收」資料夾 | 搜尋及讀取該資料夾內已授權的子物件；老闆也只能在這個連接器的資料夾範圍內操作 |
| 「外箱驗收標準.md」檔案 | 讀取這份標準；僅具該檔寫權的身分可修改。其他檔案仍在此連接器範圍之外 |

> 請在 CRM 右上角實作「產生 MCP 連結」與「複製網址」。依登入者可讀範圍勾選對話和 MD，核發可撤銷的唯讀 key。實測允許、越權及撤銷三種結果，顯示測試表。

> 先在 CRM 右上角複製 MCP 連結。到 Claude Desktop 的「連接器」新增自訂連接器，輸入名稱、貼上含 api_key 的完整網址，儲存後在對話中啟用。

**16．學員複製 MCP 網址，在 Claude Desktop 加入連接器。** 到「自訂 → 連接器」，新增自訂網頁連接器，貼入名稱與完整 MCP 網址，以課程帳號完成 OAuth 登入授權。組織若已由管理員新增，成員直接選取並連線。回到新的「一般對話」，只啟用本次要測試的連接器。[Claude 連接器說明](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)｜[Cloudflare 遠端 MCP](https://developers.cloudflare.com/agents/model-context-protocol/guides/remote-mcp-server/)

> 我已連上課程知識庫。請實際用目前啟用的 MCP，列出我可讀的物件與可用操作，查出外箱通報門檻並附來源版本。若只連到單一檔案，就在該檔範圍內回答。

**17．結業驗收：同一張紙箱照片，切換身分或物件範圍。** 開新對話，只附照片。依序比較員工唯讀、老闆可寫、單一資料夾及單一檔案四種結果。

> 這是今天收到的紙箱。請用目前的知識庫連接器找適用條款，告訴我誰要做什麼，並附出處。若這個連接器只有驗收標準，無法取得通報流程或電話，就指出缺哪份可讀資料。只依可讀條文作答。

寫入另用測試草稿。員工的修改應遭拒，老闆在授權範圍可以成功，重新打開後可見新版本。資料夾連接器查不到範圍外的物件，單一檔案連接器無法讀到同資料夾的其他檔案。至此，學員能從 Claude Desktop 的一般對話，以自己的身分使用已發布的公司知識庫。
