ReAct 思考行动观察循环——小步快跑的工具调用

ReAct 是什么

ReAct（Reason + Act）是一种推理模式：Agent 在每一轮里先想一步（Thought）、做一步动作（Action）、观察结果（Observation），然后继续下一轮。循环直到任务完成或达到最大迭代次数。

适合小到中等复杂度的任务——执行链短、每步结果反馈快、可以灵活调整下一步。

工作流程

Thought → "我应该先搜索一下 Spring Boot 的最新 release"
Action → 调用 search_web 工具，参数: "Spring Boot 3.5 release notes"
Observation → 搜索结果被返回，Agent 读取摘要
↓
Thought → "看到了 3.5 有 breaking changes 关于自动配置……"
Action → 调用 summarize 工具，提炼关键变更
...继续直到完成

整个循环在 StateGraph 引擎上运行，reasoning、action、observation 都是图上的节点。用户可以看到 Thought 和 Action 过程——这是 MateClaw 的「透明执行」设计。

ReAct 的优点和局限

• 小步快跑，每步都有反馈，不容易跑偏
• 适合需要灵活调整策略的场景
• 但长任务容易在中途迷失方向（忘了最初目标是什么）——这时候 Plan-and-Execute 更合适

在 MateClaw 里怎么选

Agent 有一个类型字段：react 或 plan_execute。创建 Agent 时从模板起步（通用助手、代码助手、写作助手默认都是 ReAct），也可以直接改。切换不需要重新配工具或知识库——两种模式共用同一个 StateGraph 引擎，只是执行策略不同。