RaydoRaydo Book

Capability 节点

讲清 capability route 该怎么选、怎么配、怎么拆。

Capability 节点是真正“做事”的节点。

如果说 Goal / brief 是在交代任务,Data operation 是在整理数据,那 Capability 节点就是 workflow 里真正调用能力、产出结果、或者对外发生动作的地方。

它适合做什么

  • 调用图片、视频、音频、文档、研究、分析等能力;
  • 调用 browser、computer、connection 等真实动作;
  • 读取、写入、生成、转换某个具体结果。

继续往下的具体节点页

为了让这部分更像手册而不是概览,我把高频节点再往下拆成了细页:

什么时候该用它

当你需要一个节点真实地产出结果,或对外部系统发生动作时,就应该优先考虑 capability。

怎么选更稳

  • 需要媒体生成,就选对应 media capability;
  • 需要网页动作,就走 browser 路径,不要用普通说明代替;
  • 需要外部读取或写入,就走 connection / table / doc 这类明确 route;
  • 需要研究、分析、交付,尽量用已经有明确输出边界的能力。

什么情况下该拆成多个 capability

  • 你在一个节点里同时读取、整理、写回;
  • 同一个节点既做生成又做人类复核准备;
  • 失败后你看不出到底是哪一步错了。

常见错误

  • 能力选对了,但输入过宽,导致结果不稳定;
  • 把 flow control 硬塞进 capability;
  • 把 data transform 写进 capability 提示里,后续没人能排错;
  • 外部写入能力前没有 review / approval。

建议用户怎么排查

  • 先确认 capability 本身选对了;
  • 再看输入字段是否过多或过少;
  • 再看它前面是不是少了 data operation;
  • 如果涉及外部动作,确认是否缺审批。