需通过配置第三方OpenAPI实现:一、添加启用API凭证;二、创建天气类HTTP连接器;三、创建股票类HTTP连接器;四、在技能中心发布绑定;五、验证调用结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在WorkBuddy中接入实时天气或股票类技能,需通过配置第三方OpenAPI实现数据拉取与动态响应。此类技能依赖外部HTTP接口返回结构化数据,必须正确设置认证方式、请求地址、参数映射及响应解析规则。以下是具体操作步骤:
一、确认API凭证已添加并启用
该步骤确保WorkBuddy具备合法调用权限,防止因凭据缺失或过期导致401/403错误。所有OpenAPI调用均需绑定对应服务商提供的身份凭证。
1、打开WorkBuddy客户端,点击左下角头像进入【系统设置】→【集成中心】→【API凭证管理】。
2、点击【新增凭证】,选择认证类型:若为和风天气、聚合数据等平台,选“API Key”;若为新浪财经开放平台OAuth流程,选“OAuth 2.0”。
3、填写服务商提供的字段:例如和风天气需填入Key值(32位十六进制字符串);聚合数据需填入API Key与Secret Key双字段。
4、勾选【启用签名验证】(如服务商要求),并上传WorkBuddy生成的公钥证书(.pem格式)。
二、创建天气类HTTP连接器
该连接器将封装天气API的通用调用逻辑,支持按城市名或经纬度查询实况与预报,输出结构化JSON供后续AI流程使用。
1、在【集成中心】点击【新建连接器】,选择【手动配置HTTP API】。
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、输入连接器名称:“和风天气实况查询”,填写端点URL:https://devapi.qweather.com/v7/weather/now?location={input.location}&key={credentials.qweather_key}。
3、在【请求头】区域添加:Accept: application/json;其中{credentials.qweather_key}自动注入上一步配置的凭证变量。
4、在【请求参数】中定义输入变量:添加location(字符串类型,默认值“101010100”即北京站编码),允许用户运行时传入城市ID或经度,纬度格式。
5、在【响应映射】中配置提取路径:将$.now.temperature映射为输出变量temp_c,$.now.textDay映射为weather_desc,确保AI可直接引用。
三、创建股票类HTTP连接器
该连接器适配免费或商用股票行情OpenAPI,支持按股票代码获取最新价、涨跌幅、成交量等核心字段,兼容A股、港股及部分美股代码格式。
1、在【集成中心】点击【新建连接器】,选择【手动配置HTTP API】。
2、输入连接器名称:“聚宽股票实时行情”,填写端点URL:https://api.jqdata.com/v1/quote/latest?symbol={input.symbol}&fields=price,change_pct,volume。
3、在【请求头】区域添加:Authorization: Bearer {credentials.jqdata_token},其中{credentials.jqdata_token}为OAuth 2.0凭证中获取的访问令牌。
4、在【请求参数】中设置symbol字段:支持输入格式如“000001.XSHE”(深市)、“600519.XSHG”(沪市),或“AAPL.US”(美股)。
5、在【响应映射】中配置成功判定条件:状态码=200且$.code == 0;错误信息路径设为$.message;关键字段映射为price、change_pct、volume三个输出变量。
四、在技能中心发布并绑定连接器
该步骤将连接器注册为可被AI工作流调用的技能节点,赋予其自然语言触发能力,并支持参数自动填充与上下文感知。
1、进入【技能中心】→【我的技能】页签,点击【新建技能】→【基于连接器封装】。
2、从下拉列表中选择刚创建的“和风天气实况查询”连接器,填写技能名称:“查天气”。
3、在【触发指令】栏输入示例语句:“告诉我上海现在的天气”,系统将自动识别“上海”为location变量值。
4、点击【保存并发布】,技能状态变为“已就绪|可编排调用”,即可在AI工作流画布中拖入使用。
五、验证连接器调用结果
该步骤用于确认连接器能稳定返回有效数据,排除网络拦截、域名白名单未放行、参数拼写错误等常见异常。
1、进入【集成中心】→【连接器管理】,找到“聚宽股票实时行情”连接器,点击右侧【测试】按钮。
2、在弹出窗口中输入测试参数:{"symbol": "600519.XSHG"},点击【执行】。
3、观察响应体是否包含price字段且数值非空,检查响应头中X-RateLimit-Remaining大于0,确认未达调用频次上限。
4、若返回404错误,核查URL中域名是否为服务商当前生效地址;若返回429,需在凭证配置中启用请求限速策略。

















