动作流程控制-流程控制

流程控制

动作流程控制 / 流程控制 类动作。

等待

wait_seconds

动作流程控制流程控制

用途:等待指定秒数,支持运行时暂停和停止。

写法:等待 [等待秒数=<等待秒数>]

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

等待 1

# 说明:暂停 1 秒后继续执行

错误示例

等待 等待秒数=1 错误参数=1

为什么错:使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
等待秒数seconds未提供说明1

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

暂停动作流

pause_script

动作流程控制流程控制

用途:暂停当前动作流,直到客户端恢复。

写法:暂停动作流

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

暂停动作流

错误示例

暂停动作流 错误参数=1

为什么错:使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

终止动作流

stop_script

动作流程控制流程控制

用途:终止当前动作流。

写法:终止动作流 [终止原因=<终止原因>]

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

终止动作流 终止原因="示例值"

错误示例

终止动作流 终止原因="示例值" 错误参数=1

为什么错:使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
终止原因reason未提供说明程序结束

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

执行动作流脚本

execute_action_flow_script

动作流程控制流程控制

用途:按动作流目录里的相对路径执行 .txt、.jy 或 .json 动作流脚本。

写法:执行动作流脚本 动作流路径=<动作流路径> [输入参数=<输入参数>]

动作流文件用法

怎么用:在动作流文件内部写 执行动作流脚本 动作流路径="a.jy",也可以写子目录路径,例如 执行动作流脚本 动作流路径="a/a.jy"。子文件调用同级或下级文件时,路径相对于当前文件目录解析。

不支持:不能写绝对路径,也不能通过 ../../ 越出入口文件或动作流根目录;API/MCP 调用不要通过 /actions/run 组装 execute_action_flow_script,应使用 /action-flows/runscript_path 模式。

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

执行动作流脚本 动作流路径="a.jy"

错误示例

执行动作流脚本 动作流路径="outside/a.jy"

为什么错:脚本路径必须是相对于入口文件或动作流根目录的相对路径,不能填写绝对路径。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
动作流路径script_path未提供说明
输入参数input_args未提供说明

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果未声明未提供说明
脚本路径string未提供说明
脚本名称string未提供说明
脚本类型string未提供说明
脚本说明string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

执行Python脚本

execute_python_script

动作流程控制流程控制

用途:按动作流目录里的相对路径执行 .py Python 脚本。脚本可通过顶层变量 脚本结果 返回内容。

写法:执行Python脚本 脚本路径=<脚本路径> [输入参数=<输入参数>]

Python 脚本文件用法

怎么用:执行Python脚本 脚本路径="a.py"执行Python脚本 脚本路径="sub/a.py",输入参数通过 input_args 或动作参数传入。

不支持:不能写绝对路径、不能越出入口文件或脚本根目录,不能把 Python 模块写法中的 module_path 当作参数;需要指定入口函数或调用模块时,应使用“执行Python模块”。

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

执行Python脚本 脚本路径="a.py"

错误示例

执行Python脚本 脚本路径="outside/a.py"

为什么错:脚本路径必须是相对于入口文件或脚本根目录的相对路径,不能填写绝对路径。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
脚本路径script_path未提供说明
输入参数input_args未提供说明

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果未声明未提供说明
脚本路径string未提供说明
脚本名称string未提供说明
脚本类型string未提供说明
脚本说明string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

执行Python模块

execute_python_module

动作流程控制流程控制

用途:加载 .py、.pyd 模块或 Python 包,并调用指定入口函数。入口函数默认按 main(context, input_context) 接收参数;模块可通过 context.actions 调用已注册原生 action。未指定模块路径时,从当前目录 py_modules 中按入口函数选择模块,未指定模块名时使用 main.py。

写法:执行Python模块 [模块路径=<模块路径>] [入口函数=<入口函数>] [输入参数=<输入参数>]

Python 模块用法

怎么用:完整动作只写 模块路径,例如 执行Python模块 模块路径="tools.py" 入口函数="main"模块路径相对于当前执行文件目录;省略时使用当前目录下的 py_modules,入口不带模块名时默认加载 main.py

包规则:目录有 __init__.py 时按普通包加载,没有时按命名空间包加载;入口函数需要按约定接收上下文和输入参数。

不支持:不能写绝对路径或越出允许目录;py: 简写只使用 py路径 作为路径参数名。

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

执行Python模块 模块路径="calculator.py" 入口函数="计算二次方" 参数一=3 参数二=4

# 说明:调用当前动作流目录中的模块函数

错误示例

执行Python模块 模块路径="outside/a.py"

为什么错:模块路径必须是允许目录下的相对路径,不能填写绝对路径。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
模块路径module_path未提供说明""
入口函数entrypoint未提供说明main
输入参数input_args未提供说明

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果未声明未提供说明
脚本路径string未提供说明
脚本名称string未提供说明
脚本类型string未提供说明
脚本说明string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。