Dify 插件开发入门：5 个步骤写出你的第一个插件

Dify 插件是什么？

Dify 插件是 Dify 平台的扩展机制，类似于 VS Code 扩展。每个插件可以为 Dify 的 Agent 和工作流增加新的工具能力。和 MCP Server 不同，Dify 插件运行在 Dify 平台内部，拥有更好的集成体验和权限管理。

步骤 1：初始化插件项目

# 安装 Dify Plugin CLI
pip install dify-plugin-cli

# 创建插件项目
dify-plugin init exchange-rate-plugin
cd exchange-rate-plugin

项目结构：

exchange-rate-plugin/
├── manifest.yaml       # 插件元数据
├── provider/           # 插件供应商定义
│   └── exchange_rate.py
├── tools/              # 工具定义
│   └── get_rate.py
└── _assets/            # 图标等资源
    └── icon.svg

步骤 2：定义工具 Schema

# tools/get_rate.yaml
identity:
  name: get_exchange_rate
  label:
    en_US: Get Exchange Rate
    zh_Hans: 获取汇率
  description:
    en_US: Get real-time exchange rate between two currencies
    zh_Hans: 获取两种货币之间的实时汇率
parameters:
  - name: from_currency
    type: string
    required: true
    label:
      en_US: From Currency
      zh_Hans: 源货币
  - name: to_currency
    type: string
    required: true
    label:
      en_US: To Currency
      zh_Hans: 目标货币

步骤 3：实现工具逻辑

# tools/get_rate.py
import httpx
from dify_plugin.entities.tool import ToolInvokeMessage
from dify_plugin import Tool

class GetExchangeRateTool(Tool):
    def _invoke(self, parameters: dict) -> ToolInvokeMessage:
        from_curr = parameters["from_currency"]
        to_curr = parameters["to_currency"]
        
        resp = httpx.get(
            f"https://api.exchangerate.host/latest",
            params={"from": from_curr, "to": to_curr}
        )
        data = resp.json()
        rate = data["rates"][to_curr]
        
        return self.create_json_message({
            "from": from_curr,
            "to": to_curr,
            "rate": rate
        })

步骤 4：本地调试

# 在 Dify 本地开发环境运行
dify-plugin run

# 在 Dify 控制台测试
# 创建 Agent → 添加工具 → 选择「获取汇率」→ 输入测试参数

步骤 5：发布到 Dify 插件市场

# 打包
dify-plugin package

# 发布（需要 Dify 开发者账号）
dify-plugin publish

注意事项

• 插件的 identity.description 是 Agent 选择工具的依据，务必清晰准确
• 参数类型支持 string、number、boolean、select（枚举）
• 敏感 API Key 应使用 Dify 的凭证管理，不要硬编码
• 错误信息要友好，Agent 会将错误信息反馈给用户