GetEvaluationRun

Updated at:

Retrieves the details of an evaluation run.

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 /api/v1/evaluation-task/{agentSpace}/{taskId}/run/{runId} 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

runId

string

No

The evaluation run ID.

eval-run-4fd47f3d7e684e15b1d3d178c6a5b81a

Request parameters

Parameter

Type

Required

Description

Example

No parameters required.

Response elements

Element

Type

Description

Example

object

Schema of Response

requestId

string

The request ID.

3FE4CD1E-FF41-56BE-B590-7A021D9C1524

runId

string

The run ID.

eval-run-4fd47f3d7e684e15b1d3d178c6a5b81a

runName

string

The run name.

trace_task_completion_eval-backfill

taskId

string

The evaluation task ID.

eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25

runType

string

The run type.

Valid values:

  • continuous :

    continuous

  • backfill :

    backfill

  • continuous_parent :

    continuous_parent

backfill

status

string

The run status.

Valid values:

  • Failed :

    Failed

  • Running :

    Running

  • Completed :

    Completed

  • Terminated :

    Terminated

  • Pending :

    Pending

Running

totalCount

integer

The total number of evaluation entries.

100

successCount

integer

The number of successful entries.

96

failedCount

integer

The number of failed entries.

4

evaluatorProgress

array<object>

The list of progress details by evaluator.

[{"evaluatorName":"Builtin.agent_task_completion","totalCount":100,"successCount":96,"failedCount":4}]

object

The progress object of a single evaluator.

{"evaluatorName":"Builtin.agent_task_completion"}

evaluatorName

string

The evaluator name.

Builtin.agent_task_completion

totalCount

integer

The total number of entries for this evaluator.

100

successCount

integer

The number of successful entries for this evaluator.

96

failedCount

integer

The number of failed entries for this evaluator.

4

createdAt

integer

The creation time, in seconds-level UNIX timestamp.

1782816000

updatedAt

integer

The update time, in seconds-level UNIX timestamp.

1782816600

evaluators

string

The evaluator configuration snapshot at the time the run was created, in JSON string format.

[{"evaluatorRef":"Builtin.agent_task_completion"}]

dataStartTime

integer

The start time of the data window for the run, in seconds-level UNIX timestamp.

1782816000

dataEndTime

integer

The end time of the data window for the run, in seconds-level UNIX timestamp.

1782902400

Examples

Success response

JSON format

{
  "requestId": "3FE4CD1E-FF41-56BE-B590-7A021D9C1524",
  "runId": "eval-run-4fd47f3d7e684e15b1d3d178c6a5b81a",
  "runName": "trace_task_completion_eval-backfill",
  "taskId": "eval-task-8b36f2e2b1f94f9c91ce7a4b0f6d9c25",
  "runType": "backfill",
  "status": "Running",
  "totalCount": 100,
  "successCount": 96,
  "failedCount": 4,
  "evaluatorProgress": [
    {
      "evaluatorName": "Builtin.agent_task_completion",
      "totalCount": 100,
      "successCount": 96,
      "failedCount": 4
    }
  ],
  "createdAt": 1782816000,
  "updatedAt": 1782816600,
  "evaluators": "[{\"evaluatorRef\":\"Builtin.agent_task_completion\"}]",
  "dataStartTime": 1782816000,
  "dataEndTime": 1782902400
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.