Skip to content
Tenzro
← All tutorials
Tutorial · Agents

Compose an agent from the registry

Spawn a working agent from a published template under one of your agents, so its limits can never exceed the parent's, then run and rate it.

Intermediate20 min

The agent registry holds templates: a published agent design with a system prompt, declared capabilities, runtime requirements, an execution spec and a price. Spawning a template gives you a running agent without writing one. Reference templates cover common Machine Economy jobs, such as routing inference to the best provider, transcribing audio, indexing images, forecasting time series and paying for services over MPP.

You spawn a template under one of your existing agents. The child's effective delegation scope is the strict intersection of the parent's scope and the template's: it can never be broader than its parent on any limit, allow-list or time bound.

Prerequisites

1. Browse the templates

In the console, open /console/hub and filter by agent templates. From the CLI:

bash
tenzro agent list-templates --rpc https://rpc.tenzro.xyz
tenzro marketplace search "transcribe" --rpc https://rpc.tenzro.xyz
tenzro marketplace list --free-only --rpc https://rpc.tenzro.xyz

tenzro marketplace list also filters by --template-type (autonomous, tool_agent, orchestrator, specialist, multi_modal) and --tag.

2. Inspect a template

Read what a template does, and what it needs, before you give it authority:

bash
tenzro agent get-template --id ref-audio-transcriber-v1 --rpc https://rpc.tenzro.xyz

The template declares:

FieldWhat to check
capabilitiesWhat the agent can do, each with an input and output schema
runtime_requirementsMemory, storage, GPU, network access, whether a TEE is required
pricingfree, per execution, per token, subscription or revenue share
system_prompt and execution specThe steps it will run, and which services it will pay for

tenzro marketplace stats ref-audio-transcriber-v1 shows how often it has been used and how it is rated.

3. Spawn it under your agent

bash
tenzro agent spawn-template \
  --template-id ref-audio-transcriber-v1 \
  --parent-machine-did did:tenzro:machine:... \
  --rpc https://rpc.tenzro.xyz

The output gives the new agent's id and DID. The spawned agent is a child of the parent you named: it appears under the same controller, its limits are the intersection of the parent's scope and the template's spec, and revoking the parent revokes it too.

Spawning is an owner action signed by the parent's controller.

4. Dry-run, then run

Run the template's execution spec without dispatching anything or paying anyone:

bash
tenzro agent run-template --agent-id <agent-id> --dry-run --rpc https://rpc.tenzro.xyz

When the plan looks right, run it:

bash
tenzro agent run-template --agent-id <agent-id> --max-iterations 3 --rpc https://rpc.tenzro.xyz

For a paid template, run it through the marketplace with the wallet that pays:

bash
tenzro marketplace run \
  --agent-id <agent-id> \
  --payer-wallet 0xParentAgentWallet \
  --max-iterations 1 \
  --rpc https://rpc.tenzro.xyz

The marketplace charges the payer, sends the network commission to the treasury and the rest to the template's creator. Every payment the agent makes while it runs, such as buying transcription from a provider over x402, is checked against its effective scope.

5. Compose more than one

Templates compose. A useful pattern is one parent agent with a small daily limit and several children spawned from different templates:

bash
tenzro agent spawn-template --template-id ref-model-inference-proxy-v1 --parent-machine-did did:tenzro:machine:... --rpc https://rpc.tenzro.xyz
tenzro agent spawn-template --template-id ref-vision-indexer-v1 --parent-machine-did did:tenzro:machine:... --rpc https://rpc.tenzro.xyz

All children share the parent's ceiling. To coordinate them on one job, put them in a swarm; see Build an agent swarm orchestrator.

6. Rate the template

Ratings help the next user choose. Rate from 0 to 100 with a comment:

bash
tenzro marketplace rate ref-audio-transcriber-v1 --rating 90 --comment "Accurate on long-form multilingual audio" --rpc https://rpc.tenzro.xyz

Next steps