Skip to main content
When you compile a Playbook, Aident creates an Agent Team — a group of AI agents ready to execute your workflow. Each agent has specific capabilities and responsibilities based on your Playbook’s Roster.

Team Structure


Mandatory Roles

Every Agent Team includes two essential roles that Aident adds automatically:

Project Manager

Coordinates the workflow, delegates tasks, and ensures agents work together effectively.

QA Specialist

Validates outputs and checks for errors before delivery.
You don’t need to define these roles in your Playbook — they’re included in every Agent Team automatically.

Specialist Agents

Beyond the mandatory roles, you or Aiden define Specialist Agents based on your workflow needs. Each specialist is described in your Playbook’s Roster section.

Defining Specialists

Just describe what each role does in plain English:
## Roster

- **Email Analyst**: Reads Gmail inbox and categorizes client emails by priority
- **Content Writer**: Creates readable summaries from email data
- **Slack Communicator**: Posts formatted messages to Slack channels
You don’t need to configure technical details. Describe the role’s responsibilities, and Aident figures out the right capabilities.

How Specialists Work

When you define a specialist, Aident:
  1. Analyzes the role description to understand what capabilities are needed
  2. Assigns appropriate skills — the tools and integrations the agent can use
  3. Configures the agent to work within your workflow’s collaboration rules

Agent Capabilities

Each agent in your team has access to specific capabilities based on their role:
Skills are the actions an agent can perform:
  • Reading and writing data
  • Processing and transforming information
  • Making decisions based on criteria
  • Communicating with other agents
Skills are automatically assigned based on the role description.

Team Collaboration

Agents don’t work in isolation — they collaborate according to your Playbook’s Collaboration Rules.

Handoffs

When one agent completes their task, they hand off the results to the next agent in the workflow. This is defined in your Collaboration Rules using @mentions:
## Collaboration Rules

1. @Email Analyst fetches emails from the past 24 hours
2. @Email Analyst categorizes each email by priority
3. @Content Writer receives the categorized list and drafts a summary
4. @QA Specialist reviews the summary for accuracy
5. @Slack Communicator posts the approved summary to #client-updates

Execution Patterns

Your Agent Team can execute workflows in different patterns:

Sequential

Agents work one after another in a defined order. Each waits for the previous to complete.Best for: Step-by-step processes with clear dependencies

Parallel

Multiple agents work simultaneously on different parts of the task.Best for: Independent subtasks that can run concurrently

Best Practices

Each specialist should have a clear, single responsibility. Instead of one agent doing everything, split complex tasks across multiple focused specialists.
Names like “Email Analyst” or “Content Writer” make your Playbook easier to understand and help Aident assign the right capabilities.
In your Collaboration Rules, explicitly state what each agent receives and what they pass to the next. This prevents confusion and ensures smooth execution.
Begin with fewer specialists and add complexity as needed. A workflow with 3 well-defined agents often performs better than one with 10 vaguely defined roles.

Next Steps