use_tool
Destructive
Run registered tools — prewritten execute() calls, grouped into toolboxes. calls lists the tools to run; search_tools finds them. mode 'sequential' (the default) stops at the first failure; 'parallel' runs every call and collects all results. Returns { batch, mode, ok, ran, total, results }, where results matches calls by position.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as | No | Your own name, when you are one of several agents sharing one connection to this engine (the sub-agents one agent session runs share its connection, so without it the engine sees all of them as one caller). Pass the same name on every call you make. The engine then treats you as a caller of your own: your roster name is this name, and your play session, the play-shadow writes and refusals that say who wrote what, engine.modeOwner, your shell session and your notices are yours alone. Lowercase letters, digits, '-' and '_'. Leave it out when you are the only agent on your connection. | |
| mode | No | 'sequential' (the default) stops at the first failure. 'parallel' runs every call and collects all results. | |
| calls | Yes | The tool calls to run, in order. |