Chuyển đến nội dung chính

從零開始搭建AI代理平台-與xClaw實戰

使用 TypeScript 建立完整 AI 代理平台的實作系列 — 從 monorepo 設計、LLM 路由器、工具註冊表、RAG 管道、工作流引擎、多租戶 RBAC 到部署 Docker 生產。透過 xClaw 的實際原始碼進行學習 - 一個在生產中運行的開源平台。

系列介紹

從零開始建立人工智慧代理平台是一個實用的系列,幫助您了解並自行建立一個完整的人工智慧代理平台——不是一個簡單的聊天機器人,而是一個具有多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 許可證: 麻省理工學院