
# 在工作流中使用插件
相比于单智能体使用插件的"概率性调用"（由大模型决定是否用），工作流使用插件是"确定性调用"（流程走到这一步必须执行）。因此，设置的重心必须从"提示词设置"转移到"参数映射"和"数据流转"上。
**适用场景：**
- 固定业务逻辑：必须先查询订单状态，再根据状态回复用户。
- 精确数据处理：需要调用计算器、汇率转换、数据库查询等不容许出错的操作。
- 连接外部系统：对接企业ERP、CRM系统获取实时信息。
#### 前提条件
- 如果需要添加个人插件，请确保已[创建插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0125.html)和[调试发布插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0129.html)。
- 如果需要添加官方预置插件，请确保已完成插件鉴权。您可以在"资产广场"了解平台预置的官方插件。
 
#### 数据流转与约束
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389559.png "点击放大")
在配置插件节点前，必须理解数据是如何在节点间流转的。
**配置插件的输入数据**
需要在页面中通过设置"引用"选择上游节点，同时被引用的上游节点在参数类型、参数结构上需与插件本身的入参保持一致。
图1设置参数引用示例   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389571.png "点击放大")
**下游节点使用插件数据**
插件节点执行后，通常会输出一个JSON对象。
- 场景1：大模型节点引用插件数据 将插件查到的客观信息（如天气温度、订单状态）传递给大模型，让模型根据这些信息组织语言回复用户。
  例如在大模型节点的提示词（Prompt）中，使用变量语法（如 {{output}}）插入插件的输出结果。
  图2大模型节点引用插件示例   
  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949804.png) 
- 场景2：逻辑类节点基于数据做判断 根据插件返回的状态（成功/失败、有货/无货、包含特定值......），决定工作流走哪一条路径。
  例如在逻辑类节点的条件设置中，选择插件输出的特定字段（如status），并设置判断规则（例如：当status等于Success时，走分支A）。
  
 
#### 操作步骤
1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。
2. 选择左侧导航栏"开发中心 \> 智能体管理 "，选择"工作流"页签，并单击右上角的"创建工作流"。 
   图3创建应用   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949810.png "点击放大")
   
   
3. 选择"对话型工作流"或者"任务型工作流"。这两类工作流中均具备插件节点。 
   - 对话型工作流：面向多轮交互的开放式问答场景，基于用户对话内容提取关键信息，输出最终结果。适用于客服助手、工单助手、娱乐互动等场景。
   
   - 任务型工作流：面向自动化处理场景，基于输入内容直接输出结果，无中间的对话交互过程。适用于内容生成、批量翻译、数据分析等场景。
     图4选择工作流应用   
     ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389567.png "点击放大") 
   
   
   
   
4. 填写工作流名称、描述。单击右下角"立即创建"进入到工作流配置页面。
5. 在配置页面可以添加插件至工作流中，并配置插件的输入数据。 
   插件选定后，面板会显示该插件对应的输入参数以及输出参数等信息。可以"引用"上游节点作为插件的输入数据来源。**注意插件的参数类型需要与上游节点的参数类型保持一致。**（如果插件执行报错，请检查插件本身是否可用；上游节点是否确实输出了插件所需的变量；上游输出变量的数据类型（如String、Int、Object）是否与插件定义的输入参数类型完全一致）
   如果插件中有不需要变化的固定值参数，直接在输入框中手动填入固定的文本内容即可。
   如果插件需要进行鉴权后才可以使用，请按照页面提示配置插件鉴权。
   图5插件引用与固定输入示例   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549443.png "点击放大")
   
   
6. 连接插件的下游节点。 
   插件执行完只是获取了数据，其后可以连接一个大模型节点来处理这些数据并生成回复。并注意在大模型节点的系统提示词中添加插件返回的查询内容。
   ```
   示例：
   你是一个天气助手。
   用户的问题是：{{query}}
   调用天气插件返回的数据是：{{output}}
   请根据上述数据，用自然语言回答用户。
   ```
   
   
 
