7 · 工具与插件生态（Tool and Plugin Ecosystem）

应用编排与外部知识接入 · 本章是 Dify DeepWiki 中文译文的独立章节页，保留原始链接、源码锚点、模块标签和章节层级。

项目Dify 章节7 状态全文译文模块接口与服务契约、系统架构、智能体运行时、界面与交互

项目要点页2.5 参考项目项目章节目录Dify DeepWiki 原始章节Tool and Plugin Ecosystem 上一章6.3 下一章7.1

源码线索

api/controllers/console/workspace/tool_providers.py
api/core/entities/knowledge_entities.py
api/core/entities/provider_entities.py
api/core/helper/marketplace.py
api/core/mcp/client/sse_client.py
api/core/mcp/client/streamable_client.py
api/core/mcp/mcp_client.py
api/core/mcp/session/base_session.py
api/core/mcp/session/client_session.py
api/core/plugin/endpoint/exc.py

模块标签

接口与服务契约
系统架构
智能体运行时
界面与交互
配置治理

中文译文

工具与插件生态（中文译文）

原始 DeepWiki 页面：https://deepwiki.com/langgenius/dify/7-tool-and-plugin-ecosystem

翻译时间：2026-05-27T08:44:30.136Z

翻译模型：deepseek-chat

原文字符数：14705

项目：Dify (dify)

---

工具与插件生态系统

目的与范围

本文档描述了 Dify 中的工具与插件架构，涵盖外部工具如何在应用中被集成、管理和执行。工具生态系统使 Agent 聊天应用和工作流节点能够通过五种不同的提供者类型调用外部功能：内置工具、基于 API 的工具、工作流即工具、基于插件的工具以及 MCP（模型上下文协议）服务器。

详细信息请参见：

工具提供者类型与架构
内置与 API 工具集成
MCP 协议集成
插件守护进程与执行环境

---

工具提供者类型分类

Dify 支持五种不同的工具提供者类型，每种类型服务于不同的集成模式和使用场景。这些类型在 ToolProviderType 枚举中定义 api/core/tools/entities/tool_entities.py:65-76。

提供者类型概览

graph TB
    subgraph "工具提供者类型 [ToolProviderType]"
        BuiltIn["BUILT_IN<br/>硬编码 + 插件工具"]
        API["API<br/>自定义 OpenAPI/Swagger"]
        Workflow["WORKFLOW<br/>已发布的工作流应用"]
        Plugin["PLUGIN<br/>独立插件"]
        MCP["MCP<br/>模型上下文协议"]
    end

    subgraph "存储模型 [api/models/tools.py]"
        BuiltinDB["BuiltinToolProvider"]
        ApiDB["ApiToolProvider"]
        WorkflowDB["WorkflowToolProvider"]
        MCPToolDB["MCPToolProvider"]
    end

    subgraph "运行时控制器 [ToolProviderController]"
        BuiltinCtrl["BuiltinToolProviderController"]
        ApiCtrl["ApiToolProviderController"]
        WorkflowCtrl["WorkflowToolProviderController"]
        PluginCtrl["PluginToolProviderController"]
        MCPCtrl["MCPToolProviderController"]
    end

    BuiltIn --> BuiltinDB
    BuiltIn --> PluginCtrl
    API --> ApiDB
    Workflow --> WorkflowDB
    Plugin --> PluginCtrl
    MCP --> MCPToolDB

    BuiltinDB --> BuiltinCtrl
    ApiDB --> ApiCtrl
    WorkflowDB --> WorkflowCtrl
    MCPToolDB --> MCPCtrl

来源： api/core/tools/entities/tool_entities.py:65-76，api/models/tools.py:64-64，api/core/tools/tool_manager.py:22-29

提供者类型	存储模型	控制器类	使用场景
`BUILT_IN`	`BuiltinToolProvider`	`BuiltinToolProviderController`	预打包工具（Google、Wikipedia）
`API`	`ApiToolProvider`	`ApiToolProviderController`	自定义 OpenAPI/Swagger 工具定义
`WORKFLOW`	`WorkflowToolProvider`	`WorkflowToolProviderController`	作为工具暴露的已发布工作流应用
`PLUGIN`	无（仅运行时）	`PluginToolProviderController`	插件提供的工具实现
`MCP`	`MCPToolProvider`	`MCPToolProviderController`	模型上下文协议服务器

来源： api/core/tools/entities/tool_entities.py:65-76，api/core/tools/tool_manager.py:42-47

---

ToolManager：中央协调单例

ToolManager 类 api/core/tools/tool_manager.py:98 作为所有工具操作的协调单例，负责管理提供者发现、凭证解析和工具运行时实例化。

ToolManager 架构

graph TB
    subgraph "ToolManager 单例 [api/core/tools/tool_manager.py]"
        Manager["ToolManager<br/>_hardcoded_providers: dict<br/>_builtin_provider_lock: Lock"]
        GetBuiltin["get_builtin_provider()"]
        GetPlugin["get_plugin_provider()"]
        GetRuntime["get_tool_runtime()"]
    end

    subgraph "提供者缓存"
        HardcodedCache["_hardcoded_providers<br/>dict[str, BuiltinToolProviderController]"]
        PluginCache["contexts.plugin_tool_providers<br/>dict[str, PluginToolProviderController]"]
    end

    subgraph "数据库模型 [api/models/tools.py]"
        BuiltinDB[(BuiltinToolProvider)]
        ApiDB[(ApiToolProvider)]
        WorkflowDB[(WorkflowToolProvider)]
    end

    GetBuiltin --> HardcodedCache
    GetBuiltin --> PluginCache
    GetPlugin --> PluginCache

    GetRuntime --> GetBuiltin
    GetRuntime --> BuiltinDB
    GetRuntime --> ApiDB
    GetRuntime --> WorkflowDB

来源： api/core/tools/tool_manager.py:98-192

工具运行时检索流程

get_tool_runtime() 方法 api/core/tools/tool_manager.py:182 协调凭证查找、解密和工具实例化。它会返回专门的工具实例，例如 BuiltinTool、PluginTool、ApiTool、WorkflowTool 或 MCPTool api/core/tools/tool_manager.py:192。

关于架构和单例模式的详细信息，请参见工具提供者类型与架构。

---

内置与 API 工具集成

内置工具是通过 BuiltinToolManageService api/services/tools/builtin_tools_manage_service.py:40 存储和管理的预打包实现。API 工具允许用户通过提供 OpenAPI/Swagger 规范来定义自定义工具，由 ApiToolManageService api/services/tools/api_tools_manage_service.py:39 管理。

ToolTransformService api/services/tools/tools_transform_service.py:37 负责管理数据库模型与前端使用的 API 实体之间的转换。这些工具的凭证以加密格式存储，ToolManager 在运行时创建期间处理解密 api/core/tools/tool_manager.py:220-230。API 工具使用 ApiBasedToolSchemaParser 将原始规范转换为 ApiToolBundle 实体 api/services/tools/api_tools_manage_service.py:48-50。

关于凭证管理和模式解析的详细信息，请参见内置与 API 工具集成。

---

MCP 协议集成

Dify 集成了 模型上下文协议（MCP），使其能够连接到远程 MCP 服务器。MCPToolManageService api/services/tools/mcp_tools_manage_service.py:78 管理这些连接的生命周期和提供者持久化。

MCP 连接架构

MCPClient api/controllers/console/workspace/tool_providers.py:26 处理底层传输，支持 SSE（服务器发送事件）和可流式 HTTP 连接。

graph TB
    subgraph "MCP 集成 [api/core/mcp/]"
        Client["MCPClient"]
        AuthRetry["MCPClientWithAuthRetry"]
    end

    subgraph "传输层 [api/core/mcp/client/]"
        SSE["SSEClient"]
        Stream["StreamableClient"]
    end

    subgraph "数据库 [api/models/tools.py]"
        MCPDB["MCPToolProvider"]
    end

    AuthRetry --> Client
    Client --> SSE
    Client --> Stream
    MCPDB --> AuthRetry

来源： api/services/tools/mcp_tools_manage_service.py:19-22，api/controllers/console/workspace/tool_providers.py:23-26

关于传输层和服务器通信的详细信息，请参见 MCP 协议集成。

---

插件守护进程与执行环境

Dify 中的插件在由 插件守护进程 管理的安全环境中执行。PluginToolManager api/core/plugin/impl/tool.py:21 和 PluginToolProviderController api/core/tools/plugin_tool/provider.py:26 通过 BasePluginClient api/core/plugin/impl/base.py:62 与此守护进程交互，以获取工具声明并执行逻辑。

插件发现

当调用 ToolManager.get_plugin_provider() 时，它会利用 PluginToolManager 从插件守护进程获取工具提供者声明 api/core/tools/tool_manager.py:166-170。这确保了插件工具会根据租户已安装的插件动态加载。通信使用专用的 API 密钥，并通过 W3C traceparent 请求头处理分布式追踪 api/core/plugin/impl/base.py:108-112。

关于安全隔离和市场集成的详细信息，请参见插件守护进程与执行环境。

---

工具执行引擎

ToolEngine api/core/tools/tool_engine.py:42 负责工具的实际调用。它为不同的上下文提供了专门的方法：

agent_invoke()：由 Agent 应用使用，用于在聊天上下文中处理工具调用，并与 DifyAgentCallbackHandler 集成 api/core/tools/tool_engine.py:48-55。
generic_invoke()：一种更通用的调用方法，由工作流节点使用，通过 workflow_call_depth 支持嵌套工作流调用 api/core/tools/tool_engine.py:158-163。

该引擎处理参数校验、命中回调（例如 on_tool_start、on_tool_end），并通过 _create_message_files() api/core/tools/tool_engine.py:109 管理二进制文件输出。工作流特定的工具由 WorkflowTool 处理，它使用 WorkflowAppGenerator 执行底层图 api/core/tools/workflow_as_tool/tool.py:89-91。

来源： api/core/tools/tool_engine.py:42-167，api/core/tools/workflow_as_tool/tool.py:35-119