Monitor runs and handle feedback

Query agent runtime tasks, events, data parts, and resource operations, and view feedback and its statistics. Use this page to observe and handle completed runs; it does not create agents or initiate invocation.

Prerequisites

Prepare credentials that can access the target workspace and related IDs obtained from invocations, tasks, or resource operations. For service endpoints, authentication, and general request formats, see Make your first AI Studio API call.

Different observation targets require different IDs. Identify the target object from a list or the result of an upstream action first.

Call sequence

  1. Obtain the target task or resource-operation ID from an agent invocation or another task result.

  2. List runtime tasks or resource operations first to locate the target object.

  3. Query target task details, events, turn snapshots, and data parts, or query resource-operation details, to inspect current observable information.

  4. To stop a resource operation, get its details first, then use the cancel action. To assess usage feedback, query feedback and statistics.

API operations

Query runtime tasks and data

Task

Use it when

Query a runtime manifest

View the runtime manifest.

Query runtime tasks

Locate a target runtime task.

Query runtime task details

You have a task ID and need to view the task.

Query runtime task events

View events for a target task.

Query a runtime turn snapshot

View turn information for a target task.

Query runtime data parts

View data parts for a target task.

Query and handle resource operations

Task

Use it when

Query resource operations

Locate a target resource operation.

Query resource-operation details

Before cancellation or to confirm an operation result.

Cancel a resource operation

Confirm conditions and results on the action page before cancellation.

View feedback

Task

Use it when

Query feedback

View feedback for the target scope.

Query feedback statistics

Aggregate feedback.

Confirm the result

Use Get a runtime task or Get a resource operation to confirm current information for the target object. After submitting a cancellation request, query the resource-operation details again to confirm the observable result.

Limitations and notes

Canceling a resource operation affects the target operation. Confirm conditions and results in Cancel a resource operation before proceeding.

Next steps

Last updated on