Skip to main content
Wait for the latest turn of a conversation with the Architect and read what it left, without starting anything. Call it when ask_architect, or an earlier call of this tool, came back running. Each call waits about 45 seconds. While the turn goes on, it answers running again: call it again then. The result reads like ask_architect’s. Relay the answer, or show a question or a plan to validate to the user and send their reply with ask_architect. A turn that ended on an error is raised as one. Available only where the Qobra write tools beta is enabled and the Architect is switched on for the company.

Parameters

Body

string
required
Id of the conversation whose latest turn to read: the one ask_architect returned.

Response

Body

string
‘answered’: the Architect finished its turn, its reply is in answer. ‘awaiting_user’: it paused on a question (pending_question) or on a plan to validate (pending_plan); show it to the user and send their reply as the next instruction of this conversation with ask_architect. ‘running’: a turn is still going; call get_architect_turn with this conversation_id to keep waiting for it. One of: answered, awaiting_user, running.
string
The conversation this turn belongs to, the same one the web app shows on the compensation. Pass it back on every follow-up call.
string
The Architect’s reply when status is ‘answered’, to relay to the user. Null otherwise.
object
The question the Architect is waiting on, with the options it offers (multi_select: several may be picked; the user may also answer in their own words). Set only when status is ‘awaiting_user’.
object
The changes the Architect proposes, waiting for the user to approve or amend them; it applies nothing before. Set only when status is ‘awaiting_user’.
object
The compensation to review, as get_plan lists it: its draft version when it has one, the compensation itself otherwise. Publishing it is the user’s decision, made in the Qobra web app.
boolean
True: the turn’s changes were saved as the compensation’s draft, which nothing reads until the user publishes it. False: nothing was saved, save_note says why. Null while a turn runs, and for a turn asked from the web app, which saves from its own page.
string
Why nothing was saved, or what the save had to change on the way, to tell the user. Null when there is nothing to add.