创建一条可复用的 MUA ChainRun 编排资产，在自动化任务中可以引用并执行。

ChainRun：是 MUA 的一种运行模式，通过工作流编排的“链式”方式执行，即按顺序串联多个脚本或步骤依次运行，适合需要分阶段、多步骤完成的自动化流程。

使用说明

调用 MUA OpenAPI 前，必须先访问跨服务访问请求为您的账号授权。

注意事项

创建成功后，您可以调用一键运行代理任务 RunAgentTaskOneStep 或运行代理任务 RunAgentTask 接口，通过 RunMode=ChainRun，同时传 ChainId=<创建接口返回的编排资产 ID> 来引用编排资产。

本接口整体 QPS 限制为 50 次/秒、单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流。

请求说明

请求方式：POST

请求地址：https://open.volcengineapi.com?Action=CreateAgentRunChain&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Header

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/json	请求头信息。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	CreateAgentRunChain	接口名称。当前 API 的名称为 CreateAgentRunChain。
Version	String	是	2023-08-01	接口版本。当前 API 的版本为 2023-08-01。

Body

参数	类型	是否必选	示例值	描述
Name	String	是	login-check	编排资产的名称，长度为 1～128 个字符。
Nodes	Array	是	[{"Type":"ScriptRun","ScriptRunId":123}]	编排节点数组，数组长度为 1～100，支持通过 ChainRunId 引用其他编排资产，引用展开后节点总数不超过 100 个，所有 ScriptRun 节点的有效操作指令总数不超过 500 行。数据结构请参见 Nodes。
AgentType	String	否	mua	编排资产的类型，取值： mua：（默认）MUA 智能体的编排资产类型。 cua：CUA 智能体的编排资产类型。
Description	String	否	登录后检查结果	编排资产的说明，长度为 0～2048 个字符。不传或传入空字符串时，表示不填写说明。
Status	Integer	否	1	编排资产的启用状态，取值： 0：禁用。 1：（默认）启用。

Nodes

参数	类型	是否必选	示例值	描述
Id	String	否	open	节点标识，在排查问题时可以定位具体节点。
Type	String	条件必选	ScriptRun	节点类型，取值： AgentRun：根据任务目标自主规划执行。 ScriptRun：按固定脚本顺序执行。 ChainRun：引用指定编排资产，按其节点顺序执行。注意当传入 ScriptRunId 或 ChainRunId 时，无需传入本参数。
Script	String	条件必选	tap(500, 800)\nwait(2)	ScriptRun 节点的脚本内容，大小不超过 100 KB，有效操作指令计入编排总限制（不超过 500 行）。注意仅 Type 为 ScriptRun 时支持设置此参数。 ScriptRunId 与 Script 两者必须传其一，不可以同时传入或同时不传。
ScriptRunId	Long	条件必选	1001	ScriptRun 节点引用的脚本资产 ID，引用的脚本资产须已存在。您可以通过 ListAgentRunScript 接口获取。注意仅 Type 为 ScriptRun 时支持设置此参数。 ScriptRunId 与 Script 两者必须传其一，不可以同时传入或同时不传。
ChainRunId	Long	条件必选	2001	ChainRun 节点引用的编排资产 ID，引用的编排资产须已存在。您可以通过 ListAgentRunChain 接口获取。注意仅 Type 为 ChainRun 时支持设置此参数。传入 ChainRunId 时不可同时传入 Nodes。
UserPrompt	String	条件必选	检查是否登录成功	用户提示词，长度上限为 10000 字节。若内容以中文为主，建议控制在 3000 字以内。注意仅 Type 为 AgentRun 时必填。
Resolution	String	否	1920x1080	编排资产的屏幕分辨率，格式为宽x高，宽和高的取值范围均为 1～16384。默认为空，表示不设置屏幕分辨率。注意仅 Type 为 ScriptRun 时支持设置此参数。
SystemPrompt	String	否	你是质检助手	AgentRun 节点的系统提示词，默认为空表示不传入系统提示词。
MaxOutputTokens	Integer	否	1024	AgentRun 节点的 MUA 单次生成回复允许输出的最大 Token 数量，取值：取值范围：0～65526，超出后回复将被截断。 0：（默认）不限制。
OutputSchema	Object	否	{"type":"object"}	AgentRun 节点的输出格式。JSON 字符串形式，详细结构请参见通用数据结构中的 OutputSchema。注意仅支持在最后一个 AgentRun 节点上使用。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返写·回结构。

参数	类型	示例值	描述
ChainId	Long	2001	编排资产的 ID。
AgentType	String	mua	编排资产的类型，取值： mua：MUA 智能体的编排资产类型。 cua：CUA 智能体的编排资产类型。
Name	String	login-check	编排资产的名称。
Description	String	登录后检查结果	编排资产的说明。
Nodes	Array	[]	节点数组，字段说明请见 Nodes。
Status	Integer	1	编排资产的启用状态，取值： 0：禁用。 1：启用。
CreatedAt	Long	1785738000	编排资产的创建时间，Unix 时间戳，单位为秒。
UpdatedAt	Long	1785739000	编排资产的更新时间，Unix 时间戳，单位为秒。

请求示例

返回示例

错误码

MUA OpenAPI 错误码请参见错误码。

云手机