系列介紹
從零開始建立人工智慧代理平台是一個實用的系列,幫助您了解並自行建立一個完整的人工智慧代理平台——不是一個簡單的聊天機器人,而是一個具有多LLM、RAG、工作流程自動化、多租戶RBAC、插件系統等的企業級平台。
整個系列均基於實際原始碼 xClaw — 在生產中運行的開源 AI 代理平台,以 TypeScript 編寫。
🎯 目標: 完成後,您可以建立自己的 AI 代理平台 - 或為 xClaw 做出貢獻。
你會學到什麼?
第 1 部分:Monorepo 架構與平台
- **第1課:**架構概述-為什麼需要平台、雙庫設計
- 第 2 課: 使用 npm 工作區和專案參考設定 TypeScript monorepo
- 第3課: 雙資料庫 — PostgreSQL (Drizzle ORM) + MongoDB + Redis
- 第 4 課: 使用 Hono 的 API 閘道 — 路由、中介軟體、JWT 驗證、OAuth2
第 2 部分:LLM 引擎和代理核心
- 第 5 課: LLM 路由器 — 具有後備鏈的 10 個 LLM 提供者的適配器模式
- 第 6 課: 工具註冊表 — 註冊、管理和執行工具
- 第 7 課: 代理類別 — 完整的工具呼叫循環、記憶體、RAG 上下文
- 第 8 課: 串流回應 — AsyncGenerator、EventBus、伺服器傳送的事件
第 3 部分:RAG 管道和知識庫
- 第 9 課: 文件處理器 — 分塊策略、元資料擷取
- 第 10 課: 嵌入與向量儲存 — 餘弦相似度、批次
- 第 11 課: RAG 引擎 — 檢索、重新排名、集合、網路爬蟲
第 4 部分:工作流程引擎與自動化
- 第 12 課: 工作流程引擎 — 16 節點類型、處理程序模式、邊緣遍歷
- 第 13 課: 驗證、執行、沙盒程式碼、範本解析
第 5 部分:技能、領域和外掛系統
- 第 14 課: 技能係統 — DefineSkill、SkillManager、基於 RL 的選擇
- 第 15 課: 域包 — 13 個區域、特定領域的提示和工具
- 第 16 課: 外掛架構、MCP 協定、Skill Hub 市場
第 6 部分:多租戶、RBAC 和通道
- 第 17 課: 多租用戶 RBAC — 角色、權限、租用戶隔離
- 第 18 課: 聊天頻道 — Telegram、Discord、Slack、Zalo、WebChat
第 7 部分:前端、監控與生產
- 第 19 課: React 前端 — 聊天 UI、工作流程產生器、儀表板
- 第 20 課: 監控、審核日誌、Docker 部署、Nginx SSL
請求
- 基本 TypeScript/JavaScript(ES2022+、非同步/等待、生成器)
- Node.js ≥ 20
- Docker 和 Docker Compose
- 對 REST API、SQL、NoSQL 的基本了解
- 使用過 ChatGPT 或 Claude API(很好,但不是必需的)
原始碼
完整原始碼參考:
git clone --recurse-submodules https://github.com/xdev-asia-labs/xClaw.git
cd xClaw
cp .env.example .env
docker compose up --build
GitHub: github.com/xdev-asia-labs/xClaw 許可證: 麻省理工學院