Run the agent's prompt, model and knowledge base against a message and return the reply instead of delivering it. Nothing is delivered and no execution is recorded.

Billed like a live reply. On an agent with the zavu provider the run is charged to your balance at the same price per token, and refused with 402 insufficient_balance at a balance of zero; on a bring-your-own-key agent it costs your provider. cost on the response is what it charged. Runs are rate limited per project (429).

Tools. By default the model is offered the agent's enabled tools but none is run: if it picks one, the reply stops there and plannedToolCalls says which, with what arguments. Set executeTools to run them — that reaches your real handlers, with whatever they cost and change — and read executedToolCalls.

Test-mode keys are billed the same way, and executeTools with one still reaches your real handlers and writes real memory: a test run is not sandboxed by the key's mode.

{
  "message": "Where is order ORD-12345?"
}