代码-j9九游会登录

代码节点是工作流中用于执行自定义代码逻辑的节点。当工作流中需要进行数据处理、格式转换、数学计算、逻辑判断等操作，而这些操作用其他节点难以实现或用大模型处理不够准确时，可以通过代码节点编写代码来完成。代码执行的结果是确定的，相同的输入必然得到相同的输出。对于计算、格式转换等任务，代码比大模型更准确、更快、且不消耗token。

代码节点在平台托管的沙箱环境中执行，代码运行时受到超时时间限制（默认900秒，最小0.1秒），且无法访问本地文件系统。支持的库范围见下方python 3.9代码要求。

数据流转过程：上游节点输出 → 输入参数映射 → args字典传入main函数 → 代码处理 → return字典 → 输出参数映射 → 下游节点获取。

代码节点的典型使用场景如下：

表1 代码节点使用场景
场景	示例
数据格式转换	将上游节点返回的json数据提取、重组为下游节点需要的格式。
数学计算	价格计算、折扣计算、数据汇总统计等。
文本处理	正则匹配、字符串拼接、内容截取、编码转换等。
逻辑判断	复杂的条件判断、数据校验、规则匹配等。
数据清洗	去重、过滤、排序、字段映射等。

不推荐使用代码节点的场景：

需要安装使用不支持的外部第三方库（详见python 3.9代码要求）。
需要长时间运行（超过900秒最大超时限制）。
需要持久化存储状态或访问本地文件系统。

节点选型对比：

当工作流中存在多种节点可实现类似功能时，可参考以下对比进行选型：

表2 节点选型对比
决策维度	代码节点	大模型节点	条件判断节点
执行确定性	确定执行，相同输入相同输出	可能产生不同输出	确定执行
适合任务类型	数据处理、数学计算、格式转换	文本生成、语义理解、内容创作	简单条件分支
token消耗	不消耗token	消耗token	不消耗token
灵活性	高（可编写任意代码逻辑）	中（依赖prompt设计）	低（仅支持条件分支）

选型建议：

如果你的场景是精确的数学计算或数据格式转换，推荐使用代码节点。
如果你的场景是需要语义理解或内容生成，推荐使用大模型节点。
如果你的场景是简单的条件判断（如a>b），推荐使用条件判断节点；如果条件逻辑复杂（如多条件组合、正则匹配），推荐使用代码节点。

配置代码节点

代码节点的配置参数说明如下：

表3 代码节点配置参数
参数	说明
输入参数	输入参数用于声明代码中所使用的输入变量，每个输入参数需要和代码中定义的参数保持一致。参数值可以直接填写一个固定的值，也可以选择引用工作流中上游节点的输出和全局配置的记忆变量。描述：（可选）用于说明该输入参数的具体含义。
输出参数	输出参数用于定义代码执行完成后向下游传递哪些数据，输出参数的名称和类型必须与代码中返回的键值对严格对应，否则下游节点将无法获取到对应的值。描述：（可选）用于说明该输出参数的具体含义。
代码	编写代码时不要更改第一行函数定义。编写python代码片段，仅支持python系统库；代码配置示例请参考python 3.9代码要求。在代码编辑器的顶部支持选择大模型，智能优化代码。同时支持自动折行、复制和全屏显示、实时代码低错检测（如缺少冒号、多余逗号、缩进等）等功能。
异常处理	支持对节点的异常（如超时、调用失败等情况）进行处理，包括超时时间、重试次数、异常处理方式。 “超时时间”：支持用户配置超时时间，取值范围0.1~900，默认900s。 “重试次数”：支持配置重试次数（不重试、重试1次、重试2次、重试3次），系统默认不重试。 “异常处理方式”：配置异常处理方式。中断流程：节点发生异常后，直接中断流程，不再运行后续节点。返回设定内容：节点发生异常后，工作流不会中断，用户可自定义设置需要返回的输出字段内容，必须是输出参数中已定义的字段，且格式为合法的json格式。执行异常流程：节点发生异常后，工作流不会中断，而是会执行异常处理流程。用户可以在该运行异常的节点后新增节点，并为新增的异常分支配置相应的处理流程。

python 3.9代码要求

支持python 3.9版本及其标准库，并支持如下的非标准库，可直接在python函数代码中声明使用。

表4 python运行时集成的非标准库
模块	功能	版本号
dateutil	日期/时间处理	2.6.0
httplib2	httpclient	0.10.3
numpy	数学计算	1.13.1
redis	redis客户端	2.10.5
obsclient	obs客户端	-
smnsdk	访问smn服务	1.0.1

示例如下：

def main(args: dict) -> dict:
    """
    运行代码节点会调用此函数，请勿对下面的函数名做修改
    :param args: 输入固定为args字典类型，kv为输入参数键值对
    :return: 输出参数为字典类型，kv为输出参数键值对
    """
    ret = {
        "key0": args.get('input', 'default'),
        "key1": "hi"
    }
    return ret

平台通过固定的main函数触发代码执行，函数名不可修改。
输入参数args是一个字典（dict），包含了在代码节点界面配置的所有输入参数，以参数名为key、参数值为value的键值对形式传入。通过args.get('参数名', '默认值') 读取，建议始终设置默认值，避免参数缺失时报错。
返回值是一个字典（dict），直接return即可，无需做json转换。返回字典中的key必须与代码节点界面配置的“输出参数”名称完全一致（区分大小写），否则下游节点将无法获取到对应的值。
在代码节点界面的“输出参数”区域配置的参数名，必须与代码return字典中的key对应。

编写约束：

入口函数名必须是main，接收一个dict参数，返回一个dict
直接返回字典即可，无需json.dumps()转换
即使只有一个输出字段，也必须以字典形式返回
 ×  return "hello"
 √  return {"message": "hello"}

不支持的命令：
系统命令执行：system、popen、subprocess、startfile、execl、spawn。

网络请求命令：requests、urllib、httpx、aiohttp、socket、socks。

动态代码执行：eval、exec、compile、importlib、__import__、execfile。

序列化/反序列化：pickle、marshal、yaml、shelve。

文件操作：open、remove、rename、shutil、listdir、tempfile、glob、unlink。

其他：torch、environ、functools、ast。

验证代码节点配置

代码节点配置完成后，建议通过以下步骤验证配置是否正确：

单击节点中的测试图标，在测试面板中为每个输入参数填写测试值，单击“开始运行”。等待输出结果，确认各输出参数的值和类型与配置一致。

验证通过的标准：输出参数的名称、类型和值均与预期一致，且无语法错误或运行时异常。

图1 验证代码节点配置
点击放大

常见问题

代码执行后报syntaxerror
python代码的常见语法问题包括：缩进不统一（混用了空格和tab）、括号或引号未成对闭合、中英文符号混用（如使用了中文冒号：或中文括号（））。
import第三方库报modulenotfounderror
默认情况下仅支持内置标准库，不支持安装和使用第三方库。
下游节点获取不到代码节点的输出值
最常见的原因是输出区域配置的参数名与代码return中的key不一致。两者必须完全匹配，包括大小写。例如代码返回了totalprice，输出区域配置成totalprice就会取不到值。
下游节点获取到的值类型与预期不符
检查输出区域配置的参数类型是否与代码实际返回的数据类型一致。例如代码返回了数字100，但输出参数类型配置为string，下游节点拿到的就是字符串"100"而非数字。

父主题：

上一篇：判断

下一篇：循环

意见反馈

文档内容是否对您有帮助？

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨