讓 AI 查得到，也守得住
以青梭紡織的 PostgreSQL 合成資料，逐步建立可驗證的 Agent 資料存取服務。
課程目標是讓 AI 理解問題、靈活組合查詢，並由後端與資料庫強制限制資料範圍、秘密與資源使用。安全不是一句提示詞，也不是安裝工具後就自動完成。
六個章節，一條主線
Section titled “六個章節，一條主線”| 章節 | 親手完成 | 帶走的證據 |
|---|---|---|
| 01 課程目標 | 分辨自然語言、參數化查詢與動態 SQL | 能說明模型與後端各自負責什麼 |
| 02 範例資料庫 | 查看訂單、出貨、各部門與機密資料 | 相同 SQL 在不同角色下有不同可見範圍 |
| 03 Keycloak SSO | 登入、驗證 Token、拒絕越權 | 未登入 401、角色不符 403 |
| 04 OpenBao | 發短效憑證、查詢、撤銷 | 舊憑證無法重登，錯誤後也清理 |
| 05 MCP | 發布三個有輸入規格的業務工具 | Agent 能探索定義並呼叫查詢 |
| 06 Agent 實驗 | 連接 Agent、自然語言提問、對照 SQL | 身分、SQL、結果、分頁與撤銷紀錄 |
本版做到哪裡
Section titled “本版做到哪裡”更新基準：2026-10-20。已建置 PostgreSQL、Grafana、pgAdmin、Keycloak、OpenBao 與 MCP；已用 ChatGPT 網頁版與 Codex CLI 真正呼叫 MCP 並查詢資料。驗收摘要與實際結果見 證據頁。
手冊是公開的靜態教材；實驗服務維持 Tailscale 私有連線。手冊沒有登入密碼、Token、解封金鑰，也不會在頁面中直接連 PostgreSQL。
如何使用本手冊
Section titled “如何使用本手冊”學員先閱讀每章「你要完成什麼」，操作後比對「驗收」。講師建置命令只在自己的獨立主機／環境執行。現有 5090 是講師示範環境，不是 50 位學員各自隔離的環境。
所有業務資料都是虛構資料。日期固定為 2026-10-20；別用今天日期比較教學答案。