concepts
理念
跨框架的设计原理与心智模型——先有这些，再看具体框架。
顶层思考 · Concepts
跨框架的通用设计原理与心智模型——先有这些，再看具体框架才不会迷失在 API 细节里。
基础
- what-is-an-agent — 什么是 agent？与 workflow / chatbot / RAG 的边界
- agent-loop-paradigms — 五种核心范式：ReAct / Plan-Execute / Reflection / Graph / Model-driven
- single-vs-multi-agent — 单 agent 与多 agent：角色、通信、handoff、编排拓扑
横向骨架
- component-taxonomy — 组件总览：一个 agent 的零件清单（全库导航核心）
回到顶层
- design-tradeoffs — 核心设计权衡：轻量 vs 全家桶、命令式 vs 声明式、抽象层级、模型驱动 vs 框架驱动
关联
全部 · 5
单 Agent 与多 Agent
当单个循环难以兼顾"既要规划、又要执行、还要审查"时，把职责拆给多个各有角色的 agent，通过编排拓扑（主从/网状/流水线/群聊）与通信机制（handoff/消息/共享状态）协作。多 agent 不总是更优——它用协调成本换分工与专注。
核心设计权衡
不同框架之所以"长得不一样"，是因为它们在几条核心轴上做了不同取舍：轻量 vs 全家桶、命令式 vs 声明式、低抽象 vs 高抽象、模型驱动 vs 框架驱动、通用 vs 垂直、可控 vs 自由。看懂这些轴，就能预测一个框架的脾气，也能为自己的场景选型。
什么是 Agent
一个 LLM Agent = 模型 + 循环 + 工具/记忆：由大模型在一个循环里自主决定"下一步做什么"，调用工具观察结果、更新状态，直到达成目标或触发停止条件。区别于固定流程的 workflow，agent 的控制流是模型动态决定的。
Agent 循环范式
Agent 的"主循环"有几种典型组织方式：ReAct（边想边做）、Plan-and-Execute（先规划再执行）、Reflection（做完自我批判再改）、Graph/状态机（把控制流显式画成图）、Model-driven/CodeAct（
Agent 组件总览
把任意 agent 框架"解剖"成一份通用的零件清单：推理循环、规划、上下文工程、工具、记忆、模型抽象、技能/插件、多智能体编排、状态/持久化、可观测/评估、运行时、人在环/治理。这份清单是横向比较所有框架的统一坐标系——纵向看每个零件的不同实现，见 component-ma