DescribeAgentTask - Cloud Phone - Alibaba Cloud Documentation Center

Queries information about Agent Tasks.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
TaskIds	array	No	The list of task IDs.
	string	No	The task ID.	t-bp67acfmxazb4p****

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	The request ID.	310A783E-CC46-5452-A8A3-71AE5DB5****
Code	string	The API status code.	For example, "200" indicates success.
Message	string	The response message.	Success.
Count	integer	The number of tasks.	1
Tasks	array<object>	The list of tasks.
	array<object>	The task.
TaskId	string	The task ID, which is globally unique.	t-imr0fufqd7cle****
InstanceId	string	The Mobile node ID.	acp-anzzuho371azi44xr
UserPrompt	string	The user instruction in natural language. The Agent performs operations based on this instruction.	Download DingTalk from App Store
CurrentStatus	string	The current status of the task. Valid values: PENDING: The task is being created. RUNNING: The task is running. COMPLETED: The task is completed. FAILED: The task failed. TIMEOUT: The task execution timed out.	COMPLETED
RunningAt	string	The time when the task was created, in ISO 8601 format.	2026-04-13T17:42:19Z
Steps	string	The number of steps executed.	30
TaskResult	string	The task result in the desired state. This field is returned only when CurrentStatus is COMPLETED or FAILED.	Download DingTalk succeeded.
TaskDuration	string	The task duration. This field is returned only when CurrentStatus is FAILED or COMPLETED.	50
TaskDigest	string	The task digest text, up to 25 characters.
DigestSource	string	The source of the digest. Valid values: PROMPT_AUTO: auto-generated. RESULT_AUTO: result refinement. USER: user-edited.
Reason	string
ArtifactCount	integer	The number of task artifacts.	2
Artifacts	array<object>	The list of uploaded task artifacts.
	object	The artifact information.
Name	string	The file name.	screenshot.png
Size	integer	The file size in bytes.	1024
ContentType	string	The MIME type.	image/png
DownloadUrl	string	The OSS pre-signed download URL.	https://bucket.oss-cn-hangzhou.aliyuncs.com/...
UpdatedTime	string	The upload time in ISO 8601 format.	2026-08-05T10:00:00+08:00

Examples

Success response

JSON format

{
  "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": "",
      "ArtifactCount": 2,
      "Artifacts": [
        {
          "Name": "screenshot.png",
          "Size": 1024,
          "ContentType": "image/png",
          "DownloadUrl": "https://bucket.oss-cn-hangzhou.aliyuncs.com/...",
          "UpdatedTime": "2026-08-05T10:00:00+08:00"
        }
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.