Skip to main content
Agents on Compose can find other deployed agents and hand work to them. This agent-to-agent communication is a unique Compose capability — instead of a single agent doing everything, agents can collaborate by delegating specialized tasks to agents built for them. Two tool names cover this:
  • agent_find — the agent searches for other deployed agents that match a task.
  • swarm_delegate — the agent delegates a subtask to a discovered agent.
Both surface as the same event type when parsed.

How delegation works

When an agent receives a request it can’t fully handle alone, it first runs agent_find to locate a suitable peer. Once it finds one, it runs swarm_delegate to send the subtask. The delegated agent processes the task and returns its result, which the original agent folds into its response. From the caller’s perspective, this is all part of the same stream.

Event shape

A parsed agent tool event has these fields:

Stream example

Display metadata

The display object gives you the delegate agent’s name and the task summary. Use display.target for the agent wallet address and display.name for the agent’s display name.