WorkBuddy自定义技能怎么创建

想让WorkBuddy真正听懂你的业务需求？这篇教程手把手教你打造专属自动化技能——只需编写规范的JSON定义文件，搭配HTTP调用或轻量JavaScript脚本，就能让WorkBuddy响应“查订单状态”等自然指令、调用API或执行逻辑判断；配合实时日志调试和基于版本ID的灰度部署机制，你还能安全迭代、精准验证，零基础也能快速扩展智能办公能力。

如果您希望在WorkBuddy中扩展其自动化能力，通过编写自定义技能来响应特定指令或触发业务逻辑，则需了解其Skills的结构规范与注册机制。以下是实现自定义Skills的具体操作路径：

一、理解Skills基础结构

WorkBuddy的自定义Skill以JSON文件形式定义，包含唯一标识符、触发关键词、执行动作类型及参数映射规则。该文件必须符合平台预设的schema，否则无法被加载识别。

1、新建纯文本文件，命名为my_skill.json。

2、在文件中填入标准字段：必需包含id（字符串，全局唯一）、name（显示名称）、triggers（数组，含至少一个keyword）、action（对象，指定type为http或script）。

3、确保id值不与系统内置Skill或其他已安装Skill重复，重复ID将导致加载失败且无提示。

二、使用HTTP类型Skill调用外部API

此方式适用于无需本地计算、仅需转发请求并解析响应的场景，Skill本身不执行代码，依赖WorkBuddy发起HTTP请求。

1、在action字段中设置{"type": "http", "url": "https://api.example.com/v1/process", "method": "POST"}。

2、在triggers中添加{"keyword": "查订单状态", "case_sensitive": false}。

3、通过parameters字段声明输入映射，例如[{"name": "order_id", "source": "last_word"}]，表示将用户指令末尾单词作为order_id传入请求体。

4、保存文件后，进入WorkBuddy管理后台的Skills → 本地导入，选择该JSON文件上传，上传后需手动点击“启用”才生效。

三、使用Script类型Skill执行JavaScript逻辑

该方式允许在WorkBuddy运行时环境中执行轻量JavaScript代码，适用于数据格式转换、条件判断或组合多个API调用。

1、创建同名JS文件my_skill.js，内容需导出默认函数，形如module.exports = async (context) => { return { text: `订单${context.order_id}已发货` }; };。

2、在对应JSON文件的action中改为{"type": "script", "file": "my_skill.js"}。

3、确保JS文件与JSON文件位于同一目录，并在管理后台导入JSON时，系统自动关联同名JS文件。

4、脚本中禁止使用require、import、setTimeout等Node.js特有API，仅支持ES2020语法子集。

四、调试自定义Skill输出

WorkBuddy提供实时日志查看功能，用于验证触发匹配与执行结果，避免盲目修改配置。

1、在管理后台打开Skills → 日志面板，勾选“显示调试信息”。

2、向WorkBuddy发送一条匹配trigger keyword的消息，例如“查订单状态 123456”。

3、观察日志中是否出现Matched skill: my_skill，随后显示Executed action type: http或script及返回内容片段。

4、若未匹配，检查triggers.keyword是否含不可见空格，中文标点与英文标点被视为不同字符。

五、部署多版本Skill进行灰度验证

当需对同一功能迭代更新时，可通过版本号隔离新旧逻辑，避免全量覆盖引发误触发。

1、在JSON文件的id字段末尾添加版本标识，例如"my_skill_v2"，而非覆盖原"my_skill"。

2、为新版本设定独立triggers，如"keyword": "查订单状态v2"，确保测试期间互不干扰。

3、导入新JSON文件后，在后台的Skills列表中可同时看到两个条目，分别启用/禁用以控制可见性。

4、同一id只能存在一个启用状态的Skill，重复启用会静默禁用前一个。

今天关于《WorkBuddy自定义技能怎么创建》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！