On this page
Work the human-in-the-loop queue: list the questions agents have raised, inspect one in full, and resolve it by answering, skipping or rejecting it.
#orxtra inbox
Manage human-in-the-loop inbox items (list, show, respond, skip, reject).
#inbox list
List the human-in-the-loop inbox items agents have raised. Narrow the listing with --run to a single workflow run and with --status to one lifecycle state such as pending, answered or skipped; omit both to see everything. Honours the global --format flag, so the listing renders as a table or as JSON.
Effect: read_only
#Flags
| Name | Short | Type | Default | Env | Description |
|---|---|---|---|---|---|
--run | str | Filter inbox items by run ID (only show items for this run). | |||
--status | str | Filter inbox items by status (e.g. pending, answered, skipped). |
#inbox show
Display everything the store holds for one inbox item: the question an agent asked, the options it offered, the run and task it came from, and its current resolution state. Takes the item's UUID. Honours the global --format flag, so the item renders as a readable table or as JSON.
Effect: read_only
#Arguments
| Name | Required | Description |
|---|---|---|
item_id | yes | Unique identifier of the inbox item to display (UUID format). |
#inbox respond
Submit an answer to a pending inbox item, unblocking the agent that raised the question and recording your identity as the principal that resolved it. Takes the item's UUID and the answer text. Prints the updated item, honouring the global --format flag, so you can confirm the response landed.
Effect: mutating
#Arguments
| Name | Required | Description |
|---|---|---|
answer | yes | The answer text to submit as a response to this item. |
item_id | yes | Unique identifier of the inbox item to respond to (UUID format). |
#inbox skip
Resolve a pending inbox item without answering it, telling the agent that raised the question to proceed without your input. Records your identity as the principal that resolved the item. Takes the item's UUID and prints the updated item, honouring the global --format flag, so you can confirm the outcome.
Effect: mutating
#Arguments
| Name | Required | Description |
|---|---|---|
item_id | yes | Unique identifier of the inbox item to skip (UUID format). |
#inbox reject
Reject a pending inbox item when none of the options an agent offered is usable, sending back a reason instead of an answer so the agent can reformulate. Takes the item's UUID and an explanation. Prints the updated item, honouring the global --format flag, and records you as the principal that resolved it.
Effect: mutating
#Arguments
| Name | Required | Description |
|---|---|---|
reason | yes | Explanation of why the inbox item is being rejected. |
item_id | yes | Unique identifier of the inbox item to reject (UUID format). |