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

2次阅读

没有评论

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

AI Skill 可以理解为让 AI 系统具备完成特定任务的能力模块。比如天气查询、日程提醒、智能家居控制等，每个独立功能都可以视为一个 Skill。它们通常由三个核心部分组成：

意图识别：理解用户想干什么（比如 ” 查天气 ”）
实体抽取：获取关键参数（如 ” 北京 ”、” 明天 ”）
动作执行：调用 API 或逻辑处理并返回结果

典型应用场景包括智能音箱技能、聊天机器人插件、自动化工作流等。技术栈通常选择 Python+Web 框架（Flask/Django），搭配 NLP 服务（如 Rasa、Dialogflow）。

推荐使用这个轻量级工具链：

Python 3.8+（建议用 pyenv 管理版本）
Flask 框架（比 Django 更轻量适合初学者）
Postman（API 调试）
ngrok（内网穿透测试）

环境配置步骤：

# 创建虚拟环境
python -m venv aiskenv
source aiskenv/bin/activate  # Linux/Mac

# 安装依赖
pip install flask requests python-dotenv

我们先定义两个核心意图：

weather_query：包含城市 (city) 和时间 (date) 实体
fallback：无法识别时的兜底处理

用简单字典实现意图匹配：

intents = {"weather": ["天气", "天气预报", "会下雨吗"],
    "fallback": ["不明白", "听不懂"]
}

entities = {"city": ["北京", "上海", "广州"],
    "date": ["今天", "明天", "后天"]
}

用有限状态机管理对话流程：

from enum import Enum

class DialogState(Enum):
    INIT = 0      # 初始状态
    CITY = 1      # 等待城市输入
    DATE = 2      # 等待日期输入
    CONFIRM = 3   # 确认查询

使用和风天气免费 API（需注册获取 KEY）：

import requests

def get_weather(city, date):
    url = f"https://devapi.qweather.com/v7/weather/now?location={city}&key=YOUR_KEY"
    try:
        response = requests.get(url)
        return {"temp": response.json()["now"]["temp"],
            "text": response.json()["now"]["text"]
        }
    except Exception as e:
        print(f"API 调用失败: {e}")
        return None

统一返回 JSON 格式：

from flask import jsonify

{
    "version": "1.0",
    "response": {
        "outputSpeech": {
            "type": "PlainText",
            "text": f"{city}{date}的天气是 {text}, 温度{temp} 度"
        },
        "shouldEndSession": True
    }
}

from flask import Flask, request, jsonify
import logging

app = Flask(__name__)
logging.basicConfig(level=logging.INFO)

@app.route('/weather', methods=['POST'])
def handle_weather():
    data = request.json
    intent = data.get("intent")

    if intent == "weather_query":
        city = data.get("city")
        date = data.get("date")

        if not city:
            return ask_for_city()

        weather_data = get_weather(city, date)
        return format_response(weather_data)

    return fallback_response()

def ask_for_city():
    return jsonify({
        "response": "请问您想查询哪个城市的天气？",
        "reprompt": "请告诉我城市名称，例如北京",
        "sessionState": "CITY"
    })

if __name__ == "__main__":
    app.run(port=5000, debug=True)

遇到这些问题时可以这样排查：