适用版本：ChengOS v0.1.0+ ｜ 最后核对：2026-08-13 ｜ 来源：
crates/cheng-nodes/src/nodes/builtin/agent
这里只有一个节点会出现在画布上：agent/react_agent。另外三个是它循环内部的阶段 —— 规划、执行、评审 —— 并且刻意对节点面板隐藏。之所以仍然收录，是因为它们的输入输出最能说清一次迭代究竟做了什么， 它们的字段也解释了智能体自身的旋钮：迭代预算、任务运行模式，以及判断长任务是否仍在推进的安全策略。
ReAct 智能体 — agent/react_agent
自主规划,执行和评估任务的智能体
输入
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
context |
object （端口） | — | null |
现有 Agent 上下文(可选,用于继续历史对话). 连接端口，不是表单字段。 控件：text |
task |
string | — | null |
要完成的任务描述(可选,为空时自动从上下文对话历史中提取). 控件：textarea |
llm_config |
object （端口） | ✅ | — | LLM 配置(JSON 字符串或对象). 连接端口，不是表单字段。 控件：text |
max_iterations |
integer | — | 40 |
每条用户消息最多允许的 Plan/Execute/Review 迭代次数. 控件：number |
max_tool_calls_per_turn |
integer | — | — | 每条用户消息最多允许的工具调用次数;留空表示不单独限制. 控件：number |
execution_mode |
enum | — | light |
旧版循环执行模式，建议使用任务模式替代. 控件：select. 取值：light (Backward-compatible fixed iteration behavior.), adaptive (Future policy-renewed mode for medium/uncertain tasks.), heavy (Future long-task mode with stricter ledger and review safety rails.) |
task_run_mode |
enum | — | null |
短任务在预算耗尽时暂停确认;长任务在持续取得进展时继续运行. 控件：select. 取值：short (短任务), long (长任务) |
short_task_budget_chunk |
integer | — | 40 |
兼容旧工作流的短任务预算块;新配置请使用每轮迭代预算. 控件：number |
long_task_safety_policy |
object | — | — | 高级长任务安全限制 |
tools |
array<any> | — | [] |
可用工具(通过 tools 端口连接工具节点自动填充) |
use_function_calling |
boolean | — | true |
使用原生函数调用模式. 控件：switch |
use_llm_evaluation |
boolean | — | false |
启用 LLM 评估. 控件：switch |
max_checkpoints |
integer | — | 3 |
最大检查点次数(LLM 可在迭代耗尽时请求扩展). 控件：number |
instruction_prompt |
string | — | null |
自定义指令提示(覆盖默认系统提示). 控件：textarea |
user_message |
string | — | null |
用户附加指令（前置到任务前，例如：开始前先阅读 SKILLS_INDEX.md）. 控件：textarea |
reviewer_prompt |
string | — | null |
审查标准/提示词(启用 LLM 评估时使用). 控件：textarea |
reviewer_llm_config |
object （端口） | — | null |
审查用 LLM 配置(可选,默认回退到主 LLM 配置). 连接端口，不是表单字段。 控件：text |
max_review_rounds |
integer | — | 1 |
最大 LLM 审查轮数. 控件：number |
min_tool_calls_for_skill |
integer | — | 3 |
触发技能摘要所需的最少成功工具调用次数(0 表示禁用). 控件：number |
transparent_agent_streaming |
boolean | — | true |
实时流式输出智能体规划过程（文本、推理、工具调用进度）. 控件：switch |
reminder_policy |
object | — | — | 高级:待办事项的提示/拦截提醒策略 |
输出
| 字段 | 类型 | 说明 |
|---|---|---|
final_answer |
string （端口） | 最终答案. 连接端口，不是表单字段。 |
context |
object （端口） | Agent 上下文(包含对话历史). 连接端口，不是表单字段。 |
session_id |
string （端口） | 会话 ID(与 context.session_id 一致,方便下游节点直接连线). 连接端口，不是表单字段。 |
trace |
string （端口） | 执行轨迹. 连接端口，不是表单字段。 |
total_tokens |
integer | 累计词元消耗. |
iterations_used |
integer | 已用迭代次数. |
success |
boolean | 任务是否成功完成. |
status |
string | 状态消息. |
requires_review |
boolean | 是否需要人工审核. |
pause_reason |
string | 暂停原因 |
suggested_next_action |
string | 暂停时建议的下一步操作 |
interim_report |
string | 暂停时的中间报告 |
continuation_policy |
object | 紧凑的续行策略状态 |
skill_summary |
object | 用于技能沉淀的轻量 Agent 上下文(按条件输出,不需要时为空). |
artifacts |
array<object> （端口） | 本次运行中工具产生的产物引用. 连接端口，不是表单字段。 |
ReAct 规划 — agent/react_plan
分析任务状态并决定下一步操作
输入
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
task |
string | ✅ | — | 要完成的任务描述. 控件：textarea |
llm_config |
object （端口） | ✅ | — | LLM 配置(JSON 字符串或对象). 连接端口，不是表单字段。 |
max_iterations |
integer | — | 10 |
最大迭代次数. 控件：number |
tools |
array<any> | — | [] |
可用工具(通过 tools 端口连接工具节点自动填充). 控件：multi-select |
use_function_calling |
boolean | — | true |
使用原生函数调用模式. 控件：switch |
输出
| 字段 | 类型 | 说明 |
|---|---|---|
decision |
enum | Agent 的行动决策 |
context |
object | 更新后的执行上下文 |
tokens_used |
integer | 本次规划消耗的 Token |
ReAct 执行 — agent/react_execute
执行工具调用,获取观察结果
输入
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
decision |
enum | ✅ | — | 来自 Plan 节点的行动决策 |
context |
object | — | {"checkpoint_count":0,"execution_mode":"light... |
当前执行上下文 |
输出
| 字段 | 类型 | 说明 |
|---|---|---|
result |
object | 工具执行结果 |
context |
object | 更新后的执行上下文 |
is_final |
boolean | 是否为最终决策 |
observation |
string | 观察结果(用于反馈给 Plan 节点) |
decision |
enum | 原始决策(透传给 Review 节点) |
ReAct 审查 — agent/react_review
评估执行结果,决定是否继续迭代
输入
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
task |
string | ✅ | — | 原始任务描述. 控件：textarea |
result |
object | ✅ | — | 工具执行结果 |
decision |
enum | ✅ | — | 原始行动决策 |
context |
object | ✅ | — | 当前执行上下文 |
输出
| 字段 | 类型 | 说明 |
|---|---|---|
review |
enum | 评审决策 |
context |
object | 更新后的执行上下文 |
should_continue |
boolean | 是否继续迭代 |
observation |
string | 下一次迭代的观察结果 |
final_answer |
string | 最终答案(如果已完成) |
tokens_used |
integer | 评估消耗的 Token |
下一步
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
暂无评论内容