Appearance
在智能体和工作流中使用插件
插件发布后，调用方选择的是插件中的具体工具。添加成功不代表调用一定成功，还要完成参数映射、授权和真实运行验证。
使用前提
- 插件已经发布，目标工具已启用。
- 工具已经完成真实试运行，服务状态和调试状态正常。
- 当前工作空间有权访问插件。
- 需要用户授权的插件已经由当前用户完成授权。
- 端插件所在设备在线，MCP 和 HTTP 服务可访问。
在低代码智能体中使用
- 打开智能体编排页的插件或工具管理入口。
- 从已发布插件中选择所需工具并添加。
- 只添加当前智能体真正需要的工具，避免工具过多影响模型选择。
- 在工具说明中确认动作、对象和返回结果符合当前任务。
- 使用预览或调试对话验证模型是否在正确时机选择工具、是否传入正确参数。
对于发送消息、删除数据、下单等有副作用的工具，应在智能体指令和业务层同时增加确认和权限控制，不能只依赖模型自行判断。
在工作流中使用
- 在节点面板添加“插件”节点，或通过资源选择器添加插件工具。
- 选择插件和具体工具。
- 将上游变量映射到工具输入参数。
- 把工具输出字段连接到下游节点。
- 配置异常处理，再执行节点试运行和完整工作流试运行。
工作流保存的是工具契约引用。工具字段被删除、改名或改类型后，已有变量映射可能失效；插件升级后应重新打开节点检查参数。
结果消费
- 结构化结果优先通过输出参数传递，不从自然语言文本中二次解析。
- 需要可视化展示时，可以在工具详情绑定已发布卡片。
- 空结果和错误结果要有明确分支，不要让下游节点把空值当作成功。
- 长任务返回任务 ID 时，应使用查询工具或异步流程获取最终状态。
常见问题
列表里找不到插件
检查工作空间、发布状态、权限和筛选条件。企业插件或插件市场中的资源需要先安装或复制到当前工作空间。
已添加但模型不调用
检查工具名称和说明是否明确、参数是否过多、智能体指令是否冲突，并通过调试记录确认模型决策。不要通过强制固定返回值掩盖选工具问题。
工作流变量无法选择
确认插件已发布最新输出参数，并刷新插件节点参数。若字段发生破坏性变更，应恢复兼容字段或迁移节点映射。