需先在轻流或简道云开放平台创建带读写权限的api key并获取应用id/表单id等凭证，再在coze中配置http节点调用对应api，配合json path解析返回数据，最后通过条件判断和二次http请求实现安全回写。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在扣子（Coze）中实时调用轻流或简道云里的业务数据（比如维修工单、客户信息、库存状态），又不想写代码、不依赖开发排期，就得靠无代码对接路径打通两端——关键不是连上，而是让数据能带上下文、可验证、能回写。
先确认你手上的权限和凭证
进入轻流或简道云后台，打开「开放平台」→「密钥管理」→新建一个API Key，勾选「读取表单数据」「更新字段值」权限；复制生成的Key字符串，【务必保存好，页面关闭后无法再次查看】。这一步漏掉，后面所有节点都会报401错误。
在轻流中还需额外获取「应用ID」和「流程ID」；在简道云中则要记下目标表单的「formId」和字段「fieldKey」，比如客户电话字段可能是「fld123abc」。
扣子侧配置HTTP请求节点
打开Coze Bot编辑页→添加「工作流」→拖入「HTTP 请求」节点。
方法一：直连简道云公开API（适合只读场景）
URL填：https://api.jiandaoyun.com/v1/forms/{formId}/records
请求方式选GET，Headers里加：Authorization: Bearer {你的API Key}
Query参数填：filter={"fieldKey":"fld123abc","value":"张三"}
方法二：调用轻流Webhook（支持写入+条件触发）
URL填轻流后台生成的「应用Webhook地址」，格式类似https://qyapi.lingxi365.com/webhook/{appId}/{flowId}
Body选application/json，内容为：{"trigger":"manual","data":{"customer_name":"{{input.name}}","phone":"{{input.phone}}"}}
【注意：轻流Webhook默认只接受POST，且必须带trigger字段，否则直接拒绝】
让扣子自动解析返回数据
HTTP请求节点执行后，返回的JSON会自动注入变量$http.body。
若返回结构是{"data":[{"id":"rec_xxx","fields":{"fld123abc":"138****1234"}}]}，直接用$http.body.data[0].fields.fld123abc提取手机号。
扣子 (Windows) 是字节跳动推出的一站式 AI Agent 平台客户端，支持多 Agent 协作、可视化工作流和知识库管理。最新版本新增 Claude Code 与 Codex CLI 接入、多端同步和项目级管理功能，同时优化了插件生态和 AI 响应速度，让用户在 Windows 上即可高效创建、运行和协作智能体，满足个人、团队及企业场景需求。
但简道云返回的字段名是随机生成的fieldKey，不是中文名；轻流返回的data字段可能被包裹在result或payload里——这时必须用「JSON Path」插件做一次提取，否则后续节点会找不到变量。
例如：在HTTP节点后加一个「JSON Path」节点，Expression填$.data[0].fields.fld123abc，输出变量设为user_phone，后面所有消息卡片、判断分支都引用这个干净变量。
回写结果到轻流/简道云表单
第一步：在HTTP请求节点后接一个「条件判断」节点，检查$http.status === 200是否成立；不成立就走错误分支发飞书告警。
第二步：成立时，新增一个HTTP请求节点，URL改为简道云更新接口：https://api.jiandaoyun.com/v1/forms/{formId}/records/{recordId}
请求方式选PUT，Headers同前，Body填：{"fields":{"fld456xyz":"已由AI初审通过"}}
第三步：如果要批量更新，别用单条PUT——改用POST /v1/forms/{formId}/records/batch_update，Body里传数组，每项含record_id和fields对象；【简道云batch_update接口单次最多处理100条，超量必须分片】。
第四步：轻流侧回写更简单，复用上一步的Webhook地址，把method从manual换成update，data里带上record_id即可。
