WorkBuddy的HTTP型Skill必须显式声明请求信息、触发关键词和参数映射才能调用外部API;URL须为HTTPS,触发词不区分大小写,参数可从指令末尾或正则提取;调试需检查日志与Network面板,鉴权需通过headers字段注入token。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

WorkBuddy的Skill需要调用外部服务时,必须显式声明HTTP请求行为并绑定触发条件,否则即使技能已安装启用,也无法发起网络调用——系统默认禁止任何未经配置的出站请求,这是内置的安全熔断机制。
配置HTTP类型Skill调用外部API
此方式适用于无需本地计算、仅需转发请求并解析响应的场景,Skill本身不执行代码,依赖WorkBuddy发起HTTP请求。
第一步:在action字段中设置请求元信息
编辑skill.json或通过Skill Creator界面,在action字段填入:{"type": "http", "url": "https://api.example.com/v1/process", "method": "POST"}。URL必须为完整HTTPS地址,【不支持HTTP协议,非HTTPS将直接被拦截】。
第二步:定义触发关键词
在triggers数组中添加触发规则,例如:[{"keyword": "查订单状态", "case_sensitive": false}]。关键词区分中英文空格,但不区分大小写;若用户指令中出现该词,WorkBuddy才会尝试匹配并执行此Skill。
第三步:映射输入参数
通过parameters字段声明如何从用户指令中提取参数,例如:[{"name": "order_id", "source": "last_word"}]表示取指令末尾单词作为order_id传入请求体。也可用"source": "regex"配合正则提取,但需确保正则语法与WorkBuddy运行时环境兼容(实测支持Python风格re模块语法)。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表,就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
验证外部服务调用是否生效
方法一:对话中直接测试
确保该Skill已启用→在聊天框输入触发关键词(如“查订单状态 123456”)→观察回复是否包含“正在向 https://api.example.com 发起 POST 请求…”类日志。若只返回“未识别指令”或空白响应,说明triggers未命中或parameters提取失败。
方法二:查看网络请求日志
打开WorkBuddy开发者面板(Ctrl+Shift+I)→切换到Network标签→复现触发动作→筛选XHR类型请求→确认是否有目标域名的请求发出且状态码为200。若无请求记录,问题一定出在Skill配置层而非网络连通性。
安全与调试注意事项
所有对外HTTP调用均受本地防火墙和系统代理设置影响。若公司内网使用PAC脚本或强制代理,需在WorkBuddy设置中手动填写代理地址,否则请求会超时失败。
⚠️注意:【Skill中硬编码的API密钥会被自动脱敏显示,但不会被自动注入请求头;如需鉴权,必须在action中显式添加headers字段,例如{"Authorization": "Bearer {{token}}"},且token需通过环境变量或连接器注入,不可写死】。

















