Dify的Skill开发入门指南：从零构建你的第一个AI技能

1次阅读

共计 2190 个字符，预计需要花费 6 分钟才能阅读完成。

Skill 是 Dify 平台上可复用的 AI 能力模块，相当于一个封装好的智能服务。与普通 API 调用相比，Skill 具有以下特点：

语义化交互：能理解自然语言输入而不仅是结构化参数
上下文感知：可以维护对话状态和记忆
平台集成：直接接入 Dify 的技能市场和对话系统

安装 Python 3.8+（推荐使用 pyenv 或 conda 管理版本）
注册 Dify 开发者账号并获取 API 密钥
安装必要工具包：

pip install dify-client requests python-dotenv

创建.env 文件存放凭证：

DIFY_API_KEY=your_api_key_here
WEATHER_API_KEY=your_weather_api_key

创建 weather_skill.py 文件，首先声明技能基本信息：

from dify_client.models import SkillMeta

meta = SkillMeta(
    name="weather_query",
    display_name="天气查询",
    description="根据城市名称查询实时天气情况",
    version="1.0.0",
    inputs=[{"name": "city", "type": "str", "required": True, "description": "城市名称"}
    ],
    outputs={
        "temperature": "float",
        "conditions": "str",
        "humidity": "float"
    }
)

我们使用和风天气的免费 API（需自行注册）：

import os
import requests
from dotenv import load_dotenv

load_dotenv()

WEATHER_API_URL = "https://devapi.qweather.com/v7/weather/now"

def get_weather(city: str):
    params = {
        "location": city,
        "key": os.getenv("WEATHER_API_KEY")
    }

    try:
        response = requests.get(WEATHER_API_URL, params=params)
        response.raise_for_status()
        data = response.json()

        return {"temperature": data["now"]["temp"],
            "conditions": data["now"]["text"],
            "humidity": data["now"]["humidity"]
        }
    except Exception as e:
        raise ValueError(f"天气查询失败: {str(e)}")

使用 Dify SDK 包装业务逻辑：

from dify_client import DifyClient
from typing import Dict, Any

client = DifyClient(api_key=os.getenv("DIFY_API_KEY"))

@client.skill(meta=meta)
def weather_query(inputs: Dict[str, Any]) -> Dict[str, Any]:
    """
    处理天气查询请求
    :param inputs: 包含 city 参数的字典
    :return: 标准化天气数据
    """city = inputs.get("city")
    if not city:
        raise ValueError("必须提供 city 参数")

    try:
        weather_data = get_weather(city)
        return {
            "success": True,
            "data": weather_data,
            "message": f"{city}天气查询成功"
        }
    except Exception as e:
        return {
            "success": False,
            "error": str(e)
        }

# 本地测试代码
if __name__ == "__main__":
    print(weather_query({"city": "北京"}))