Skip to main content
Wait for the latest turn of a conversation with the Analyst and read what it left, without starting anything. Call it when ask_analyst, 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_analyst’s. Relay the answer, or show a question to the user and send their reply with ask_analyst. A turn that ended on an error is raised as one. Available only where the Analyst is switched on for the company. The caller needs read access on reports.

Parameters

Body

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

Response

Body

string
‘answered’: the Analyst finished its turn, its reply is in answer. ‘awaiting_user’: it paused on a question (pending_question); show it to the user and send their reply as the next instruction of this conversation with ask_analyst. ‘running’: a turn is still going; call get_analyst_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 in the Analyst panel. Pass it back on every follow-up call.
string
The Analyst’s reply when status is ‘answered’, to relay to the user. Null otherwise.
object
The question the Analyst 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 report the conversation works on, as list_reports lists it, with the link to open it: the one the call named, or the one the Analyst created during this conversation. Null while the Analyst has not created one yet.