Dify平台Skill开发实战：从零构建你的第一个智能技能

1次阅读

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

Dify 是一个开放的技能开发与分发平台，允许开发者快速构建、测试和部署智能对话技能（Skill）。通过 Dify，开发者可以专注于核心逻辑的实现，而无需关心底层基础设施的搭建。Skill 生态的价值在于能够将各种服务以对话的形式提供给用户，极大地提升了交互的便捷性和体验。

注册 Dify 开发者账号：访问 Dify 官网，完成注册并登录开发者中心。
安装必要的工具：确保你的开发环境已安装 Python 3.7+ 和 pip。
安装 Dify SDK：通过 pip 安装 Dify 官方提供的 SDK：
```
pip install dify-sdk
```
配置开发环境：在 Dify 开发者中心获取 API 密钥，并配置到本地环境变量中。

Skill：一个独立的对话技能，可以处理特定的用户请求，如查询天气、播放音乐等。
Intent：用户的意图，如“查询天气”、“设置提醒”等。
Entity：意图中的关键参数，如“城市名称”、“日期”等。

在 Dify 开发者中心创建新 Skill，填写基本信息如名称、描述和图标。
设置 Skill 的调用名称，如“天气查询”。

定义意图“查询天气”，并添加示例语句：“今天北京天气怎么样？”、“上海明天会下雨吗？”。
添加实体“城市”，并关联到意图中。

使用公开天气 API（如和风天气）获取天气数据。以下是 API 请求示例：

import requests

def get_weather(city):
    url = f"https://api.heweather.com/s6/weather/now?location={city}&key=YOUR_API_KEY"
    response = requests.get(url)
    if response.status_code == 200:
        return response.json()
    else:
        return None

设计语音和文本响应模板，例如：

{
    "version": "1.0",
    "response": {
        "outputSpeech": {
            "type": "PlainText",
            "text": "当前 {city} 的天气是 {weather}，温度是{temp} 度。"
        }
    }
}

以下是一个完整的 Python 实现，包含错误处理和注释：

import requests
from dify_sdk import Skill

class WeatherSkill(Skill):
    def __init__(self):
        super().__init__()
        self.api_key = "YOUR_API_KEY"

    def handle(self, intent, entities):
        if intent == "查询天气":
            city = entities.get("城市")
            if not city:
                return self.build_response("请告诉我您想查询哪个城市的天气。")

            weather_data = self.get_weather(city)
            if not weather_data:
                return self.build_response("抱歉，暂时无法获取天气信息。")

            weather = weather_data["HeWeather6"][0]["now"]["cond_txt"]
            temp = weather_data["HeWeather6"][0]["now"]["tmp"]
            return self.build_response(f"当前 {city} 的天气是 {weather}，温度是{temp} 度。")

        return self.build_response("我不明白您的意思。")

    def get_weather(self, city):
        url = f"https://api.heweather.com/s6/weather/now?location={city}&key={self.api_key}"
        try:
            response = requests.get(url)
            response.raise_for_status()
            return response.json()
        except requests.exceptions.RequestException as e:
            print(f"Error fetching weather data: {e}")
            return None

    def build_response(self, text):
        return {
            "version": "1.0",
            "response": {
                "outputSpeech": {
                    "type": "PlainText",
                    "text": text
                }
            }
        }

if __name__ == "__main__":
    skill = WeatherSkill()
    skill.run()

Dify 提供了在线测试工具，可以在开发者中心模拟用户对话，实时查看技能响应。建议：