一、Skill 是什么?
在平台中,Skill(技能) 是一种可复用、可定制的功能单元,它封装了特定的业务能力,能够接收输入、执行逻辑并返回结果。你可以把 Skill 理解为一个“能力积木”——把复杂的功能打包成标准化模块,用户无需编写代码即可调用,开发者也能快速扩展平台能力。
Skill 的典型特征:
事件驱动:由特定触发条件激活(如关键词、用户意图、定时任务、API 回调等)。
逻辑内聚:内部包含了完成任务的完整流程,例如数据查询、条件判断、调用外部服务等。
标准输入输出:通过统一的数据格式与外界交互,便于组合和复用。
可发现可共享:通常有 Skill 市场或库,用户可以一键安装使用。
常见应用场景:
智能对话:如查天气、订机票、翻译、知识问答等对话式技能。
自动化流程:如“当收到新订单时,自动发送通知并生成报表”的工作流技能。
IoT 控制:如开关灯、调节温度等设备控制技能。
数据分析:如输入数据集,自动清洗并生成可视化图表的技能。
第三方集成:如连接 CRM、邮件系统、日历的桥接技能。
二、怎么做:创建 Skill 的详细步骤
下面以创建一个“每日英语金句”对话式 Skill 为例,演示从零到发布的完整过程。
2.1 准备工作
登录平台后台,进入 Skill 管理 或 开发者中心。
确保账号拥有创建 Skill 的权限(通常管理员或开发者角色)。
明确 Skill 的功能目标和输入/输出:本例中,用户说“来句英语名言”,Skill 从名言库随机返回一条中英双语金句。
2.2 创建 Skill 并填写基本信息
点击 “新建 Skill”。
填写:
名称:
每日英语金句标识符(唯一 ID):
daily-english-quote描述:随机返回一句英文名言及中文释义,支持分类筛选。
分类:教育/内容
图标:上传一个代表名言或英语的图标。
点击 “创建”,进入编辑界面。
2.3 定义触发方式(意图与示例语料)
一个 Skill 需要知道用户在什么情况下会触发它。我们使用意图(Intent) 和训练语料来定义。
新建意图,命名为
get_quote。添加示例语料(用户可能说的话):
“来一句英语名言”
“给我一句英文金句”
“每日一句”
“今天有什么英语名言”
“来一句励志的英语句子”
如果希望支持参数,可以定义槽位(Slot),例如:
槽位名:
category,类型:枚举(励志/爱情/哲理/幽默),用户说“来一句励志名言”时自动提取“励志”。
这样 Skill 能按类别返回。
2.4 设计处理逻辑
根据你的平台能力,选择可视化编排、配置表单或代码脚本来实现核心逻辑。
示例:使用内置的“逻辑模块”编排
拖入一个 “条件判断” 节点:检查是否提供了
category参数。若有:按分类从名言库中筛选。
若无:从全部名言中随机取一条。
名言库可以用 “变量定义” 节点内置一个列表,或调用 API 节点 从外部服务获取。这里使用内置列表简化:
json
[ {"en": "The only way to do great work is to love what you do.", "zh": "成就伟业的唯一途径是热爱你所做的事。", "cat": "励志"}, {"en": "In the middle of difficulty lies opportunity.", "zh": "困难之中蕴藏着机会。", "cat": "哲理"}]使用 “随机取值” 模块从筛选后的数组中随机选一条。
2.5 配置输出与回复
将处理结果组织成用户可读的回复。通常支持多模态(文本、卡片、语音等)。
文本回复模板:
text
???? {{quote.en}} ???? {{quote.zh}} —— 今日金句【{{quote.cat}}】可添加 提示建议:例如按钮“再来一句”、“换励志类”。
2.6 测试与调试
使用内置 模拟测试窗口,输入“来一句励志名言”。
查看输出是否符合预期:是否返回了励志类的金句,格式是否正确。
检查错误处理:当名言库为空或分类无匹配时,返回友好提示“暂无该类名言,为你随机推荐一条…”。
2.7 发布与部署
确认无误后,点击 “发布”。
选择发布环境:测试环境/生产环境。
设置可见性:私有(仅自己)或公开发布到 Skill 市场,供其他用户安装。
提交审核(如果平台要求)。发布成功后,该 Skill 进入可用状态。
三、怎么用:使用 Skill 的完整指南
Skill 发布后,普通用户和开发者可以通过多种方式使用它。
3.1 从 Skill 市场安装
进入平台的 “Skill 市场” 或 “技能中心”。
浏览或搜索“每日英语金句”。
点击 “安装” 或 “添加至我的技能”。
部分 Skill 可能需要授权(如访问日历、位置等),根据提示完成授权。
安装成功后,该 Skill 会出现在你的 “我的技能” 列表中。
3.2 通过对话或命令调用
如果你的平台具备对话界面(如聊天机器人、语音助手),安装后直接对话即可:
用户:“来一句英语名言”
助手自动激活
每日英语金句技能,返回金句。
在其他入口(如快捷指令、搜索框),也可通过 斜杠命令 调用,例如:/english-quote。
3.3 在自动化流程中调用
Skill 可作为流程节点嵌入更大的自动化中,比如:
定时任务:每天早上 8 点,自动运行“每日英语金句”技能,并将结果推送到企业微信群。
条件触发:当检测到用户加入“英语学习群”时,自动发送一条金句作为欢迎消息。
在流程编辑器中,只需拖入 “执行 Skill” 节点,选择目标 Skill,设置输入参数即可。
3.4 查看执行记录与日志
在 “我的技能” 中,每个 Skill 卡片的详情页都有 “运行记录” 或 “日志” 选项卡。
可以看到每次调用的时间、输入参数、输出结果、是否成功。
对于开发者,还能查看详细的调试信息和错误堆栈,便于优化。
3.5 管理已安装的 Skill
配置:有些 Skill 提供设置项(如默认分类、推送渠道),点击“设置”进行调整。
更新:当开发者发布新版本时,会收到更新提醒,可一键升级。
暂停/卸载:如果不再需要,可以停用或卸载。卸载后相关自动化节点会失效,请提前调整。
四、最佳实践与技巧
命名与语料设计:意图名要见名知意,示例语料尽量覆盖多种口语表达,提高识别率。
容错处理:务必处理无结果、参数缺失、服务超时等异常,让 Skill 在任何情况下都有合理回复。
复用与组合:将通用功能(如“获取当前时间”“发送邮件”)拆成独立 Skill,然后在复杂流程中组合调用,降低维护成本。
分析数据:利用平台提供的调用次数、成功率、热门参数等数据,持续优化 Skill 逻辑和回复质量。
安全与权限:涉及用户数据的 Skill 必须明确申请权限,遵循最小权限原则,并在描述中说明用途。