无耳 Solon (OpenSolon) | react - ReActAgent 像人类一样思考与行动

在 AI 应用从“对话”迈向“作业”的进程中，大模型不应只是一个简单的聊天框，而应是能自主解决问题的“作业员”。ReActAgent 是 Solon AI 框架中基于 ReAct (Reason + Act) 范式实现的核心智能体。

它通过 “规划？ - 思考 - 行动 - 观察” 的认知闭环，赋予 LLM 自主调用外部工具（API、数据库、本地函数）的能力，并能根据执行结果动态修正行为。

1、什么是 ReActAgent？

ReActAgent 是智能体的“行动派”。它打破了传统 AI 只能“预测文本”的局限，让模型具备了逻辑推理 (Reasoning) 与外部工具调用 (Acting) 的协同能力。

通过 ReActAgent，LLM 不再是纸上谈兵，而是能读写文件、操作数据库、调用业务接口的“数字员工”。最重要的是，它对不支持原生 Tool-Call 的轻量级大模型极其友好。

计算示意图：

2、核心工作原理：推理 + 行动

ReAct 模式强制模型在执行任务时遵循一个严密的认知逻辑循环：

Plan (规划)： 可选步骤。模型分析复杂指令，将其分解为多步子任务。
Thought (思考)： 模型进行自我对话，分析当前现状：“为了完成目标，我下一步该做什么？”。
Action (行动)： 模型决定调用哪一个工具（Tool），并生成具体的调用参数。
Observation (观察)： 模型接收工具返回的真实数据（如 SQL 查询结果、实时天气、API 响应）。
Update (自适应)： 模型根据观察到的结果更新思考，决定是继续下一步行动，还是产出最终答案。

优势：可极大地降低了模型的幻觉（Hallucination），因为每一步决策都建立在真实观测数据的基础之上。

3、关键特性

自适应规划：能够理解模糊指令，自动将复杂任务拆解为可落地的路线图。
无缝工具（Tool）和技能（Skill）集成：支持 Solon 标准的 Tool 和 Skill 接口，轻松接入业务 API。
思维链追踪 (Trace)：完整记录 Agent 的思维轨迹，让每一个决策过程都透明、可追溯、可审计。
鲁棒性控制：内置迭代上限 (Max Steps) 机制，有效防止逻辑陷阱导致的无限递归。
轻量化设计：完美融入 Solon 生态，保持了一贯的简洁与高性能，开箱即用。

4、快速开始：三分钟上手

体验上和 ChatModel 有些像。仅需几行代码，即可创建一个具备“搜索”能力的智能体。

// 1. 定义一个工具（比如搜索工具）
public class SearchTool {
    @ToolMapping("在互联网上搜索最新的资讯")
    public String search(@Param String query) {
        return "2026年Solon AI正式发布3.8版本..."; // 模拟返回
    }
}

// 2. 创建并运行 ReActAgent
public void runAgent() {
    ChatModel model = LlmUtil.getChatModel();

    Agent searcher = ReActAgent.of(model)
            .description("我能通过搜索回答你关于最新科技的问题")
            .defaultToolAdd(new SearchTool()) // 注入工具
            .build();

    String result = searcher.prompt("Solon AI 现在的版本是多少？").call().getContent();
    System.out.println(result);
}

5、典型应用场景

智能数据分析：根据用户自然语言指令，自动调用 SQL 工具查询数据库，并对结果进行总结报告。
自动化客服：集成订单管理、库存查询等 API，提供个性化、实时的用户支持。
智能助手：调用日历、邮件、待办事项工具，帮助用户管理日程和任务。
内容自动化：结合外部信息源，自动撰写新闻稿、营销文案或技术文档。

6、项目优势

双模协议适配 (Hybrid Mode)

并非所有模型都完美支持 OpenAI 风格的 ToolCall。ReActAgent 提供双模驱动：

原生模式 (Native)：利用 GPT-4、DeepSeek 等模型原生的 tool_calls 协议。
文本模式 (Text ReAct)：针对轻量级或垂直领域模型，通过正则精准捕捉文本中的 Action: {json} 标签。

闭环自愈能力 (Self-Correction)

当外部工具返回错误（如参数失效或网络抖动）时，异常信息会作为 Observation 反馈给模型。Agent 会分析报错原因，尝试修正参数并重试，显著提升自动化任务的鲁棒性。

变量域隔离设计 (Context Isolation)

基于 Solon Flow 的变量域思想，状态存储于 ReActTrace 中：

并发安全：Agent 实例本身无状态，支持高并发调用。
嵌套支持：支持 Agent 嵌套调用（Agent in Agent）而记忆互不干扰。

Solon v3.9.0