Skip to Content
AssistantsSub-Agents

Sub-Agents

Sub-Agents are other Assistants that this Assistant can delegate to when a task fits their expertise. You configure them in the Sub Agents tab.

How Sub-Agents Work

  • You assign one or more Assistants as Sub-Agents
  • During a conversation, the main Assistant can hand off (delegate) to a Sub-Agent when appropriate
  • Sub-agents must be at the same level or lower in the Assistant hierarchy (Expert → Manager → Specialist → Worker)

Sub Agents Grid

The tab shows all assigned sub-agents:

  • Assistant – Name with level icon
  • Level – Hierarchical level (Expert, Manager, Specialist, Worker)
  • Description – What the sub-agent does
  • Remove – Button to remove the sub-agent

Level Restrictions

LevelCan delegate to
ExpertManager, Specialist, Worker
ManagerSpecialist, Worker
SpecialistWorker
Worker(none)

You cannot assign an Assistant as a Sub-Agent if it is at a higher level than the current Assistant. The selection dialog filters out assistants that are at a higher level, already assigned, or the same assistant (an Assistant cannot be its own sub-agent).

Adding Sub-Agents

  1. Click Add Sub Agent
  2. In the Sub Agent Selection dialog:
    • All available assistants are shown
    • Filtered to exclude: assistants at a higher level, already assigned sub-agents, and the current assistant
    • Each shows name, level icon, and description
  3. Select an assistant
  4. The sub-agent is added immediately and the grid refreshes

Removing Sub-Agents

  1. Click Remove (trash icon) on the sub-agent row
  2. The sub-agent is removed immediately

Note: Removing a sub-agent does not delete that Assistant; it only removes it from this Assistant’s delegation list.

When to Use Sub-Agents

  • Expert/Manager – Delegate to Specialists (e.g. support, sales) or Workers for execution
  • Specialist – Delegate to a Worker for specific tasks (e.g. data lookup, form filling)
  • Worker – No delegation; use for task-only Assistants

Tips

  • Avoid circular delegation (A → B → A); keep delegation chains one-way
  • Use clear instructions on the main Assistant so it knows when to delegate (e.g. “For technical support questions, delegate to the Support Specialist”)
Last updated on