必须严格按工具文档配置参数类型、触发时机和来源,进入「集成→工具管理」核对参数契约,在行为流中用静态值或动态绑定方式传参,嵌套结构需用「构建对象」节点处理,调试时通过「测试运行」查看实际payload。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在函子Zion中配置外部工具调用并正确传递参数,必须明确工具类型(API、CLI、AI Agent)、触发时机(按钮点击、表单提交、定时任务)以及参数来源(表单字段、数据模型字段、环境变量)。漏传或错传参数会导致工具执行失败或返回空结果。
确认工具接入方式与参数契约
进入「集成」→「工具管理」,点击目标工具卡片,在右侧「参数说明」区域查看官方定义的必填/选填参数列表。每个参数都标注了类型(string、number、boolean、object)、是否必需、默认值及示例值。这一步不能跳过——【Zion不会自动推断参数含义,所有参数名和结构必须严格匹配工具文档】。
例如调用飞书机器人发消息,必须提供 webhook_url(string)、msg_type(string)、content(object),少一个或拼错 content 就会报 400 错误。
在行为流中绑定参数值
打开对应页面的行为流编辑器,找到「调用工具」节点,点击进入配置面板。
方法一:静态值直接填写
在参数输入框里键入字符串、数字或 JSON 格式对象(如 {"text": "订单已创建"}),适用于固定内容。
方法二:动态绑定字段
点击参数框右侧「{…}」图标,从弹出的数据源树中选择:当前表单字段(如 form.order_id)、当前数据模型记录字段(如 record.status)、全局变量(如 $user.id)或上一步节点输出(如 previous_node.result.url)。
注意:若绑定的是对象型字段(如 record.detail),而工具要求字符串,需先用「转换」节点转成 JSON 字符串,否则传过去是 undefined。
处理多层级嵌套参数
有些工具(如 Stripe 创建支付意图)要求参数为深层嵌套结构:
- 第一步:在行为流中添加「构建对象」节点,命名为 build_payment_params;
- 第二步:在该节点内逐级展开字段:设置 client_secret → previous_node.client_secret,payment_method_types → ["card"],amount → form.total * 100;
- 第三步:将 build_payment_params 节点的 output 直接拖拽到「调用工具」节点的 params 字段上。
这比手动写 JSON 更安全,Zion 会实时校验字段是否存在、类型是否匹配。
调试时查看实际发出的参数
保存行为流后,点击右上角「测试运行」,填写触发数据,执行完成后展开「日志」标签页。找到「工具调用」条目,点击展开即可看到 Zion 实际组装并发送的完整参数 payload。如果参数异常,错误提示会精确指出哪一层 key 缺失或类型不符。











