Codebuddy Skill 开发入门指南：从零构建你的第一个技能模块

1次阅读

没有评论

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

在 Codebuddy 平台中，Skill（技能模块）可以理解为一个独立的功能单元。比如天气预报、待办事项提醒、智能家居控制等，每个功能都可以开发成一个 Skill。它的生命周期分为四个阶段：

注册：在 Codebuddy 开发者平台创建技能，填写基础信息
训练：定义技能支持的指令（意图）和对应的语句样本
部署：将代码发布到 Codebuddy 的云环境
调用：用户通过语音或文字触发技能

开始前需要准备：

Python 3.8+ 或 Node.js 14+
Codebuddy CLI 工具（安装命令：pip install codebuddy-sdk）
一个 Codebuddy 开发者账号
推荐使用 VS Code 或 PyCharm 等支持代码补全的编辑器

创建 manifest.json 文件，这是技能的 ” 身份证 ”：

{
  "skillName": "weather_forecast",
  "version": "1.0",
  "description": "查询城市天气情况",
  "privacyPolicy": {"containsPersonalData": false}
}

在开发者平台创建两个核心意图：

查询天气：
样本语句：” 北京今天天气怎么样 ”、” 上海明天会下雨吗 ”
帮助意图：
样本语句：” 这个技能能做什么 ”、” 如何使用天气查询 ”

import asyncio
from codebuddy_sdk import Skill, Response

class WeatherSkill(Skill):
    async def handle(self, request):
        try:
            city = request.slots.get("city")
            date = request.slots.get("date", "today")

            # 模拟调用天气 API
            weather_data = await self._fetch_weather(city, date)

            return Response.text(f"{date} {city}天气是{weather_data}")

        except Exception as e:
            self.logger.error(f"查询失败: {str(e)}")
            return Response.text("天气查询服务暂时不可用")

    async def _fetch_weather(self, city, date):
        # 这里应该是真实的 API 调用
        await asyncio.sleep(0.5)  # 模拟网络延迟
        return "晴转多云" if date == "tomorrow" else "晴天"

当用户问 ” 那后天呢？” 时，需要记住之前提到的城市：

class WeatherSkill(Skill):
    def __init__(self):
        self.context = {}

    async def handle(self, request):
        # 从上下文中获取上次查询的城市
        last_city = self.context.get("last_city")

        # 如果用户没有明确说城市，使用上次的
        city = request.slots.get("city") or last_city

        if not city:
            return Response.text("您想查询哪个城市的天气呢？")

        # 存储当前城市到上下文
        self.context["last_city"] = city

本地测试：
使用 codebuddy local 命令启动本地测试服务器
通过 Postman 发送模拟请求
日志查看：
在开发者平台的 ” 日志中心 ” 过滤 ERROR 级别日志
关键日志字段：request_id, execution_time
意图匹配测试：
在平台输入 ” 北京明天天气 ”，检查是否命中正确意图
验证提取的 city 和 date 参数是否准确

使用 __init__.py 预加载常用资源
实现健康检查接口/health

对高频查询城市实现缓存：

from datetime import timedelta
from cachetools import TTLCache

# 缓存最近 100 个城市，有效期 10 分钟
weather_cache = TTLCache(maxsize=100, ttl=timedelta(minutes=10))

async def _fetch_weather(self, city, date):
    cache_key = f"{city}_{date}"
    if cache_key in weather_cache:
        return weather_cache[cache_key]

    # ... 真实 API 调用
    weather_cache[cache_key] = result
    return result