Agent Skill规范入门指南：从零构建高效技能开发流程

8次阅读

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

Agent Skill 可以理解为智能助手的 ” 技能插件 ”，就像手机 APP 赋予手机新功能一样。比如天气查询、航班预订、智能家居控制等，都是通过 Agent Skill 实现的。在现代对话系统中，规范的 Skill 开发能确保不同技能协同工作，就像乐高积木的标准化接口让不同模块完美拼接。

刚开始开发 Agent Skill 时，我遇到过不少典型问题：

接口混乱 ：返回数据一会儿用temperature 一会儿用temp，其他开发者调用时一脸懵
技能打架：两个天气技能同时响应 ” 今天天气 ”，系统不知道听谁的
调试困难：没有标准化日志格式，查 bug 像在迷宫里转圈
上下文丢失：问完 ” 北京天气 ” 再说 ” 明天呢 ”，系统直接死机

每个 Skill 都需要用 JSON Schema 声明自己的身份和能力范围：

{
  "skill_name": "weather_query",
  "version": "1.0.0",
  "description": "提供国内外城市天气预报查询",
  "intents": [
    {
      "name": "query_weather",
      "slots": ["city", "date"],
      "sample_utterances": ["{city}天气怎么样",
        "查查 {date}{city} 的天气"
      ]
    }
  ]
}

输入规范：
必填参数放在required_params
可选参数放在optional_params
时间参数统一用 ISO8601 格式

输出规范：

{
  "status": 200,
  "data": {
    "temperature": 26,
    "weather_condition": "晴",
    "unit": "℃"
  },
  "timestamp": "2023-08-20T14:30:00Z"
}

实现多轮对话需要记住这三要素：

对话 ID：用 session_id 串联同一会话
状态标记 ：通过dialog_state 标识对话阶段
历史记忆 ：在context 中保存关键信息

下面是用 Python 实现的完整示例（Flask 框架）：

from flask import Flask, request, jsonify
import datetime

app = Flask(__name__)

# 模拟天气数据库
weather_db = {
    "北京": {"2023-08-21": {"temp": 28, "condition": "多云"},
        "2023-08-22": {"temp": 30, "condition": "晴"}
    }
}

@app.route('/weather', methods=['POST'])
def query_weather():
    try:
        data = request.json

        # 参数校验
        if not data.get('city'):
            return jsonify({"error": "缺少城市参数"}), 400

        # 默认查询当天
        query_date = data.get('date', str(datetime.date.today()))

        # 业务逻辑
        city_data = weather_db.get(data['city'], {})
        result = city_data.get(query_date, {"temp": "N/A", "condition": "无数据"})

        # 标准化响应
        return jsonify({
            "status": 200,
            "data": {"temperature": result["temp"],
                "weather_condition": result["condition"],
                "query_time": datetime.datetime.now().isoformat()
            }
        })

    except Exception as e:
        return jsonify({"error": str(e)}), 500

# 单元测试示例
if __name__ == '__main__':
    import unittest

    class TestWeatherSkill(unittest.TestCase):
        def setUp(self):
            self.app = app.test_client()

        def test_normal_query(self):
            resp = self.app.post('/weather', json={"city": "北京"})
            self.assertEqual(resp.status_code, 200)
            self.assertIn('temperature', resp.json['data'])

    unittest.main()