Docs/AI Chat

AI Chat

AI Chat is the AI assistant built into the DBConvert Streams desktop app. Open it, pick an agent, and ask about your databases, files, and streams in plain language. It works from your live workspace — the same connections, schemas, files, and stream status you see in Data Explorer.

It runs your own agent (Claude Code, Codex, GitHub Copilot CLI, or OpenCode) with your own model account. DBConvert injects its read-only tools into the session automatically, so there's nothing to wire up per chat.

For a query already open in the editor, start a chat from the SQL Console: AI Chat receives the current query and its console context automatically.

Want to use DBConvert from an external AI app (Claude Desktop, Cursor) or over HTTP instead? That's a different feature — see AI Clients (MCP). AI Chat lives inside the app; AI Clients connect your own external client.

Open AI Chat for a connection, ask a question, and see the tools it uses before it answers.

What it gives you

Without it, you copy-paste schemas, row counts, and error messages into a chat window — and they go stale the moment something changes. AI Chat calls your live workspace directly, so every answer is grounded in real state: it lists your actual connections, describes real tables, runs real SELECTs, and reads real stream status. No second copy of your schema to keep in sync.

Requirements

  • The DBConvert Streams desktop app (AI Chat is desktop-only).
  • Install and sign in to at least one supported agent CLI on your computer — see Set up an AI agent. You can select the agents AI Chat finds; unavailable agents appear disabled.

Quickstart

First time here? Set up one AI agent before you start. You only need to install and sign in once.

  1. Open the desktop app and click AI Chat in the left sidebar.
  2. Choose a suggested question, or type your own question and send it.

If AI Chat returns an answer, you're ready.

No agent in the picker? AI Chat runs an agent you already have. Install one first: Set up an AI agent.

Read-only access

AI Chat can inspect DBConvert, but it cannot change it — see What it cannot do for the exact boundary and Safety & privacy for the full guarantee list.

In this section

  • Set up an AI agent — install and sign in to Claude Code, Codex, GitHub Copilot CLI, or OpenCode, and choose a model.
  • Using AI Chat — scopes and "Ask AI in context", the scope switcher, suggestions, sessions and memory, and the usage badge.
  • Generate SQL — the same engine, aimed at the SQL editor (⌘K / Ctrl+K) instead of a conversation.
  • Fix a failed query — repair a SQL error with the query and database error already attached.
  • Examples — real end-to-end exchanges from a live workspace.
  • Troubleshooting — no agent found, host unavailable, a tool that failed.