- Asker (default) — ask questions in plain language; get answers and charts.
- Builder — have your agent build data apps: it creates reusable semantic functions and writes the app code that calls them.
Choose your mode
| Asker mode | Builder mode | |
|---|---|---|
| Best for | Analysts, business users, executives | Building dashboards & data apps |
| Primary use | Ad-hoc questions and analysis | Steering your agent to build apps |
| How you use it | You ask, in conversation | You describe; your agent builds with functions + SDK |
| Speed & consistency | Re-asks the AI each time (a few seconds) | Loads instantly; same inputs always give the same number |
| Tools your agent gets | Questioning and analysis | Function management and SDK |
Asker mode
Ask questions about your business data in plain language. Jedify interprets the question, generates SQL against your semantic layer, runs it, and returns an answer with charts and an explanation. Best for data analysts, business users, and executives doing ad-hoc exploration, investigations, and reporting.Asker tools
Every tool available in Asker mode.
Examples
Example prompts and what your agent does.
Builder mode
Describe the dashboard or app you want, and your agent builds it: it creates reusable semantic functions (parameterized queries) and writes the app code that calls them through the@jedify/sdk SDK. Because each function’s query is built ahead of time, the dashboard loads instantly and shows the same numbers every time — no AI step at runtime.
You steer in plain language — your agent does the technical work. You don’t need to be a developer: if you can describe what you want and review the result, Builder mode is for you. Best for dashboards, embedded analytics, and data apps.
Semantic functions
What they are and how they’re created.
Builder tools
The six Builder-mode tools.
SDK reference
The
@jedify/sdk TypeScript SDK.Examples
Build a dashboard end to end.
Switching modes
Asker mode is the default — no flag needed. To run in Builder mode, add--builder to the proxy args:
args | Mode |
|---|---|
["-y", "@jedify/mcp-auth"] | Asker (default) |
["-y", "@jedify/mcp-auth", "--builder"] | Builder |
?mode=builder to your Jedify MCP server URL instead.
See Connect for where this goes in each client, and Authentication for how to sign in.