You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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.
Copy file name to clipboardExpand all lines: guides/ai-agents/ai-router.mdx
+13-45Lines changed: 13 additions & 45 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ description: "Automatically route questions to the best-fit agent, so users don'
10
10
11
11
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.
12
12
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.
14
14
15
15
<Note>
16
16
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
23
23
24
24
## When the router runs
25
25
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.
27
27
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.
29
29
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 */}
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
+
<imgsrc="/images/guides/ai-agents/ai-router-auto-option.png"alt="Auto option in the agent selector" />
40
+
</Frame>
38
41
39
42
## Enabling the router
40
43
@@ -84,41 +87,6 @@ A few things to keep in mind:
84
87
-**Tagged agents must belong to the project.** You can only tag agents that exist in the selected project.
85
88
-**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.
86
89
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
-
<imgsrc="/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 */}
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.
Copy file name to clipboardExpand all lines: guides/ai-agents/using-ai-agents.mdx
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -125,7 +125,7 @@ You can assign your default agent in Ask AI by clicking the star by your agent's
125
125
</Frame>
126
126
The default agent setting is per-user, per-project. There's no project-wide default at the moment.
127
127
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.
129
129
130
130
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.
0 commit comments