Skip to main content

Org Chart Builder

The Org Chart Builder provides a visual interface for designing agent hierarchies and team structures.

Overview​

Agent hierarchies define:

  • Parent-child relationships between agents
  • Escalation paths
  • Team memberships
  • Reporting structures

Using the Org Chart​

Viewing the Hierarchy​

  1. Open Studio from the top bar
  2. Select the Org Chart tab
  3. View the visual tree of agents

Adding Agents to Hierarchy​

  1. Click on an agent node
  2. Select "Add Child Agent"
  3. Choose from existing agents or create new

Setting Parent Relationships​

// Set an agent's parent
await client.agents.update('agent-child', {
  parentAgentId: 'agent-parent'
});

Removing from Hierarchy​

// Remove parent relationship
await client.agents.update('agent-child', {
  parentAgentId: null
});

Hierarchy Levels​

CEO Agent (Top Level)
├── Department Head A
│   ├── Team Lead 1
│   │   ├── Agent 1.1
│   │   └── Agent 1.2
│   └── Team Lead 2
│       └── Agent 2.1
└── Department Head B
    └── Team Lead 3

Team Structures​

Agents can belong to teams independently of hierarchy:

// Add agent to team
await client.teams.addMember('team-123', {
  agentId: 'agent-456',
  role: 'member'
});

Best Practices​

  1. Keep hierarchies shallow: 3-4 levels maximum
  2. Clear escalation paths: Each agent should know its parent
  3. Team overlap: Agents can be in multiple teams
  4. Document relationships: Add notes explaining why agents are connected

Next: Learn about Prompt Engineering for configuring agent behavior.