> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What are Teams?

> Groups of agents that collaborate to solve complex tasks.

A Team coordinates agents or nested teams. In the default coordinate mode, the leader can delegate tasks based on member roles and synthesize their results.

<img className="block dark:hidden" src="https://mintcdn.com/phidatainc/JUdd69R_GtzOgSkJ/images/teams/team-structure-light.png?fit=max&auto=format&n=JUdd69R_GtzOgSkJ&q=85&s=9a8f01ce2099fbbf152dd1cd7d87d641" alt="Team structure" width="2610" height="1413" data-path="images/teams/team-structure-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/phidatainc/JUdd69R_GtzOgSkJ/images/teams/team-structure-dark.png?fit=max&auto=format&n=JUdd69R_GtzOgSkJ&q=85&s=cec0668be20186b510fc5e22594142e8" alt="Team structure" width="2610" height="1413" data-path="images/teams/team-structure-dark.png" />

```python theme={null}
from agno.team import Team
from agno.agent import Agent

team = Team(members=[
    Agent(name="English Agent", role="You answer questions in English"),
    Agent(name="Chinese Agent", role="You answer questions in Chinese"),
    Team(
        name="Germanic Team",
        role="You coordinate the team members to answer questions in German and Dutch",
        members=[
            Agent(name="German Agent", role="You answer questions in German"),
            Agent(name="Dutch Agent", role="You answer questions in Dutch"),
        ],
    ),
])
```

## Why Teams?

Use a team when separate roles, tools, or execution paths make a task easier to control.

| Benefit        | Description                                                         |
| -------------- | ------------------------------------------------------------------- |
| Specialization | Give each member a focused role and toolset                         |
| Coordination   | Select coordinate, route, broadcast, or tasks mode                  |
| Composition    | Nest teams when a sub-team needs its own leader and members         |
| Inspection     | Keep member responses and metrics separate from the leader response |

The leader and members make separate model calls. This adds latency, token usage, and coordination state.

## When to Use Teams

**Use a team when:**

* A task requires multiple specialized agents with different tools or expertise
* You need an explicit routing, broadcast, or task-list pattern
* Member runs need separate outputs or metrics

**Use a single agent when:**

* The task fits one domain of expertise
* Minimizing token costs matters
* The extra coordination does not improve the result

## Team Capabilities

### Callable Factories

<Snippet file="concept-callable-factories.mdx" />

`knowledge`, `tools`, and `members` all accept callable factories. Agents also support callable factories for `knowledge` and `tools`. See [callable factories](/teams/building-teams#callable-factories) for examples and [caching settings](/teams/building-teams#callable-caching-settings) for cache key configuration.

## Team Modes

`TeamMode` makes collaboration styles explicit. Prefer `mode=` instead of toggling `respond_directly` or `delegate_to_all_members` directly.

```python theme={null}
from agno.team import Team, TeamMode

team = Team(
    name="Research Team",
    members=[...],
    mode=TeamMode.broadcast,
)
```

Mode selection controls how the leader delegates. The leader can still answer directly or use its own tools. `mode` overrides legacy flags. If `mode` is not set, `respond_directly=True` maps to `TeamMode.route` and `delegate_to_all_members=True` maps to `TeamMode.broadcast`. Otherwise the team uses `TeamMode.coordinate`.

<Snippet file="team-snippet.mdx" />

Modes define the delegation path without changing member configuration. See [Delegation](/teams/delegation).

## Guides

<CardGroup cols={3}>
  <Card title="Build Teams" icon="wrench" iconType="duotone" href="/teams/building-teams">
    Define members, roles, and structure.
  </Card>

  <Card title="Run Teams" icon="user-robot" iconType="duotone" href="/teams/running-teams">
    Execute teams and handle responses.
  </Card>

  <Card title="Debug Teams" icon="bug" iconType="duotone" href="/teams/debugging-teams">
    Inspect and troubleshoot team behavior.
  </Card>
</CardGroup>

## Resources

* [Examples](/examples/teams/overview)
* [Reference](/reference/teams/team)
