Dify Enterprise Docs home page
3.3.x
简体中文
搜索...
⌘K
Support
搜索...
Navigation
节点说明
工具
简介
欢迎使用 Dify Enterprise
部署手册
部署准备
资源清单
环境部署
激活许可证
验证 Dify 服务状态
高级配置
云基础设施
管理员手册
工作区管理
成员管理
插件
身份认证
企业级 APIs
审计日志
品牌设置
系统设置
常见问题
用户手册
接入大模型
构建应用
工作流
工作流
关键概念
变量
节点说明
开始
LLM
知识检索
问题分类
条件分支
代码执行
模板转换
文档提取器
列表操作
变量聚合
变量赋值
迭代
参数提取
HTTP 请求
Agent
工具
结束
直接回复
循环
快捷键
编排节点
文件上传
异常处理
附加功能
预览与调试
应用发布
结构化输出
变更公告:图片上传被替换为文件上传
知识库
工具
发布
标注
监测
管理
插件开发
欢迎开始 Dify 插件开发
概念与入门
初始化开发工具
开发实践
插件隐私政策准则
贡献与发布
开发 Slack Bot 插件
实践案例与示例
Bundle 插件包
反向调用
通用规范定义
Reference & Specifications
在此页面
添加工具节点
配置工具节点
常规工具配置
MCP 工具
高级功能
错误重试
异常处理
将工作流应用发布为工具
节点说明
工具
工具可以帮助用户可以扩展 LLM 的能力,在 Dify 平台上创建更强大的 AI 应用。分为以下四种工具类型:
插件(Plugins)
- 对开发者更加友好,可扩展性更强的第三方服务扩展模块。详细说明请参考
插件简介
。
自定义工具(Custom Tools)
- 用户可以导入自定义的 API 工具(OpenAPI 格式)。开发说明请参考
快速接入工具
。
Workflow as Tool
- 将 Dify 内构建好的工作流应用转为工具并在应用中调用。
MCP 服务器(HTTP)
- 支持 HTTP 协议的 MCP 服务器。
添加工具节点
添加节点时,选择右侧的 “工具” tab 页。
配置工具节点
配置工具节点通常包含以下步骤:
授权工具:选择需要的工具类型,完成必要的授权配置
设置输入输出参数:配置工具所需的输入数据和输出格式
工具节点可以连接其它节点,通过
变量
处理和传递数据。
常规工具配置
对于插件、自定义工具和工作流工具,配置过程相对简单。系统会提供直观的配置界面,开发者只需按照页面指引设置输入参数和输出变量即可。这些工具通常有预定义的参数结构,配置起来比较直观。
MCP 工具
MCP 工具由于支持更复杂的数据结构,在配置上有一些特殊之处。当 MCP 工具的某个功能支持复杂数据类型(如对象、数组)时,系统会提供专门的配置界面来帮助处理这些复杂结构。
数据结构配置功能:
结构查看器
:可以直观地查看参数的数据结构要求
JSON 输入框
:支持直接输入JSON格式的复杂数据
类型验证
:确保输入的数据格式符合工具要求
该功能可以与
结构化输出
配合使用。确保 LLM 能够返回格式规范、结构稳定的数据后,MCP 工具就能够基于这些数据执行精准的任务操作。
MCP 工具使用建议:
流程控制场景
:适合执行特定的、明确定义的任务。您需要准确配置输入参数,工具会按照预设逻辑执行操作。
Agent 场景
:如果你的任务比较复杂,需要 MCP 工具中的多个功能协同完成,建议在 Agent 应用类型中使用 MCP 工具。Agent 应用将自动发现和选择 MCP 工具内的合适功能,根据任务需要动态调用不同的操作。
高级功能
错误重试
针对节点发生的部分异常情况,通常情况下再次重试运行节点即可解决。开启错误重试功能后,节点将在发生错误的时候按照预设策略进行自动重试。你可以调整最大重试次数和每次重试间隔以设置重试策略。
最大重试次数为 10 次
最大重试间隔时间为 5000 ms
错误重试配置
异常处理
工具节点处理信息时有可能会遇到异常情况,导致流程中断。应用开发者可以参考以下步骤配置异常分支,在节点出现异常时启用应对方案,而避免中断整个流程。
在工具节点启用 “异常处理”
选择异常处理方案并进行配置
异常处理配置
需了解更多应对异常的处理办法,请参考
异常处理
。
将工作流应用发布为工具
Workflow 类型应用支持发布为工具,便于被其它工作流内的节点所应用。
发布应用时需填写工具的名称和详细的输入参数。建议开发者仔细填写每个配置项,确保工具能够被其他工作流或 Agent 应用正确调用。
编辑此页面
通过直接提交修改来帮助改进文档内容
提交问题
发现错误或有改进建议?请提交问题反馈
Agent
结束
助手
Responses are generated using AI and may contain mistakes.