Skip to main content
When a group Space has multiple experts, Braintrust routes each @BrainTrust request to the best fit.

How Routing Works

  • If you name one expert, Braintrust routes to that expert.
  • If you say “team” or “all,” multiple experts may respond.
  • Otherwise, Braintrust picks the best match from experts in that group Space.

How to Improve Routing

1) Give Experts Distinct Jobs

Good setup:
  • Research expert
  • Writing expert
  • Data analysis expert
Avoid adding several experts with nearly identical responsibilities.

2) Use Orchestrator Rules

The orchestrator delegates each incoming request to the most relevant expert based on each expert’s Description field. This is why writing a precise, outcome-focused description matters — the orchestrator reads it to decide who handles what. If two experts have similar or vague descriptions, routing becomes unreliable. Orchestrator rules let you add explicit overrides on top of that default behavior. Set routing instructions in a group Space:
/orchestrator set Route finance questions to FinanceBot. Route roadmap questions to ProductBot.
Check current rules:
/orchestrator show
Reset rules:
/orchestrator clear

3) Write Specific Prompts

Instead of:
@BrainTrust help me analyze the trends for this year and generate report based on that
Use:
@BrainTrust analyze Q4 revenue trends and call out top 3 risks, generate the anlysis report as pdf and store it in my drive

Common Issues

IssueFix
Wrong expert respondsAdd clearer orchestrator rules
No responseConfirm experts are in Space with /list and include @BrainTrust
Too many responsesAsk for one role explicitly, or avoid “team/all” phrasing

Next Steps

Add Experts to Group Spaces

Review the setup flow and command basics.

Slash Commands

Command reference for /add, /list, /remove, and /orchestrator.

Set Up Automations

Run expert workflows automatically.

Troubleshooting

Fix routing and response issues quickly.