更新时间:2025-09-15 GMT+08:00
分享

插件

插件节点是工作流中实现第三方能力调用的核心组件。

前提条件

已完成工作流搭建,如果未搭建工作流,请参考搭建工作流

节点说明

作为功能扩展的重要载体,该节点允许通过调用插件来执行特定功能任务。每个插件实质上是经过标准化封装的API工具集合,提供即插即用的模块化服务,拓宽工作流的能力边界,完成更复杂的任务。

插件类型包括预置插件和个人插件。

  • 预置插件:平台预置了代码解释器插件,能够执行输入的代码,得到运行结果。支持开发者直接将插件添加到工作流或应用中,丰富其能力。
  • 个人插件:平台允许开发者创建自定义插件,支持将API通过配置方式快速创建为插件,提供给工作流或应用调用。

配置插件节点

  1. 登录Versatile智能体平台,在左侧导航栏“个人空间”区域,选择进入所需空间。

    如果已选择团队空间,界面显示为实际的团队空间名称,而非“个人空间”。

    图1 选择团队空间

  2. 在左侧导航栏选择“开发中心 > 应用管理 > 工作流应用”,单击您创建的工作流。
  3. 单击“添加节点”并选择“插件”节点。
  4. 通过单击该节点打开节点配置页面。
  5. 在“个人插件”或“预置插件”页签单击“”,将插件添加至画布中。

    • 预置插件为平台内置的插件。
    • 个人插件为用户自定义的插件,创建插件步骤详见创建插件

  6. 连接插件节点和其他节点。
  7. 单击画布中已添加的“插件”节点,参照表1,完成插件节点的配置。

    • 单击图标,可修改插件节点名称,修改完成后单击名称旁边的进行保存。
    • 单击图标,可查看插件详情,重命名插件节点名称,复制一个插件节点或删除插件节点。
    • 单击图标,可对插件节点进行测试。
    表1 插件节点配置说明

    配置类型

    参数名称

    参数说明

    配置示例

    参数配置

    输入参数

    • 参数名称:从插件元信息中导入,用户无需手动添加。
    • 类型、值:支持“引用”和“输入”两种类型。
      • 引用:支持用户选择工作流中已包含的前置节点的输出变量值和全局配置中的记忆变量,适用于需要从前置节点输出中获取插件入参的场景。
      • 输入:支持用户自定义取值,适用于插件入参取值固定的场景。

    插件的输入参数需要从前置节点中获取时,配置“引用”。

    插件的输入参数固定时,如翻译插件要将内容翻译成英文,插件入参to表示翻译后内容的语种,此时应该配置“输入”并赋值“en”。

    输出参数

    输出参数所有信息从插件元信息中自动导入,用户无需手动修改。

    -

    异常配置

    -

    “异常配置”开关为“异常忽略”。作为插件节点的兜底配置,当插件执行异常时,支持配置兜底返回,避免整个工作流运行失败:

    • 关闭时,该功能不起作用。
    • 开启时,填写“默认输出”,默认输出的参数需要与插件“输出参数”一致。当工作流插件节点运行正常时,该配置对后续节点没有影响。当工作流运行到插件节点出现异常时,工作流不会中止,继续运行后续节点。如果后续节点引用了插件节点的输出内容,则使用“默认输出”的内容。

    用户期望插件执行异常不会导致整个工作流中断时,开启“异常配置”,参考插件的输出参数配置“默认输出”。

    图2 插件节点配置示例

  8. 节点配置完成后,单击“确定”。

相关文档