全部产品
Search
文档中心

无影云手机:ModifyScheduledTask - 修改智能体定时任务

更新时间:Aug 06, 2026

修改智能体定时任务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

ScheduledId

string

是

定时任务 ID。

sch-260705-agb*****

TaskVersion

integer

是

CAS 版本号。

1

TaskName

string

否

任务名称。

新任务名称

UserPrompt

string

否

用户提示词。

执行每日数据同步任务

CronExpression

string

否

Cron 表达式。

0 30 * * *

InstanceIds

array

否

实例 ID 列表。

["acp-5hh431emkt6u*****"]

string

否

云手机实例 ID 列表,当前最大支持关联 3 个实例。

acp-5hh431emkt6u*****

Status

string

否

状态切换:ACTIVE/DISABLED。

ACTIVE

RunConfig

object

否

运行配置。

{"maxSteps":10,"timeoutSeconds":3600}

Skills

array

否

技能 ID 列表,最多 1 个;修改后覆盖写入 aim_task_config.run_config

["sk-abc"]

string

否

MaxSteps

integer

否

最大执行步数。

10

TimeoutSeconds

integer

否

超时秒数。

3600

ExtraParams

string

否

扩展参数 JSON 字符串。

{"batchSize":"1000"}

返回参数

名称

类型

描述

示例值

object

ApiResponse

RequestId

string

请求 ID。

9A51B1DF-96FF-3BCC-B08C-783161D3****

Code

string

接口状态码。

200

Message

string

接口返回信息。

Success.

TotalCount

integer

总记录数。

1

Tasks

array<object>

修改结果列表。

array<object>

任务。

ScheduledId

string

定时任务 ID。

sch-260705-agbx*****

NewVersion

integer

更新后 CAS 版本号。

2

InstanceResults

array<object>

实例定时任务批量下发结果列表。

object

实例定时任务下发结果详请。

InstanceId

string

实例 ID。

acp-4dkmkip0l0uw*****

Success

boolean

是否成功。

true

ErrorMessage

string

错误信息。

Instance not found.

示例

正常返回示例

JSON格式

{
  "RequestId": "9A51B1DF-96FF-3BCC-B08C-783161D3****",
  "Code": "200",
  "Message": "Success.",
  "TotalCount": 1,
  "Tasks": [
    {
      "ScheduledId": "sch-260705-agbx*****",
      "NewVersion": 2,
      "InstanceResults": [
        {
          "InstanceId": "acp-4dkmkip0l0uw*****",
          "Success": true,
          "ErrorMessage": "Instance not found."
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。