[智能体-458]：Coze中的变量，包括节点变量与传统编程的变量的对应关系

一、Coze 全类型变量分类结合架构图Coze 里的变量分为5 大类覆盖流程内临时数据、会话持久数据、全局共享数据、存储层持久数据节点局部变量单节点内临时变量流程链路变量节点间传递、循环迭代项共享全局变量全工作流生命周期公共变量上行文会话记忆变量对话上下文持久持久存储变量RAG 知识库 / 关系数据库 / 文件系统二、分类型Coze 变量 ↔ 传统编程变量一一映射1. 节点局部变量代码节点内自定义变量Coze 定义仅在「代码节点」Python 脚本内定义生命周期仅限当前代码块执行完毕外部节点无法直接读取python运行# Coze代码节点内部 name 测试文本 # 节点局部变量 num 100传统编程对应函数内部局部变量local variablepython运行def run(): name 测试文本 # 函数局部变量函数执行完销毁生命周期代码节点执行完成即销毁仅当前脚本可用。2. 流程链路变量最常用节点输出、循环项、输入参数包含三类子变量输入节点入参流程入口参数普通节点输出变量大模型、插件、数据库、IF 选择器输出结果循环迭代变量循环内当前项item、下标index、循环结果数组Coze 特性作用域整条工作流可见上下游节点可互相引用传递方式节点连线自动透传可视化拖拽绑定循环迭代项每次循环自动生成临时 item一轮结束刷新。传统编程对应输入节点参数 函数形参入参python运行def workflow(user_input): # user_input 对应输入节点变量普通节点输出 函数返回值、中间临时全局变量python运行llm_result llm_call(user_input) # llm_result 对应大模型输出变量循环 item for 循环迭代变量python运行for item in data_list: # item 等价Coze循环内部当前项变量生命周期单次工作流执行周期内有效流程结束自动销毁。3. 共享全局变量架构图底部共享全局变量Coze 定义整个工作流所有分支、所有节点、循环内外均可读写的公共变量跨分支共享数据 无需节点连线直接全局读取 / 覆写。传统编程对应模块级全局变量global varpython运行# 全局变量所有函数均可访问 global total_count total_count 0 def add(): global total_count total_count 1生命周期单次工作流执行全程有效流程结束清空。4. 上行文会话记忆变量架构图底部上行文Coze 定义会话级持久变量多轮对话自动保存历史问答、关键上下文 属于跨流程调用持久变量同用户同会话多次调用工作流均可读取 支持自动摘要压缩控制 Token 消耗。传统编程对应会话缓存Redis 会话存储 / Session 对象Web 开发HttpSession后端对话服务Redis 存储 user_id 绑定的对话历史python运行# 后端会话存储示例 session_key fchat_{user_id} # 读取历史对话 history redis.get(session_key) # 更新对话 redis.set(session_key, new_history, expire3600)生命周期用户会话有效期内持久保存不受单次工作流执行结束影响。5. 持久层存储变量RAG 知识库 / 关系数据库 / 文件系统Coze 定义永久落盘存储独立于工作流会话可跨用户、跨工作流读写关系数据库结构化字段变量表单、对话记录RAG 知识库向量化文本片段文档知识文件系统媒体二进制资源图片 / 视频链接传统编程对应数据库表、文件、向量库持久化存储python运行# 关系数据库存储 sql INSERT INTO chat_log(user, content) VALUES (?, ?) db.execute(sql, user, content) # 向量知识库存储 vector_db.add(text, embedding)生命周期永久持久手动删除才会销毁。三、Coze 「节点变量」细分详解你提问重点1. 普通节点输出变量所有功能节点通用每一个拖拽节点执行完成后都会生成专属输出变量大模型节点content大模型回答、token消耗、结构化 json插件视频生成video_url、封面图、任务状态IF 选择器分支匹配标记、分支内输出数据数据库查询多行数据数组、单条记录对象变量聚合整合后的统一结构体变量对应传统代码每个独立函数的 return 返回值。python运行def call_llm(prompt): return {content: 回答文本, token: 120} llm_out call_llm(prompt) # llm_out Coze大模型节点输出变量2. 循环节点内置专属变量循环内部自动生成 3 个内置变量仅循环子流程内可见item当前遍历数组的单条元素index当前循环下标从 0 开始loop_result已完成轮次的结果数组用于累加汇总对应传统代码for 循环内置迭代变量python运行data [A,B,C] loop_result [] for index, item in enumerate(data): res sub_func(item) loop_result.append(res)3. 代码节点局部变量仅 Python 脚本内可用无法直接给外部节点使用需要通过「代码节点输出字段」中转暴露给流程。python运行# 代码内部局部变量 temp_text 临时数据 # 输出到流程全局链路变量供下游读取 return {output_text: temp_text}对应传统代码函数内局部变量return 后外部才能获取。四、核心对照表一站式汇总表格Coze 变量类型作用域 生命周期传统编程等价概念代码节点内部局部变量仅当前代码块执行完销毁函数内局部变量 local节点输出变量大模型 / 插件 / 数据库等整条工作流单次执行有效函数返回值、中间临时变量循环内置 item/index 变量仅循环子流程内单轮刷新for 循环迭代变量输入节点入参变量整条工作流全局可见函数入参 args/params共享全局变量全工作流所有分支共享单次流程生命周期模块全局 global 变量上行文会话记忆同用户会话跨多次工作流调用持久Web Session / Redis 会话缓存数据库 / 知识库持久数据永久落盘跨会话、跨工作流MySQL / 向量库持久存储数据五、关键差异补充低代码变量 vs 传统代码变量可视化绑定替代代码赋值传统编程var_a func_return()文本赋值 Coze可视化下拉选择上游节点输出自动完成变量引用无需手写赋值语句。变量类型自动识别Coze 自动区分文本、数字、数组、对象、媒体链接无需手动声明类型传统静态语言需要定义变量类型。分层存储自动封装传统开发需要手动写 Redis、数据库、向量库读写逻辑Coze 通过专用节点读写持久变量屏蔽底层存储 SDK。会话变量原生内置传统程序需要自行实现会话缓存Coze 上行文记忆是平台原生能力自动维护多轮上下文变量。