Supervisor

Route complex requests to a supervisor AI for review.

Intermediate
2 min read

Supervisor

The Supervisor ability routes complex or sensitive requests to a supervisor AI for review. This creates a two-tier system where a primary AI handles routine conversations and escalates to a more capable or specialized AI when needed.

Settings

SettingDescription
Include HistorySend conversation history to supervisor

How It Works

When the Supervisor ability is enabled, the AI can escalate requests it's uncertain about or that require higher-level judgment. The supervisor AI receives the request (and optionally the conversation history) and provides guidance or a direct response.

This is useful for:

  • Complex decision-making that benefits from a second opinion
  • Sensitive topics that need careful handling
  • Requests that fall outside the primary AI's expertise
  • Quality assurance on important responses

If Include History is enabled, the supervisor receives the full conversation context. Otherwise, it only receives the specific request being escalated.

Adding Supervisor

Supervisor can be added at either the workflow or task level:

  1. Open your workflow or task
  2. Go to the Abilities tab
  3. Click Add Ability and select Supervisor
  4. Configure whether to include conversation history
  5. Save

Task-level abilities override workflow-level abilities of the same type.

Tips

  • Enable Include History for better context when the supervisor needs to understand the full conversation.
  • Use sparingly to avoid unnecessary latency from double-processing every request.
  • Combine with conditions to only trigger supervision for specific scenarios.

Conditional Activation

You can restrict when the Supervisor is available using CEL expressions in the ability's Conditions field. For example, you might only enable supervision for VIP members:

cel

See Abilities for more on conditional abilities.

  • Abilities — Overview of all AI abilities
  • Workflows — Build multi-step flows with escalation paths
  • Agents — Configure the AI agents that act as supervisors