Skip to content
ShopNexus Docs
On this page Answer blocks 1/4

The model builds its answer through output tools, and the agent checks each tool’s arguments against a schema. Invalid arguments go back to the model as a tool error for it to fix.

Output toolUsed for
begin_step(title), end_step(summary)Opening and closing a step. Tool calls between the two belong to the step. In a turn without steps the console shows tool calls as a flat list.
answer(blocks)The final answer, made of the blocks below. Text the model writes outside answer becomes one text block.
write_document {title, sections, document_id?}A new document, or a new version of a document already in the same chat.
ask_user {questions}Questions back to the moderator; see Controlling a run.

Answer blocks

BlockContentLimits
textMarkdown, with source numbers [n]
figuresKey figures, each with a label2 to 4
tablecolumns and rows20 rows, each as wide as the columns
chartbar, stacked_bar or line, with labels and serieseach series as long as labels
document_refA document and version in the same chat
follow_upsSuggested next questionsat most 3

Source numbers

Every record a successful MCP call returns becomes a numbered source, in the order results arrive. The agent recognises a record by its shape in the result:

KindRecognised byExample label
accounthas display_name“Minh Tuấn”, meta “Seller · 7d22e9 · active”
tickethas kind and opened_at“Lan’s ticket”
reporta report case, or each report in it“Report case: Minh Tuấn”
orderhas code or listing_title“Order: iPhone 13 Pro”
listinghas titlethe listing’s title
loga console action, with action and target_kind“suspend by Lan”
membera moderator named in an actionthe moderator’s name
dataa result with no record: a count, a price guide, an empty list“Reports, last 7 days”

Each source keeps up to four facts (status, price, dates, counts) and a quote of up to 200 characters from what users wrote. A label is never an id; a bare *_id is no source, since it has no name.

At the top of each tool result the agent lists the numbers and labels for the model to cite. A record seen again keeps its number; a fuller reading of it (from a *_get tool, say) replaces its label and facts. An [n] that names no source is dropped from the answer. The source list at the end holds the sources the answer cites, or all of them when it cites none.

Documents

write_document creates version 1 of a document, or the next version of a document in the same chat. A document’s sections are markdown, table and chart. The console opens documents in a panel of their own with every version; Copy as Markdown copies the content, and the browser prints it. Deleting a chat deletes its turns, events and documents.

Skills

A skill is a saved question with a name and variables, stored in agent_skills and shared with every moderator. Typing / in the ask box lists them; the skill’s prompt is added to that turn’s system prompt. A moderator can change only their own skills; an admin can change any.

ShopNexus Docs
EN VI