ToolPlexerEndpoints
toolplexer execute
Route a task to an available provider and run it.
Use execute when you want ToolPlexer to choose the provider and endpoint for
a task. This is a paid operation.
Usage
toolplexer execute <task> [options]Options
| Option | Description |
|---|---|
-i, --input <json> | JSON input, @file.json, or - for stdin |
-f, --input-file <file> | Read JSON input from a file |
-w, --wait [seconds] | Poll until completion; defaults to the command timeout |
--timeout <seconds> | Polling deadline (1–3600 seconds, default 300) |
-o, --output <file> | Save the response to a new file |
-j, --json | Print raw JSON |
Examples
toolplexer execute "web search" -i '{"query":"cats","maxResults":3}'
toolplexer execute "web search" -i @input.json --wait 120
toolplexer execute "web search" -f input.json -o result.json --jsonWithout --wait, the command returns the run response. If the selected
provider is asynchronous, the response contains a runId; retrieve it later:
toolplexer runs get --run-id <run-id>Discovery and inspection are free. Use them when you need to preview candidate
capabilities before spending, or use execute when automatic selection is the
right product behavior.