全部产品
Search
文档中心

无影云手机:DescribeAgentTask - 查询 Agent 任务详细信息。

更新时间:Jul 13, 2026

查询Agent Task的相关信息。

调试

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

调试

授权信息

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

请求语法

GET  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

TaskIds

array

任务 ID 列表。

string

任务 ID。

t-bp67acfmxazb4p****

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

310A783E-CC46-5452-A8A3-71AE5DB5****

Code

string

接口状态码。

For example, "200" indicates success.

Message

string

接口返回信息。

Success.

Count

integer

任务数量。

1

Tasks

array<object>

任务 list。

object

任务。

TaskId

string

任务 ID,全局唯一。

t-imr0fufqd7cle****

InstanceId

string

Mobile 节点 ID。

acp-anzzuho371azi44xr

UserPrompt

string

用户指令(自然语言),Agent 据此完成操作。

Download DingTalk from App Store

CurrentStatus

string

任务当前状态,参考下方状态枚举,取值如下:

PENDING 任务创建中。

RUNNING 任务运行中。

COMPLETED 任务已完成。

FAILED 任务失败。

TIMEOUT 任务执行超时。

COMPLETED

RunningAt

string

任务创建时间,ISO 8601 格式。

2026-04-13T17:42:19Z

Steps

string

执行的步骤数。

30

TaskResult

string

任务结果(终态),只有 CurrentStatus=COMPLETED/FAILED 时有该字段。

Download DingTalk succeeded.

TaskDuration

string

任务耗时,CurrentStatus=FAILED/COMPLETED 时有该字段。

50

TaskDigest

string

DigestSource

string

Reason

string

示例

正常返回示例

JSON格式

{
  "RequestId": "310A783E-CC46-5452-A8A3-71AE5DB5****",
  "Code": "For example, \"200\" indicates success.",
  "Message": "Success.",
  "Count": 1,
  "Tasks": [
    {
      "TaskId": "t-imr0fufqd7cle****",
      "InstanceId": "acp-anzzuho371azi44xr",
      "UserPrompt": "Download DingTalk from App Store",
      "CurrentStatus": "COMPLETED",
      "RunningAt": "2026-04-13T17:42:19Z",
      "Steps": "30",
      "TaskResult": "Download DingTalk succeeded.",
      "TaskDuration": "50",
      "TaskDigest": "",
      "DigestSource": "",
      "Reason": ""
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情