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 Prepare to call an API.
Different observation targets require different IDs. Identify the target object from a list or the result of an upstream action first.
Call sequence¶
Obtain the target task or resource-operation ID from an agent invocation or another task result.
List runtime tasks or resource operations first to locate the target object.
Query target task details, events, turn snapshots, and data parts, or query resource-operation details, to inspect current observable information.
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¶
What you need to do |
API operation |
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¶
What you need to do |
API operation |
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¶
What you need to do |
API operation |
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.