本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版。
为你的应用添加工具,让 LLM 能够调用外部服务和 API 来获取实时数据或执行操作,如网页搜索、数据库查询或内容处理。
工具的使用场景:
- Workflow / Chatflow 应用,作为独立的 工具节点,或在 Agent 节点 中使用
- Agent 应用
- 旧版 Agent 应用
可在 集成 > 工具 中管理所有工具。
工具类型#
由 Dify 和社区提供的即用型工具,涵盖常用功能和热门服务。内置工具(如 Current Time)开箱即用,你也可从 市场 安装更多。
部分工具插件(如 Google 和 GitHub)使用前需要鉴权。可在 集成 > 工具 > 工具插件 中设置工作空间级凭据,或在应用或节点内的工具设置中配置。
通过导入标准的 OpenAPI(Swagger)规范,将尚未以工具插件形式提供的服务集成进来。
粘贴规范、从 URL 导入,或从提供的示例开始,Dify 会自动生成工具接口。
将任意以用户输入节点开始的工作流转化为工具,从而在多个应用间共享多步逻辑。Chatflow 无法用作工具。
创建工具时会先发布工作流,工具即以当前的工作流为准。

连接 MCP 服务器,将其工具导入 Dify。MCP 服务器封装数据库、文件系统或 API 等外部资源,并通过标准接口对外提供,让你的应用能像调用其他工具一样调用它们。
如需将你自己的 Dify 应用发布为 MCP 服务器,参见 发布为 MCP 服务器。
连接 MCP 服务器#
仅支持采用 HTTP 传输 的 MCP 服务器。
提供 URL、名称和唯一的服务器标识符即可添加服务器。Dify 会进行连接、按需授权,并导入服务器的工具,供你的应用调用。
之后可更新工具列表以拉取服务器的最新工具,但若其中某个工具被移除或更改,可能导致使用它的应用出错。
- 应用通过标识符引用服务器。若之后更改标识符,使用旧标识符的应用将无法使用该服务器的工具;在每个受影响的应用中重新添加这些工具即可恢复。
- 导出的应用同样通过标识符引用服务器,因此要在另一个工作空间中运行,需以相同的标识符重新创建相同的服务器。
鉴权#
动态客户端注册(默认开启)让 Dify 自动从服务器获取 OAuth 凭据,无需你自行注册应用。只要服务器支持,就保持开启。
当服务器不支持自动注册,或你必须使用团队已有的 OAuth 应用时,将其关闭,填入该应用的 Client ID 和 Client Secret,再注册 Dify 显示的重定向 URL。
高级选项#
自定义请求头#
在每次请求中向服务器发送额外的 HTTP 请求头。常见用途是为使用静态令牌或 API 密钥(而非 OAuth)鉴权的服务器提供凭据(如 Authorization: Bearer <token>),也适用于服务器需要自定义请求头的其他场景。
请求头的值也可以是动态的:{{request.headers.X-Custom-Auth}} 会在调用时替换为触发本次运行的 HTTP 请求(例如一次 Service API 调用)所携带的 X-Custom-Auth 请求头,从而将每个调用方的凭据透传给服务器。
若请求未携带该请求头,则解析为空值;若本次运行没有对应的源 HTTP 请求,则原样发送占位符文本。
超时#
控制 Dify 等待服务器的时长。服务器响应缓慢时调高请求超时时间,流式结果耗时较长时调高 SSE 读取超时时间。仅在出现超时错误时才需调整。