> ## Documentation Index > Fetch the complete documentation index at: https://docs.pentagon.run/llms.txt > Use this file to discover all available pages before exploring further. # Teams > Group agents by function — shared context, clear boundaries # Teams Teams let you group related agents together — visually on the spatial canvas and organizationally for collaboration. Group agents by function. Engineering, ops, research. Shared context, clear boundaries. ## Creating a team There are two ways to start: * Click the **Create Team** button in the canvas toolbar (bottom-right) * Or hold **Shift** on the canvas Either way, the canvas enters team-draw mode and the cursor changes to a crosshair. Then: 1. **Drag** to draw a rectangular region — you'll see a live preview as you drag 2. Release to finalize the area — a dialog appears where you name the team, pick a color, and optionally add an emoji 3. Click **Create Team** — the team region appears on the canvas ## Adding agents to a team * **Drag** an agent's node into a team region on the canvas * **Or** assign a team when spawning a new agent * **Or** select an agent, open Settings, and change its team assignment Agents inside a team region are visually grouped, making it easy to see which agents belong together. ## Team colors Each team gets a distinct color so you can tell groups apart at a glance. Colors are assigned automatically but can be customized in the creation dialog or team settings. ## Why use teams? **Visual clarity** — On a canvas with 10+ agents, teams turn chaos into structure. You immediately see your frontend group, your backend group, your infra group. **Communication context** — When agents are on a team, they understand their organizational context. A backend agent on the "API Team" knows to coordinate with its teammates on API-related decisions. **Scalability** — As you add more agents, teams prevent the canvas from becoming an unreadable sea of nodes. Pentagon gives you the building blocks. Design your own hierarchy — flat, layered, or anything in between. Invite human teammates to your Pentagon organization.