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

2次阅读

没有评论

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

Picoclaw Skill 是一种语音交互技能开发框架，允许开发者快速构建可集成到各类语音助手平台（如智能音箱、车载系统等）的交互功能。简单来说，它就像给语音助手安装的 ” 小程序 ”，让用户通过自然语言完成查询、控制或娱乐等操作。

常见应用场景包括：

智能家居控制（” 打开客厅的灯 ”）
信息查询（” 今天会下雨吗？”）
娱乐互动（” 讲个笑话 ”）
教育工具（” 英语单词测验 ”）

硬件要求：
电脑（Windows/Mac/Linux 均可）
可联网环境
软件工具：
最新版 Chrome/Firefox 浏览器
Python 3.8+ 或 Node.js 14+
代码编辑器（VS Code 推荐）
账号注册：
访问 Picoclaw 开发者平台
点击 ” 注册 ” 填写邮箱和密码
查收验证邮件完成激活

登录开发者平台后点击 ” 新建技能 ”
填写技能基本信息：
技能名称（如 ” 天气查询 ”）
调用名称（用户唤醒词，如 ” 问问天气 ”）
选择技能类型（自定义技能）
点击 ” 创建 ” 进入开发仪表盘

意图 (Intent) 代表用户想要完成的任务，例如 ” 查询天气 ”。每个意图需要定义：

示例语句（用户可能说的话）：
“ 今天天气怎么样 ”
“ 北京明天会下雨吗 ”
“ 上海的气温 ”

槽位 (Slot) 是意图中的关键参数，如：

城市（location）
日期（date）

定义方法：

在仪表盘点击 ” 添加意图 ”
输入意图名称（如 ”WeatherQuery”）

添加示例语句并标记槽位：

{location}今天天气如何 → 标记 "location" 为槽位

在 ” 交互模型 ” 页面设计对话流程：

用户说：” 查询天气 ”
系统问：” 请问您想查询哪个城市？”（如未提供城市）
用户说：” 北京 ”
系统回复天气信息

使用内置模拟器测试：
输入或语音录入测试语句
查看系统是否能正确识别意图和槽位
设备端测试：
在已关联的智能音箱上唤醒技能测试
查看日志：
在 ” 分析 ” 页面查看请求 / 响应数据

# 天气查询技能示例
from picoclaw import Skill, request, response

# 初始化技能
app = Skill(__name__)

# 天气查询处理函数
@app.handle('WeatherQuery')
def weather_query():
    # 获取槽位值
    city = request.slots.get('location', '北京')  # 默认北京
    date = request.slots.get('date', '今天')     # 默认今天

    # 这里应该是调用天气 API 的代码
    # 模拟返回数据
    weather_data = {
        'city': city,
        'date': date,
        'condition': '晴',
        'temp': '25℃'
    }

    # 构建语音回复
    speech = f"{weather_data['date']}{weather_data['city']}天气{weather_data['condition']}，气温{weather_data['temp']}"

    # 返回响应
    return response.tell(speech)

# 启动技能
if __name__ == '__main__':
    app.run()