跳转到主要内容
⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考英文原版
工具节点通过预构建的集成将你的工作流连接到外部服务和API。与HTTP请求节点不同,工具提供结构化接口、内置错误处理以及为流行服务简化的配置。
Tools node interface

工具节点配置界面

工具类型

Dify支持多种类型的工具来处理不同的集成需求:
Tool categories

可用的工具类别和选项

  • 内置工具
  • 自定义工具
  • 工作流工具
  • MCP工具
由Dify维护的即用型集成,适用于包括Google Search、天气API、生产力工具和AI服务在内的流行服务。这些工具需要最少的配置,并提供可靠、经过测试的集成。

配置

身份验证

许多工具需要API密钥或OAuth身份验证。在工作流中使用这些工具之前,请在你工作空间的工具部分配置这些凭据。配置完成后,身份验证将自动处理。

输入参数

工具提供带有验证的结构化表单用于输入配置。使用来自之前工作流节点的变量设置参数。界面自动处理数据类型验证,并为每个参数提供有用的描述。

输出处理

工具返回结构化数据,这些数据作为变量可用于下游节点。输出模式是预定义的,确保兼容性并降低集成复杂性。

相比HTTP请求的优势

结构化接口提供基于表单的配置和内置验证,使设置比手动HTTP请求配置更容易。 内置错误处理包括自动重试逻辑和错误管理,降低了处理API故障的复杂性。 类型安全确保输入和输出模式在工作流节点之间保持数据兼容性。 文档为每个工具包含使用示例和详细的参数描述。

错误处理和重试

为依赖外部服务的工具配置强大的错误处理:
Tool retry settings

工具重试配置

重试设置自动重试失败的工具执行,最多10次,带有可配置的间隔(最大5000毫秒)。这可以处理临时服务问题或网络问题。
Tool error handling

工具错误处理选项

错误处理定义当工具执行失败时的替代工作流路径,确保即使外部服务不可用时你的工作流也能继续。

创建自定义工具

OpenAPI集成允许你导入任何带有OpenAPI/Swagger规范的服务。导入后,该服务将作为工具可用,具有与内置选项相同的易用性。 工作流发布将多节点工作流转换为可在工具。这促进了模块化并简化了复杂的工作流管理。

工具管理

通过你工作空间导航中的工具访问工具配置。在这里你可以管理身份验证凭据、导入自定义工具、配置MCP服务器以及将工作流发布为工具。 有关工具创建、管理和将工作流发布为工具的详细指导,请参阅工具配置指南