FIELD GUIDE 03 · MULTI-AGENT TEAMS

Build an agentic team with clear roles.

Turn one objective into coordinated work. Define a Director and specialist agents, then choose which teammate or group gets each task, where they work, and which tools and models they can use.

7 minute guideUpdated September 2026By Baux
Definition

An agent team builder shapes a coordinated system of AI agents by defining who leads, who works, what each role can use, and how delegated results return to the shared task.

From one prompt to a team operation.

An agentic team is useful when the work benefits from separate perspectives or parallel execution. The goal is not more agents; it is clear ownership, controlled access, and results that integrate cleanly.

01 · DIRECTOR

Own the objective

The Director interprets the request, splits the work, selects the right specialists, and assembles their outputs into a final result.

02 · ROLES

Define expertise

Workers receive focused responsibilities such as architecture, implementation, research, review, or quality assurance.

03 · PERSONAS

Set behavior

Instructions and personas shape how each worker reasons, communicates, escalates uncertainty, and reports completion.

04 · MODELS

Match model to job

Choose a fast model for routine checks, a deeper model for architecture, or a local model where proximity matters.

05 · TOOLS

Grant exact access

Give each role only the file, command, browser, or external tools its assignment actually requires.

06 · ROUTE

Choose the next crew

Target one teammate, a selected group, or the whole team, then choose the project directory where their worker sessions start.

Route each task deliberately.

The team pattern defines who can participate; the next-task selector decides who should participate now. The choice remains available while work is running and clears after the message is sent.

ONE TEAMMATE

Use the specialist

Send a focused task directly to the role built for it instead of asking the Director to choose again.

SELECTED GROUP

Coordinate the right crew

Choose several roles or everyone. Baux requires useful delegation to each selection and blocks substitutions.

WORKER DIRECTORY

Pin the file scope

Choose an existing directory inside the Director's project. Traversal, missing paths, files, and symlink escapes are rejected.

Agent, workflow, or agentic team?

The right shape follows the problem. Use the smallest system that can do the work without hiding responsibility or adding coordination overhead.

PatternBest forCoordinationTradeoff
Single agentFocused tasks with one clear line of workOne loop owns the whole taskContext and expertise must fit one role
Fixed workflowRepeatable processes with known stepsPredefined sequence or graphLess adaptive when the task changes shape
Agentic teamComplex work that benefits from specialists or parallelismDirector delegates to role-based workersNeeds visible state and disciplined handoffs

A practical team design checklist.

Start with boundaries and outputs. A useful role has a concrete job, the minimum access required, and a report another agent or person can evaluate.

  • Name one owner for the overall objective
  • Give every worker a distinct responsibility
  • Specify expected artifacts and completion criteria
  • Assign tools and models per role, not globally
  • Choose the teammate group and worker directory per task
  • Choose serial or parallel delegation scheduling
  • Keep delegation, output, tokens, and cost visible

Five built-in patterns or a custom harness.

Software Team, Research Lab, Bug Hunt, Code Review, and Schoolhouse ship ready. Start from a proven shape, edit any role, or define a custom team for the way your organization already works.

SOFTWARE TEAM

Design, build, verify

Coordinate architecture, implementation, and QA roles while keeping each worker's session, tools, and report inspectable.

FOCUSED PATTERNS

Research, debug, review, teach

Use Research Lab, Bug Hunt, Code Review, or Schoolhouse when the work benefits from a purpose-built handoff loop.

CUSTOM TEAM

Make the pattern yours

Define the Director and worker roles, personas, providers, tools, and scheduling style that fit your own process.

Agent team builder FAQ.

Core questions about configuring and operating multi-agent teams.

What is an AI agent team?

An AI agent team is a coordinated group of agents with separate roles, tools, models, and responsibilities working toward a shared outcome.

What does an agent team builder configure?

An agent team builder configures the team structure, Director, worker roles, instructions, personas, model choices, allowed tools, and scheduling behavior.

Can I select who gets the next task?

Yes. Route the next prompt to one teammate, a selected group, or the whole team and choose the existing project directory where their worker sessions run. Baux enforces both selections at delegation time.

Can an agentic team use different models?

Yes. In Baux, different roles can use different cloud or local models so the model choice can match each worker's task.