插件节点用于在工作流中调用插件运行指定工具。
插件是一系列工具的集合,每个工具都是一个可调用的API。插件广场上架的插件或已上架的团队插件支持以节点形式被集成到工作流中,拓展Agent的能力边界。
在工作流画布下方单击添加节点,在弹出的节点面板中单击插件节点,并选择希望调用的插件。

配置插件节点
插件节点的输入和输出结构取决于工具定义的输入输出结构,不支持自定义设置。在插件节点中开发者需要为必选的输入参数指定数据来源,支持设置为固定值或引用上游节点的输出参数。插件节点运行时,会调用工具处理输入参数,并以工具定义的输出结构输出处理后的数据。
在端插件节点的详情界面,点击设置,可以配置执行方式。


【执行方式】:可设置立即执行和打断播报两种类型。
当选择端插件时,选中两个及以上的版本时,界面就会呈现每个版本的输入和输出信息,开发者可以使用引用前置节点的参数作为输入,端插件的输出则需要配合代码组件一同使用。使用示例
当选择端插件时,会出现系统输出code和appName。
系统输出变量 | 说明 |
|---|---|
code | 用于判断端插件是否命中,当code为200时,代表插件命中,当code为204时,代表插件没有命中,开发者可以配合选择器组件对code的返回做判断,针对插件是否命中,做后续逻辑的处理。 |
appName | 代表插件命中时,返回的应用名称。(由于平台侧在调试时未安装应用,所以在调试过程中,如果使用真实数据调试,code为204,如果使用模拟集数据调试,code则为200)。 |
平台侧调试详情如下:

当使用选择器组件对code进行判断命中场景下,可以连接代码组件对于插件返回的结果进行聚合,使用代码组件对不同版本工具的命中情况做判断,输出想要的结果,用于后续节点的使用。

在使用代码组件对端插件结果聚合时,可以参考下图示例:

上图展示了引用关系链。

上图为插件组件的示例图
插件组件在选择多版本的情况下,会输出两组不同的值。开发者可以根据自己的需求,使用代码组件对插件结果进行聚合。

上图为代码组件的示例图:代码组件引用前置节点两个版本插件返回结果为input1和input2,在代码组件中对结果进行判断,输出正常返回的结果。
当使用代码组件引用端插件结果进行汇总时,由于在平台侧无法调试获取到端插件的执行结果,在试运行时会有提示信息:当前工作流中存在端插件,无法完成在线测试,请在真机测试中完成端到端验证。

开发者针对这种情况,可以使用选择器组件针对code为204时,端插件不命中的情况,绕过代码组件的引用端插件的分路,让工作流能够试运行成功得以上架,而命中的分路可以在端侧进行验证。
在工作流中调用插件节点时,支持使用Mock数据进行调试,无需依赖真实接口,提升开发效率。
如下图所示,在插件配置框中点击下拉按钮,选择使用模拟集数据,工作流运行时,插件节点将响应配置的模拟数据。创建模拟集可参考 云插件模拟集、端插件模拟集。

插件组件支持单节点调试(端插件不支持单节点调试),单节点调试时不要求连线完整,调试输入参数支持直接输入或引用,调试完成后展示此次调试的试运行结果。
如下图所示,点击调试按钮即可拉起执行:

执行结束后,正常返回此次调试的结果。
