Universal Agent Reference · Open Source · MIT Licensed

Build a Production-Grade
AI Agent From Scratch

从零到 OpenAI/Anthropic 官方水准 — 24 节点完整参考架构
覆盖 Monorepo → ReAct Loop → MCP → Multi-Agent → RAG → Guardrals → 产品化全链路

24 参考节点
Full TypeScript
Prod 非 Demo
MIT 开源协议

Why This Exists

AI 最爱手搓。本参考告诉你每一层都有什么现成方案,以及怎么把方案连接起来。

🧩

不重复造轮子

每一层对应一张"用什么"清单。MCP 有官方 SDK、编排有 LangGraph、RAG 有 LlamaIndex、沙箱有 E2B。直接接,不要重写。

🤖

AI 避坑标注

每个节点内含 🤖 AI 避坑注释:列出 LLM 最常犯的错误模式,防止 AI 生成代码时走偏。可被 ESLint AST 自动检查。

🔗

工程逻辑解释

每个架构决策标注 🔗 工程逻辑:告诉你"为什么不那样做"——不是 taste trade-off,而是有真实的性能/安全理由。

⚡

连接模式库

"Dify + 自建前端"、"LangGraph + MCP 工具"、"Open WebUI + 自研 Agent"——9 种常见组合的对接方案,直接抄。

🚀

LATEST-ONLY

明令禁止旧技术栈:不用 HTML jQuery、不用 Express 裸写、不用 Vue 2、不用 Webpack/CJS。全部用最成熟的现代方案。

🛡️

生产级代码

不是 demo 代码。包含错误处理、边界条件、类型守卫、幂等设计、超时控制——每行都经真实工程考量。

Complete Stack

每一层都用最成熟的现代方案

Frontend
Next.js 15+ React 19+ Tailwind CSS shadcn/ui
Backend
Fastify / Hono tRPC Drizzle ORM SSE Streaming
Agent Engine
ReAct Loop LangGraph MCP Protocol OpenAI Agents SDK
Memory & RAG
Qdrant / Milvus / Chroma LlamaIndex Hybrid Retrieval 3-Tier Memory
Production
Docker + K8s OpenTelemetry Langfuse Electron

24 Reference Nodes

按需加载、渐进叠加。每一层依赖前序节点,绝不循环依赖。

01

Foundation

Turborepo · ReAct Loop · SSE · Next.js · Electron

02

Tools & Skills

Token Budget · ToolRegistry · MCP Client · Skills

03

Memory & RAG

3-Tier Memory · Hybrid Retrieval · Vector DB

04

Sandbox

Docker · Secure Code Execution · 7-Layer Defense

05

Multi-Agent

Supervisor+Worker · LangGraph · Orchestration

06

HITL & Reflection

4-Tier Approval · LLM-as-Judge Self-Reflection

07

Security

Prompt Injection Defense · Guardrails · Sandbox Escape

08

Eval & Observability

Eval Framework · OpenTelemetry · Langfuse Tracing

09

Deploy

Docker Compose · K8s · CI/CD · Electron Signing

10

Prompt Protocol

5-Layer Prompt · Template Engine · Versioning

11

Function Calling

Multi-Provider Adapter · Retry · Parallel Dispatch

12

Vector DB

Qdrant + Milvus + Chroma · Embedding · Rerank

13

Structured Output

Zod Schema · Loose Parser · Error Injection Retry

14

MCP Server Dev

Stdio+SSE Transports · Resources · Prompts · Debug

15

Knowledge Base

Multi-Format RAG · Delta Indexing · Citation

16

Multimodal

Modality Router · Image Pipeline · TTS/STT

17

Streaming Advanced

TTFT/TPOT · Sub-Token · Smart Reconnect

18

Framework Compare

LangGraph/CrewAI/AutoGen/CAMEL/MetaGPT

19

Multi-Tenancy

RLS/DB-per-Tenant · RBAC · Audit · Billing

20

Agent Marketplace

Publishing API · Security Scan · Revenue Share

21

Fault Recovery

State Snapshots · Idempotent Tools · Model Fallback

22

Guardrails/Tracing

Input/Output/Tool Guardrails · Langfuse · Spans

23

Artifacts/ComputerUse

Artifact Renderer · CLI/Headless · Ask User Q

24

Product Layer

Playground · Routing · Rate Limit · Webhooks

Deploy or Build?

开源产品能覆盖的,直接用;覆盖不了的,用我们的节点补充

场景 现成产品 本 Skill 补充
5 分钟上线 Dify / Coze — 直接用
类 ChatGPT 前端 Open WebUI — 直接用
知识库问答 RAGFlow / FastGPT — 直接用
自定义品牌 UI 无现成 参考 01/17 + Dify API
深度 Electron 桌面 无现成 参考 01 + 09
多 Agent 编排 LangGraph 参考 02/05 + MCP 连接
全自托管离线 无现成 参考全部 + Ollama/vLLM

Ready to build?

在你的 AI Agent 中一句话即可开始,或 clone 仓库直接阅读。