> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.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.

![Team structure](https://mintcdn.com/agno-v2/i4nXCaAsJR5zgHQd/images/teams/team-structure-light.png?fit=max\&auto=format\&n=i4nXCaAsJR5zgHQd\&q=85\&s=0bbb6a84e04b9201746b0ff3495243e3)

```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](https://agno-v2.mintlify.site/teams/building-teams.md#callable-factories) for examples and [caching settings](https://agno-v2.mintlify.site/teams/building-teams.md#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](https://agno-v2.mintlify.site/teams/delegation.md).

## Guides

> **[Build Teams](https://agno-v2.mintlify.site/teams/building-teams.md)**
>
> Define members, roles, and structure.

> **[Run Teams](https://agno-v2.mintlify.site/teams/running-teams.md)**
>
> Execute teams and handle responses.

> **[Debug Teams](https://agno-v2.mintlify.site/teams/debugging-teams.md)**
>
> Inspect and troubleshoot team behavior.

## Resources

* [Examples](https://agno-v2.mintlify.site/examples/teams/overview.md)
* [Reference](https://agno-v2.mintlify.site/reference/teams/team.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.