History

crazywoola ce2dd22bd7 fix: typo `doc_metadat` (#14569 )		2025-02-28 22:51:38 +08:00
..
__base	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
builtin_tool	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
custom_tool	Fixed: The use of default parameters in API interfaces (#14138 )	2025-02-25 09:43:36 +08:00
docs	docs: Add Japanese documentation for tools (#8469 )	2024-09-22 09:04:00 +08:00
entities	fix: workflow tool file error (#14483 )	2025-02-27 20:45:39 +08:00
plugin_tool	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
utils	fix: typo `doc_metadat` (#14569 )	2025-02-28 22:51:38 +08:00
workflow_as_tool	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
__init__.py	improve: generalize tool parameter converter (#4786 )	2024-06-03 21:26:58 +08:00
errors.py	fix: enhance ToolEngineInvokeError to include meta information (#12238 )	2024-12-31 14:01:24 +08:00
README_CN.md	docs: Add Japanese documentation for tools (#8469 )	2024-09-22 09:04:00 +08:00
README_JA.md	fix: rename README filename: Japanese language code is 'JA' (#11651 )	2024-12-15 17:13:34 +08:00
README.md	docs: Add Japanese documentation for tools (#8469 )	2024-09-22 09:04:00 +08:00
tool_engine.py	refactor(tool-engine): Optimize tool engine response handling (#14216 )	2025-02-25 09:58:43 +08:00
tool_file_manager.py	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
tool_label_manager.py	Introduce Plugins (#13836 )	2025-02-17 17:05:13 +08:00
tool_manager.py	fix: ensure correct provider ID comparison in tool provider query (#14527 )	2025-02-28 15:05:16 +08:00

README.md

Tools

This module implements built-in tools used in Agent Assistants and Workflows within Dify. You could define and display your own tools in this module, without modifying the frontend logic. This decoupling allows for easier horizontal scaling of Dify's capabilities.

Feature Introduction

The tools provided for Agents and Workflows are currently divided into two categories:

Built-in Tools are internally implemented within our product and are hardcoded for use in Agents and Workflows.
Api-Based Tools leverage third-party APIs for implementation. You don't need to code to integrate these -- simply provide interface definitions in formats like OpenAPI , Swagger, or the OpenAI-plugin on the front-end.

Built-in Tool Providers

API Tool Providers

Tool Integration

To enable developers to build flexible and powerful tools, we provide two guides:

Quick Integration 👈🏻

Quick integration aims at quickly getting you up to speed with tool integration by walking over an example Google Search tool.

Advanced Integration 👈🏻

Advanced integration will offer a deeper dive into the module interfaces, and explain how to implement more complex capabilities, such as generating images, combining multiple tools, and managing the flow of parameters, images, and files between different tools.