节点功能
代码节点属于信息处理类节点,腾讯云智能体开发平台支持在代码节点内部使用 IDE,支持用户编写 Python 代码(系统内置了 NumPy 等常用 Python 包)处理业务逻辑,返回响应结果。例如处理数据转换、科学计算等。


操作说明
输入变量
输入变量仅在该节点内部生效,不能跨节点使用。支持最多添加50个输入变量,满足多输入变量场景需要。点击添加,进行如下配置添加输入变量。
配置 | 说明 |
变量名称 | 该变量的名称,只能包含字母、数字或下划线,并且以字母或下划线开头,必填 |
变量描述 | 该变量的说明信息,非必填 |
数据来源 | 该变量的数据来源,支持“引用”“输入”两种选项。“引用”可选择前序所有节点的输出变量,“输入”可手动填入固定值,必填 |
变量类型 | 该变量的数据类型,不可选择,默认为引用的变量类型或输入的 string 类型 |
代码
点击编辑代码即可展开系统内置的 Python 代码编辑器。
编辑代码时,请保存函数名为 main,输入输出均为 dict,可通过 params.get('input') 调用输入变量;最终结果会以 JSON 字符串方式返回,勿直接返回不支持 json.dumps 的对象。
编辑代码后,支持在输入测试框中填写该节点的输入变量进行调试,单击运行执行代码,响应结果在输出结果框中查看。
代码执行器内置的 Python 包如下。
包名 | 版本 | 说明 |
python | >= 3.9, < 3.13 | 指定 Python 运行环境的版本范围,确保项目兼容性。 |
ipykernel | ^ 6.29.4 | 为 Jupyter Notebook/Lab 提供 Python 内核支持。 |
pydantic | 2.8.2 | 用于定义数据模型并自动验证输入数据,常用于 API 请求体校验。 |
python-dotenv | >= 1.0.0 | 加载 .env 文件中的环境变量。 |
jinja2 | >= 3.0.0 | 一个强大的模板引擎,用来生成 HTML 或配置文件。 |
aiohttp-jinja2 | >= 1.0 | 把 Jinja2 模板集成到 aiohttp Web 框架中,生成动态页面。 |
pyzmq | >= 25.0.0 | ZeroMQ 的 Python 接口,用于高性能分布式消息通信。 |
fastapi | >= 0.110.0 | 高性能 Web API 框架,常用于快速开发 RESTful/GraphQL 服务。 |
uvicorn | >= 0.30.0 | 运行 FastAPI 的 ASGI 服务器,支持异步高并发。 |
python-multipart | >= 0.0.9 | 处理 HTTP 表单和文件上传的解析器。 |
fastapi-utilities | >= 0.2.0 | 给 FastAPI 提供额外工具(如后台任务调度、依赖管理)。 |
uhashring | ^ 2.3 | 一致性哈希算法库,用于分布式缓存/存储系统的节点选择。 |
psutil | >= 6.0.0 | 获取系统运行状态(CPU、内存、磁盘、网络),常用于监控。 |
nbformat | >= 5.0.0 | 读写 Jupyter Notebook (.ipynb) 文件。 |
nbclient | >= 0.10.0 | 在代码中自动执行 Jupyter Notebook 并收集结果。 |
xlsxwriter | ^ 1.3.7 | 生成 Excel 文件(带格式、图表等),常用于报表导出。 |
sseclient-py | >= 1.8.0 | 监听服务端事件(SSE),实现实时消息推送。 |
python-prctl | >= 1.8.1 | 控制 Linux 进程属性(如名字、能力),多用于系统级应用。 |
prometheus_client | ^ 0.21.0 | 导出应用监控指标,供 Prometheus 收集和展示。 |
flask | ^ 3.0.0 | 轻量级 Web 框架,适合快速开发小型网站和 API。 |
numpy | 1.26.4 | 数值计算库,提供高效的多维数组运算,科学计算基础。 |
sympy | 1.13.3 | 符号计算库,可以做代数运算、方程求解、符号微积分。 |
levenshtein | 0.25.0 | 计算字符串相似度(编辑距离),常用于模糊匹配。 |
cryptography | 43.0.0 | 提供加密、解密、签名等密码学功能。 |
thefuzz | 0.22.1 | 字符串模糊匹配工具,常用于搜索或数据清洗。 |
branca | 0.8.1 | 生成 HTML/JS 组件,常配合 Folium 做地图可视化。 |
folium | 0.19.4 | 用 Python 生成交互式地图(基于 Leaflet.js)。 |
basemap | 1.4.1 | 在 matplotlib 上绘制地图,常用于地理可视化。 |
basemap-data | 1.3.2 | Basemap 需要的地理数据文件。 |
pyecharts | 2.0.8 | 用 Python 生成 ECharts 图表,支持交互式可视化。 |
tencentcloud-dlc-connector | ^ 1.2.1 | 连接腾讯云 DLC(Data Lake Compute)的 SDK。 |
python-pptx | ^ 1.0.2 | 生成和修改 PowerPoint 文件,常用于自动化报告。 |
clickhouse-driver | ^ 0.2.9 | ClickHouse 数据库的 Python 客户端。 |
openai | >= 1.0.0 | 调用 OpenAI API(如 GPT、DALL·E 等)的官方库。 |
requests | >= 2.30.0 | 最常用的 HTTP 请求库,用于调用 Web API。 |
urllib3 | >= 2.0.0 | 底层 HTTP 库,requests 的核心依赖。 |
pandas | 1.5.3 | 提供 DataFrame 表格结构,适合数据清洗和分析。 |
pyyaml | >= 6.0.0 | 读取和写入 YAML 配置文件。 |
click | >= 8.0.0 | 快速编写命令行工具的库。 |
cycler | >= 0.12.0 | 生成样式循环(颜色、线型),matplotlib 的依赖。 |
xlrd | >= 2.0.0 | 读取 Excel 文件(主要是 .xls 格式)。 |
openpyxl | >= 3.0.0 | 读写 .xlsx Excel 文件,pandas 的依赖。 |
tabulate | >= 0.9.0 | 把表格数据渲染为 Markdown/HTML/纯文本表格。 |
matplotlib | 3.4.3 | Python 最基础的绘图库,支持多种图表。 |
seaborn | ^ 0.13.2 | 在 matplotlib 上封装的高级统计绘图库,绘图更美观。 |
scikit-learn | ^ 1.5.0 | 机器学习库,提供分类、回归、聚类、降维等算法。 |
输出变量
经该节点处理后的输出变量,默认为空,支持用户手动添加输出变量,或者在代码运行结果中通过[x]解析到输出变量功能自动填写到输出变量。同时包含运行时报错信息 Error(数据类型为 object,正常运行时该字段为空)。


异常处理
可手动开启异常处理,支持异常重试和异常情况的输出内容配置。配置内容如下。
配置 | 说明 |
最大重试次数 | 节点运行异常时重新运行的最大次数。重试超过设定次数,认为该节点调用失败,返回“异常情况的输出变量”内容,默认为3次 |
重试时间间隔 | 每次重新运行的时间间隔,默认为1秒 |
异常处理方式 | 支持“输出特定内容”和“执行异常流程”两种 |
异常情况的输出变量 | 选择异常处理方式为“输出特定内容”时,超过最大重试次数后节点返回的输出变量 |


选择异常处理方式为“执行异常流程”时,则节点异常重试后执行用户自定义的异常处理流程。


应用示例
根据用户输入的文章主题与风格撰写文章,通过代码节点将大模型节点生成的大纲拆分为每一章标题和内容摘要的数组。


代码节点配置如下:

