需通过标准接口协议接入第三方API：一、配置API凭证；二、定义HTTP连接器与动作模板；三、在AI工作流中拖拽调用；四、启用Webhook接收异步响应；五、通过日志调试追踪全流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望提升WorkBuddy的AI执行能力，使其能够调用外部服务完成如天气查询、支付验证、数据库读写等任务，则需通过标准接口协议接入第三方API。以下是实现该目标的全流程操作步骤：
一、确认API接入权限与凭证配置
WorkBuddy需具备合法身份才能调用第三方API，这依赖于平台是否开放自定义HTTP请求能力及对应凭证管理模块。部分部署版本（如企业私有化实例）默认启用API网关白名单机制，需提前完成授权。
1、登录WorkBuddy管理后台，进入【系统设置】→【集成中心】→【API凭证管理】。
2、点击【新增凭证】，选择目标API类型（如RESTful、OAuth 2.0、API Key），填写服务商提供的Client ID、Client Secret或API Key字段。
3、在【回调地址】栏填入WorkBuddy实例的统一回调域名，格式为https://your-workbuddy-domain.com/api/v1/callback，确保与第三方平台注册一致。
4、勾选【启用签名验证】并上传WorkBuddy生成的公钥证书文件（.pem格式），完成凭证绑定。
二、定义API连接器与动作模板
WorkBuddy不直接编写代码，而是通过可视化连接器将第三方API封装为可复用的“动作单元”，供AI流程编排调用。每个连接器需明确输入参数映射、响应解析规则和错误码处理策略。
1、在【集成中心】中点击【新建连接器】，选择【手动配置HTTP API】。
2、输入连接器名称（如“高德地图地理编码”），填写API端点URL：https://restapi.amap.com/v3/geocode/geo。
3、在【请求头】区域添加Key字段：key: {credentials.amap_api_key}，其中{credentials.amap_api_key}为自动注入的凭证变量。
4、在【请求参数】中添加必填项：address（字符串）、city（字符串），并设置默认值或允许空值标识。
5、在【响应映射】中配置JSON路径提取规则，例如将$.geocodes[0].location映射为输出变量location_coord。
三、在AI工作流中调用已配置API动作
WorkBuddy的AI执行引擎支持在自然语言指令触发后，按预设逻辑链式调用多个API动作。调用过程无需脚本，全部通过拖拽节点与参数绑定完成。
1、进入【AI工作流设计台】，新建空白流程，命名如“用户地址转坐标并查周边POI”。
2、从左侧组件栏拖入【HTTP API调用】节点，下拉选择已配置的“高德地图地理编码”连接器。
3、在节点参数面板中，将上游文本输入字段（如用户说“我在北京西站”）绑定至address参数，city参数绑定为“北京市”。
4、再拖入一个【HTTP API调用】节点，选择“高德POI搜索”连接器，并将上一节点输出的location_coord自动注入其location参数。
5、点击【发布流程】，系统自动校验参数依赖关系与凭证有效性，通过后即可被AI语音/文本指令触发。
四、启用Webhook接收第三方异步响应
对于需长时间处理或事件驱动型API（如支付结果通知、IoT设备上报），WorkBuddy可通过内置Webhook服务接收外部推送，避免轮询开销并保障实时性。
1、在【集成中心】→【Webhook接收】中点击【创建端点】，生成唯一路径，例如：/webhook/payment/alipay-result。
2、设置安全密钥（如HMAC-SHA256签名密钥），并在支付宝开放平台配置该URL为异步通知地址。
3、在【Webhook接收】列表中点击刚创建的端点，进入【响应映射】页，定义JSON字段到WorkBuddy内部变量的映射，如将notify_data.out_trade_no映射为order_id。
4、勾选【触发工作流】，选择预设的“支付结果处理”流程，该流程将自动获取Webhook载荷并执行后续业务逻辑。
五、调试与日志追踪API交互全过程
所有API调用均被WorkBuddy记录为结构化事件，包含请求原始体、响应头、状态码、耗时及异常堆栈，便于定位鉴权失败、超时或字段不匹配等问题。
1、在【监控中心】→【API调用日志】中，使用时间范围与连接器名称筛选目标记录。
2、点击某条日志右侧【详情】，查看折叠的Request Payload与Response Body，关键字段如status_code: 401或error_code: INVALID_KEY将高亮显示。
3、若发现签名验证失败，在【凭证管理】中重新生成密钥对并更新第三方平台配置。
4、对返回JSON结构变更的情况，在对应连接器的【响应映射】中调整JSONPath表达式，例如将原$.data.items改为$.result.list。
