更新时间:2026-02-06 GMT+08:00
分享

在工作流中使用插件

相比于单智能体使用插件的“概率性调用”(由大模型决定是否用),工作流使用插件是“确定性调用”(流程走到这一步必须执行)。因此,设置的重心必须从“提示词设置”转移到“参数映射”和“数据流转”上。

适用场景:

  • 固定业务逻辑:必须先查询订单状态,再根据状态回复用户。
  • 精确数据处理:需要调用计算器、汇率转换、数据库查询等不容许出错的操作。
  • 连接外部系统:对接企业 ERP、CRM 系统获取实时信息。

前提条件

数据流转与约束

在配置插件节点前,必须理解数据是如何在节点间流转的。

配置插件的输入数据

需要在页面中通过设置“引用”选择上游节点,同时被引用的上游节点在参数类型、参数体结构上需要与插件本身的入参保持一致。

图1 设置参数引用示例

下游节点使用插件数据

插件节点执行后,通常会输出一个 JSON 对象。

  • 场景1:大模型节点引用插件数据

    将插件查到的客观信息(如天气温度、订单状态)“喂”给大模型,让模型根据这些信息组织语言回复用户。

    例如在大模型节点的提示词(Prompt)中,使用变量语法(如 {{output}})插入插件的输出结果。

    图2 大模型节点引用插件示例
  • 场景2:逻辑类节点基于数据做判断

    根据插件返回的状态(成功/失败、有货/无货、包含特定值……),决定工作流走哪一条路径。

    例如在逻辑类节点的条件设置中,选择插件输出的特定字段(如 status),并设置判断规则(例如:当 status 等于 Success 时,走分支 A)。

操作步骤

  1. 登录AgentArts智能体平台。
  2. 选择左侧导航栏“开发中心 > 智能体管理 ”,单击右上角“创建单智能体”,并选择“单智能体”或者“任务型工作流”。这两类工作流中均具备插件节点。

    图3 创建应用
    图4 选择工作流应用

  3. 填写工作流名称、描述。单击右下角“立即创建”进入到工作流配置页面。
  4. 在配置页面可以添加插件至工作流中,并配置插件的输入数据。

    插件选定后,面板会显示该插件对应的输入参数以及输出参数等信息。可以“引用”上游节点作为插件的输入数据来源。注意插件的参数类型需要与上游节点的参数类型保持一致。

    如果插件中有不需要变化的固定值参数,直接在输入框中手动填入固定的文本内容即可。

    如果插件需要进行鉴权后才可以使用,请按照页面提示配置插件鉴权。

    图5 插件引用与固定输入示例

  5. 连接插件的下游节点。

    插件执行完只是获取了数据,其后可以连接一个大模型节点来处理这些数据并生成回复。并注意在大模型节点的系统提示词中添加插件返回的查询内容。

    示例:
    你是一个天气助手。
    用户的问题是:{{query}}
    调用天气插件返回的数据是:{{output}}
    请根据上述数据,用自然语言回答用户。

相关文档