Skip to content

Commit 93dfa54

Browse files
committed
docs(ai-agents): trim AI Router page per review
Make 'When the router runs' concise (drop the table and empty state), remove the 'Using Auto', 'What the router considers', and disambiguation picker sections (screenshots cover them), and simplify the default-agent FAQ to just link to the AI Router page.
1 parent d35800d commit 93dfa54

2 files changed

Lines changed: 14 additions & 46 deletions

File tree

guides/ai-agents/ai-router.mdx

Lines changed: 13 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ description: "Automatically route questions to the best-fit agent, so users don'
1010

1111
When you have more than one AI agent in a project, users have to know which agent to ask. The **AI Router** removes that decision: type a question, and Lightdash picks the agent best suited to answer it.
1212

13-
The router looks at each agent's description, instructions, data access, and verified questions to decide where a question should go. When it's confident, it routes the question straight to the right agent and starts the conversation. When it isn't, it shows a short picker so the user can choose — with the recommended agent highlighted.
13+
The router compares each agent's description, instructions, data access, and verified questions to decide where a question should go.
1414

1515
<Note>
1616
The router only chooses **between agents the user can already access**. It never widens an agent's data access or bypasses permissions — it only changes *which* of the user's available agents answers a given question.
@@ -23,18 +23,21 @@ The router looks at each agent's description, instructions, data access, and ver
2323

2424
## When the router runs
2525

26-
The router needs **at least two agents the user can access** in a project. With a single accessible agent there's nothing to route between, so Lightdash opens that agent directly.
26+
The router needs **at least two agents you can access** in a project. With a single accessible agent there's nothing to route between, so Lightdash opens that agent directly.
2727

28-
Where a user lands when they open **Ask AI** depends on their setup:
28+
When the router is confident, it routes your question straight to the best agent and starts the conversation. When it isn't, it shows a short picker with the recommended agent highlighted so you can choose.
2929

30-
| Situation | What happens |
31-
| --- | --- |
32-
| No agents accessible | Welcome / empty state |
33-
| Exactly one agent | That agent opens directly |
34-
| A [default agent](/guides/ai-agents/using-ai-agents#faqs) is set | The default agent opens (takes precedence over the router) |
35-
| Two or more agents, no default set, router enabled | The **Ask AI** router page opens |
30+
{/* TODO: add screenshot of the "Which agent should answer?" picker with the Recommended badge */}
31+
<Frame>
32+
<img src="/images/guides/ai-agents/ai-router-picker.png" alt="Picker showing candidate agents" />
33+
</Frame>
3634

37-
If you've set a default agent but want the router to decide instead, choose **Auto** from the agent dropdown — see [Using Auto](#using-auto) below.
35+
If you've set a [default agent](/guides/ai-agents/using-ai-agents#faqs), it opens first even when the router is enabled. Pick **Auto** from the agent dropdown to let the router decide instead.
36+
37+
{/* TODO: add screenshot of the agent selector dropdown showing the "Auto" option */}
38+
<Frame>
39+
<img src="/images/guides/ai-agents/ai-router-auto-option.png" alt="Auto option in the agent selector" />
40+
</Frame>
3841

3942
## Enabling the router
4043

@@ -84,41 +87,6 @@ A few things to keep in mind:
8487
- **Tagged agents must belong to the project.** You can only tag agents that exist in the selected project.
8588
- **Fewer than two agents?** You can still write and save instructions, but the router won't run in that project until at least two accessible agents exist. Lightdash shows a note when this is the case.
8689

87-
## Using Auto
88-
89-
Once the router is enabled and a project has more than one agent, an **Auto** option appears in the agent dropdown, labelled *"We'll route to the best-fit agent."*
90-
91-
Pick **Auto** to hand the next question to the router instead of a specific agent. This is also how you reach the router when you've set a default agent — the default opens first, and selecting **Auto** lets the router decide instead.
92-
93-
{/* TODO: add screenshot of the agent selector dropdown showing the "Auto" option */}
94-
<Frame>
95-
<img src="/images/guides/ai-agents/ai-router-auto-option.png" alt="Auto option in the agent selector" />
96-
</Frame>
97-
98-
## What the router considers
99-
100-
When deciding which agent should answer, the router compares the candidate agents on:
101-
102-
- **Description and instructions** — what each agent is set up to do
103-
- **Data access** — which explores and tables each agent can reach
104-
- **Verified questions** — the example questions marked as [verified answers](/guides/ai-agents/verified-answers)
105-
- **Specialization** — how focused an agent is on a particular domain
106-
107-
If you've written [routing instructions](#routing-instructions), those take priority over the router's own judgement whenever they apply.
108-
109-
For meta-questions like *"which agents are available?"*, the router skips routing and shows the picker so the user can browse and choose.
110-
111-
## The disambiguation picker
112-
113-
When the router isn't confident enough to route automatically, it shows a **"Which agent should answer?"** picker listing the candidate agents, with the suggested one badged **Recommended**. A **Why these agents?** popover explains the router's reasoning.
114-
115-
The user's choice is remembered as part of the conversation, which also feeds the analytics that show how often the router routes automatically versus falling back to the picker.
116-
117-
{/* TODO: add screenshot of the "Which agent should answer?" disambiguation picker with the Recommended badge */}
118-
<Frame>
119-
<img src="/images/guides/ai-agents/ai-router-picker.png" alt="Disambiguation picker showing candidate agents" />
120-
</Frame>
121-
12290
## Router and Slack
12391

12492
The same routing logic powers **multi-agent Slack channels**. In a multi-agent channel you mention the single Lightdash Slack app and Lightdash automatically picks the best agent for your question — no need to know which agent to address. See [Slack channels: single-agent vs. multi-agent](/guides/ai-agents/getting-started#slack-channels-single-agent-vs-multi-agent) for setup.

guides/ai-agents/using-ai-agents.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ You can assign your default agent in Ask AI by clicking the star by your agent's
125125
</Frame>
126126
The default agent setting is per-user, per-project. There's no project-wide default at the moment.
127127

128-
When you have a default agent set, Ask AI opens it directly — even if the [AI Router](/guides/ai-agents/ai-router) is enabled. To let the router choose instead, pick **Auto** from the agent dropdown.
128+
When you have a default agent set, Ask AI opens it directly — even if the [AI Router](/guides/ai-agents/ai-router) is enabled.
129129

130130
If you haven't set a default and the AI Router is enabled, Lightdash routes each question to the best-fit agent automatically. If the router is off and you have no default, there's no predictable way to determine which agent appears first.
131131

0 commit comments

Comments
 (0)