Skip to main content

Agent Teams

Module: operations:agents | Role: Any member (create/manage), platform admin (deploy) | Licence: Pro+ Tools: create_agent_team, list_agent_teams, update_agent_team, view_agent_team

Agent teams group related agents under a module for organized deployment and shared context.

Concepts​

ConceptDescription
TeamNamed group of agents with a shared mandate
MandateEnduring objective injected into all member agent prompts
Shared ContextAdditional context available to all team members
ModuleCommercial gate — enable a module to deploy its agent team

Relationship​

Module (e.g., "insight:policy")
└── Agent Team (e.g., "Policy Intelligence")
├── Agent: Policy Researcher (Explorer)
├── Agent: Policy Librarian (Librarian)
├── Agent: Policy Navigator (Navigator)
├── Agent: Policy Analyst (Analyst)
└── Agent: Policy Steward (Steward)

Enabling a module for a workspace makes all its team agents available via Eve dispatch.

Managing Teams​

Create a Team​

create_agent_team(
name="Grid Planning",
module_id="insight",
mandate="Help analysts model grid capacity scenarios",
agent_ids=["grid-analyst", "capacity-planner"]
)

Add/Remove Agents​

update_agent_team(
team_config_id="team_123",
add_agents=["new-agent"],
remove_agents=["old-agent"],
)

List Teams​

list_agent_teams() # Returns all teams for current workspace

Default Teams​

Every workspace gets a default agent team automatically. Custom agents are added to this team unless explicitly assigned elsewhere.

Deployment​

Platform admins can deploy module teams to workspaces:

update_workspace(workspace_id="ws_abc", enable_modules=["insight:policy"], confirm=True, confirm_token="...")

This enables the module for the target workspace, making all team agents available. It is confirm-then-apply: call it without confirm first to get a preview and a confirm_token. Disabling is the same tool with disable_modules.