UpdateEvaluationTask-AgentLoop(AgentLoop)-阿里云帮助中心

Updates an evaluation task.

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

PUT /api/v1/evaluation-task/{agentSpace}/{taskId} HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
agentSpace	string	No	The AgentSpace name.	prod-agentspace
taskId	string	No	The evaluation task ID.	eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request body.	{"dataFilter":{"query":"serviceName='checkout-service' AND status='OK'","maxRecords":10},"runStrategies":{"continuous":{"enabled":true,"intervalUnit":"HOUR","intervalValue":1,"dataDelayMinutes":5}}}
dataFilter	string	No	The filter condition for evaluation data. A JSON object or JSON string is supported.	{"query":"serviceName='checkout-service' AND status='OK'","maxRecords":10,"samplingRate":50}
evaluators	array	No	The new list of evaluator configurations. When specified, this list entirely replaces the existing evaluator list of the task, and the system re-validates evaluator uniqueness and variable mappings.	[{"evaluatorRef":"Builtin.agent_task_completion","resultName":"agent_task_completion","resultType":"score","variableMapping":{"input":"trace.input","output":"trace.output","agent_trajectory":"trace.agent_trajectory"}}]
	Evaluator	No	A single evaluator configuration object.
status	string	No	The task status. Currently the backend only allows users to explicitly set this to `Terminated`. Other statuses are managed by the system. Valid values: Terminated : Terminated	Terminated
tags	object	No	The key-value pairs of task tags. You do not need to specify this parameter by default. Specify this parameter only when you want to associate or filter tasks by business tags.	{"env":"prod","serviceId":"checkout-service","planId":"plan-20260703"}
	string	No	The value of a single task tag. The key name is customized based on business dimensions.	prod
config	object	No	The new task configuration. Some fields that are set during creation cannot be modified.	{"dataScope":"trace"}
	string	No	The value of a single configuration item. The key name is determined by the specific field conventions.	trace
runStrategies	RunStrategies	No	The new task execution strategies. A JSON object or JSON string is supported. If the task is in `Completed`, `Terminated`, or `Failed` status and the new strategy enables backfill or continuous mode, the backend resets the task to `Pending` and triggers orchestration.
description	string	No	The description of the evaluation task.	更新后的链路 Trace 任务完成度评估
clientToken	string	No	The idempotency token. CloudSpec declares this query parameter, but the backend does not currently perform idempotency comparison.	a1b2c3d4-1234-5678-90ab-cdef12345678

Response elements

Element	Type	Description	Example
	object	Schema of Response
requestId	string	The request ID.	3FE4CD1E-FF41-56BE-B590-7A021D9C1524

Examples

Success response

JSON format

{
  "requestId": "3FE4CD1E-FF41-56BE-B590-7A021D9C1524"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.