Workbuddy Skill 新手入门指南：从零构建你的第一个智能助手技能

11次阅读

没有评论

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

Workbuddy Skill 是一种可扩展的智能助手功能模块，允许开发者通过定义对话逻辑和接口集成来扩展智能助手的能力。它的基本架构包含三个核心部分：

交互模型：定义用户如何与技能对话（语音 / 文本指令）
业务逻辑：处理用户请求并返回响应
接口集成：连接外部 API 或服务获取数据

工作原理可以简单理解为：用户说出指令 → Workbuddy 平台解析意图 → 调用你的技能逻辑 → 返回语音 / 文本响应。

Python 3.8+（推荐使用 virtualenv）
Workbuddy 开发者账号
代码编辑器（VS Code/PyCharm）
Postman（用于 API 测试）

安装 Python 并验证版本：
```
python --version
```

创建项目目录并初始化虚拟环境：

mkdir my_first_skill && cd my_first_skill
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate    # Windows

安装核心依赖包：

pip install workbuddy-sdk requests python-dotenv

在 Workbuddy 开发者控制台：

点击 ”Create New Skill”
选择 ”Custom” 类型
填写技能名称和调用词（如 ” 天气助手 ”）

创建两个核心意图：

GetWeatherIntent：处理天气查询
示例语句：”{city}天气怎么样 ”、” 查询 {date}{city} 天气预报 ”
HelpIntent：提供使用帮助
示例语句：” 这个技能怎么用 ”、” 你能做什么 ”

在 GetWeatherIntent 中添加：

city（城市）：必填槽位，类型为 AMAZON.City
date（日期）：可选槽位，类型为 AMAZON.DATE

以下是完整的 Python 处理代码（保存为 lambda_function.py）：

import os
import requests
from workbuddy_sdk import Skill, request, response
from datetime import datetime

# 初始化技能实例
skill = Skill(__name__)

# 天气 API 配置
WEATHER_API_KEY = os.getenv('WEATHER_API_KEY')
BASE_URL = 'https://api.weatherapi.com/v1/forecast.json'

@skill.intent('GetWeatherIntent')
def get_weather():
    """处理天气查询请求"""
    try:
        # 获取槽位值
        city = request.slot_value('city')
        date = request.slot_value('date') or 'today'

        # 调用天气 API
        params = {
            'key': WEATHER_API_KEY,
            'q': city,
            'dt': date,
            'lang': 'zh'
        }
        api_response = requests.get(BASE_URL, params=params)
        api_response.raise_for_status()

        # 解析响应数据
        weather_data = api_response.json()
        condition = weather_data['current']['condition']['text']
        temp_c = weather_data['current']['temp_c']

        # 构建语音响应
        speech = f"{city}{date}的天气是 {condition}，气温{temp_c} 摄氏度"
        return response.tell(speech)

    except requests.exceptions.RequestException as e:
        return response.tell(f"获取天气信息失败，请稍后再试")

@skill.intent('HelpIntent')
def help():
    """提供使用帮助"""
    help_text = "你可以问我某个城市的天气情况，比如' 北京天气怎么样 '"
    return response.tell(help_text)

# 默认处理函数
@skill.default_handler
def default():
    return response.tell("抱歉我没听懂，你可以说' 帮助 '了解我能做什么")

handler = skill.get_handler()