oz0 tool call
For: Operators and developers looking up a command.
Call one function of a tenant's tool, such as jev.decide (or by its address, such as jev-tools/jev.decide, which the server checks against the plugin that provides the tool), with --args as its arguments, and print what it returned.
The call runs as a job of its own (tool-<id>, named tool:<function> in job list), on a node of the tenant whose plugin has the function ready, or the one --node names: the tenant's tool policy, the plugins' pre_tool_call and post_tool_call hooks and approvals decide it as they decide an agent's call. A call that waits for approval waits until someone decides it (approval list), and a refused one says which rule refused it and how to fix it.
The job's trace is in job trace and on its page in the web UI.
Usage
oz0 tool call <tool>.<function> | <plugin>/<tool>.<function> [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--args | string | {} | the function's arguments, as a JSON object |
--id | string | the call's job ID (default: tool-<a new random one>); an ID whose ended job's files are still kept is refused | |
--json | bool | print JSON instead of a table | |
--node | string | an online node of the tenant that has the function ready | the node to call it on |
--quiet (-q) | bool | print only the result | |
--tenant | string | default | tenant |
--wait | duration | until the call ends, approvals included | longest to wait for the result |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--context | string | $OZ0_CONTEXT or <config dir>/orchestrator-zero/context.json | CLI context file written by server init |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0 commands and the global flags.