Coze 节点用法总结

Coze 节点用法总结

核心节点功能

1. 大模型节点

   • 输入：自然语言指令或提示词（Prompt）。
   • 输出：可选择 string 或 json 格式。
   • 注意点：
     • 计算问题： 如果涉及计算（如 4*3），某些模型（如豆包）可能输出错误结果（40）。需要额外添加计算插件才能保证正确。
     • 模型选择： deepseekr1 模型相对不易出错，但很消耗 Token。

2. If 节点

   • 功能：条件分支。
   • 评价：在处理需要根据多个不同值进行分类的复杂条件时，体验不佳。
   • 建议：复杂条件判断更推荐使用 代码节点 实现。

3. For 循环节点

   • 结构：
     • 左边节点： 循环入口（接入点）。
     • 右边节点： 循环出口（输出点）。
     • 循环体： 位于左右节点框之间，包含需要循环执行的操作节点。
   • 循环方式：支持无限循环、指定次数循环、遍历数组。
   • 主要缺点：缺乏 break 机制，无法提前终止循环，使用体验受限。

4. 代码节点

   • 支持语言：Python 或 JavaScript。

   • 输入参数：支持 Array, string, number, boolean, json。

   • 输出限制： 返回值只允许 string, object, Array<object>。尝试返回 boolean 或 number 会报错。

   • 代码结构示例 (JavaScript)：

     async function main({ params }: Args): Promise<Output> {
         // 通过 params.外部变量名 获取输入
         // 通过 ret 对象设置输出变量 (必须是 string, object, Array<object>)
         const ret = ...; // 处理逻辑
         return ret;
     }

5. 知识库节点

   • 输入限制： 只能传入自然语言 进行查询。
     • 直接传入 SQL 语句无法返回结果。
     • 即使将复杂 SQL (如 SELECT u.username, o.order_date, SUM(...) ...) 转换成自然语言描述，也可能无法返回预期结果。
   • 输出格式： 固定返回一个对象，包含 表ID 和 结果字符串。
   • 使用难点：要利用返回结果中的数据，必须 ：
     • 使用代码节点进行解析处理，或者
     • 直接将结果字符串扔给大模型节点处理。

6. 数据库节点

   • 功能概览： 提供对数据库表的基本 CRUD 操作，操作空间较大。
   • 核心限制： 一个数据库节点只能操作一个库中的一个表。不支持跨库、跨表操作。
   • 具体操作：
     1. 新增数据：
        • 引用其他节点的变量值。
        • 可配合代码节点灵活组装要存储的字段数据。
        • 偷懒做法：让大模型节点生成目标 JSON 结构，然后映射字段存储。
     2. 更新数据：
        • 设置更新条件（支持 ===, !==, >, <, >=, <=, 模糊匹配, 模糊不匹配）。
        • 对匹配的记录，通过赋值方式更新指定字段。
     3. 删除数据：
        • 逻辑与更新类似，设置删除条件，符合条件即删除。
     4. 自定义 SQL：
        • 可编写任意 SQL 语句执行。
        • 返回结果高度自定义，灵活性最高。

7. 输出节点

   • 功能：输出一段固定的文本内容。
   • 实用性：在长流程中，用于向用户反馈当前进度，提升等待耐心。
   • 流式输出： 支持流式输出（即"生成一个字就蹦一个字"）。

节点连接规则

1. 禁止成环： 节点之间的连接线不能形成闭环，否则会报错。
2. 必须连接： 每个节点上标记为"必须"的连接点（通常有特殊标识或要求），必须全部正确连接，缺少任何一个连接都会导致报错。

---