orxtra v0.13.0 /orxtra inbox
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

Flags
NameShortTypeDefaultEnvDescription
--runstrFilter inbox items by run ID (only show items for this run).
--statusstrFilter 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

Arguments
NameRequiredDescription
item_idyesUnique 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

Arguments
NameRequiredDescription
answeryesThe answer text to submit as a response to this item.
item_idyesUnique 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

Arguments
NameRequiredDescription
item_idyesUnique 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

Arguments
NameRequiredDescription
reasonyesExplanation of why the inbox item is being rejected.
item_idyesUnique identifier of the inbox item to reject (UUID format).
Search