Skip to content

docs: document SQL mode for AI agents#643

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1822d207
Open

docs: document SQL mode for AI agents#643
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/1822d207

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 18, 2026

Summary

Documents the per-thread SQL mode toggle for AI agents, which lets the agent reach for raw SQL when a question can't be answered from the semantic layer. The underlying feature is now generally available — the org-level rollout flag that previously gated it has been removed, so visibility is determined solely by the user's manage:SqlRunner permission, the per-thread toggle, and per-call human approval.

Changes

  • Add a SQL mode section to guides/ai-agents/using-ai-agents.mdx covering:
    • What SQL mode does and when to use it vs. semantic mode
    • Who can see the toggle (manage:SqlRunner ability, same as SQL Runner)
    • How per-call approvals work
    • Slack behavior and the OAuth requirement (fail-closed without it)

Context

Triggered by the upstream change that removes the ai-agent-run-sql commercial feature flag. The feature itself shipped recently and was not yet documented; this PR fills that gap now that it's available to all users with SQL Runner access.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 18, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview May 18, 2026, 9:08 AM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 18, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants