#术语边界与资料索引

#术语成熟度

五个 Engineering 更适合作为设计面和排障地图，不是 OSI 式严格分层。Prompt 是 Context 的组成部分；Harness 往往承载 Prompt、Context、Loop 与 Graph；Tool Use、评测、安全、成本和可观测性横跨多层。

#易混概念

#Plan-and-Solve 与 Plan-and-Execute

Plan-and-Solve 原论文是一种零样本推理提示：先规划子任务，再逐步解题。Plan-and-Execute 是工程架构：显式保存计划，由 executor 调用工具或子 Agent，并可在每步后 replan。

#Reflection 与 Reflexion

Reflection 是任何“生成—评审—修订”循环；Reflexion 特指 Actor、Evaluator、Self-Reflection 和 episodic memory 组合，不通过更新模型参数学习。

#Router 与 Supervisor

Router 通常一次分类后分发；Supervisor 会在完整运行中持续维护总体目标，动态选择 worker 和综合结果。

#Swarm 与多 Agent

并非多个 Agent 就是 Swarm。这里的 Swarm 指没有永久中心、由当前 active agent 通过 handoff 转移控制权的拓扑。

#Tool Use 与 ReAct

Tool Use 是横切能力。单次函数调用也可以使用工具；ReAct 强调行动与环境 Observation 交错并影响后续决策。

#内容覆盖

#经典论文

1. Yao et al. ReAct: Synergizing Reasoning and Acting in Language Models, ICLR 2023.
2. Wang et al. Plan-and-Solve Prompting, ACL 2023.
3. Shinn et al. Reflexion: Language Agents with Verbal Reinforcement Learning, NeurIPS 2023.
4. Madaan et al. Self-Refine, NeurIPS 2023.
5. Du et al. Improving Factuality and Reasoning through Multiagent Debate.
6. Lewis et al. Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks, NeurIPS 2020.
7. Wu et al. AutoGen, COLM 2024.

#官方工程资料

• Anthropic：Building effective agents
• Anthropic：Effective context engineering for AI agents
• Anthropic：Writing effective tools for agents
• Anthropic：Multi-agent research system
• OpenAI：A practical guide to building agents
• OpenAI 官方文档：Agents SDK
• LangChain：Multi-agent
• LangGraph：Overview
• LangGraph Supervisor
• LangGraph Swarm
• Microsoft Agent Framework
• Hugging Face：Agent glossary
• Model Context Protocol：Architecture
• A2A 1.0 Specification
• Agent Communication Protocol
• Agent Network Protocol 规范状态

协议章节的逐条事实与固定仓库快照见 Agent 协议一手资料核验。

#Hello-Agents 图片

单 Agent 模式目录中的 4-1.png～4-4.png 来自 Datawhale Hello-Agents 第四章，本地来源快照提交为 4f7682c。原项目采用 CC BY-NC-SA 4.0；转载请继续署名、仅用于非商业目的，并按相同方式共享。该章没有 GIF。

#API 快照

代码在 2026-09-14 按当前文档核对：

• LangGraph 1.0.8：StateGraph、START、END、条件边、checkpointer、interrupt() 与 Command(resume=...)；
• OpenAI Agents SDK 0.7.0：Agent、Runner、function_tool、as_tool()、handoffs、guardrails、session 与 tracing；
• Microsoft Agent Framework：workflow executors、edges、checkpoint 和 human-in-the-loop。

框架升级可能改变导入路径或参数。运行前应再次核对官方版本说明，并用最小 smoke test 验证示例。