Record something the user did, for the agent running this session
Changed onTells the agent running this session that the user did something in a client — edited the test configuration it saved, pointed the session at a test, a test case or a tracker issue, or attached a file — and does the server-side work that makes it true. Separate from the inbox because the inbox is a caller speaking. The sender recorded there is derived from the authenticated caller precisely so a caller cannot claim a person typed something, which leaves a client with no way to report a user action except to write prose and send it as the user's own words. These actions are mabl speaking: the caller names an action and its metadata, the server composes the text and queues it as system, so what the model reads is versioned with the API rather than assembled in each client. The server also does the work the action implies, and records none of it on the session. An agent session's artifacts belong to the turn that is running — a turn writes its whole merged set, built from what it loaded, and artifacts merge by name — so anything written into them from outside is replaced by that turn's stale copy. Nothing here writes one. An attachment's bytes go to the workspace's own storage, under a path derived from the session and the id and recorded nowhere. The agent finds the file by the id this message gives it, so a caller never supplies and never learns a location: one it supplied would be forged by definition, and there is no string that would resolve anywhere else. A reference is announced and validated, not stored. Reading one back still takes the reference list a planning client maintains; an agent keeping its own note of what it was told is a separate change.
Request
- Base URL: https://api.mabl.com
- URL: https://api.mabl.com/agentSession/{id}/context/actions
- Auth: one of:
- HTTP basic
- API key in header Authorization
Path parameters
Request body
Response
The queued message, plus the identifier the agent will know the referenced or attached thing by. On a repeat of an idempotency key this is the message stored the first time, and nothing new was queued.
Changes
- info
added the new optional request property
///// - info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status
- info
- info
added the new
jiraenum value to the request property/
- info