[{"data":1,"prerenderedAt":408},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fai-chat\u002Fusing-ai-chat":3},{"id":4,"title":5,"body":6,"description":399,"extension":400,"meta":401,"navigation":402,"path":403,"redirect":404,"seo":405,"stem":406,"__hash__":407},"docs\u002Fdocs\u002Fai-chat\u002Fusing-ai-chat.md","Using AI Chat",{"type":7,"value":8,"toc":385},"minimark",[9,13,23,28,36,43,94,106,110,116,135,142,150,156,160,167,180,184,187,214,221,226,230,234,260,264,271,299,306,310,328,332,335,339,351,355],[10,11,5],"h1",{"id":12},"using-ai-chat",[14,15,16,17,22],"p",{},"Once you have an ",[18,19,21],"a",{"href":20},"\u002Fdocs\u002Fai-chat\u002Fagents","agent set up",", this is the day-to-day: how\nto point the chat at the right thing, move between chats, and read what it's\ncosting.",[24,25,27],"h2",{"id":26},"scope-what-the-chat-is-about","Scope — what the chat is about",[14,29,30,31,35],{},"Every chat has a ",[32,33,34],"strong",{},"scope",", shown as a labelled chip next to \"AI Chat\" in the\nheader. The scope tells the assistant what to answer about, so it doesn't have to\nenumerate your whole workspace first.",[14,37,38,39,42],{},"You set it by ",[32,40,41],{},"where you open the chat from",":",[44,45,46,62],"ul",{},[47,48,49,50,53,54,57,58,61],"li",{},"The ",[32,51,52],{},"AI Chat"," sidebar button opens a workspace chat — ",[32,55,56],{},"All streams"," (from\nthe Streams page) or ",[32,59,60],{},"All connections"," (from Data Explorer).",[47,63,64,67,68,71,72,75,76,75,79,82,83,75,86,89,90,93],{},[32,65,66],{},"Ask AI"," buttons across the app open a chat already scoped to a ",[32,69,70],{},"table"," or\n",[32,73,74],{},"view",", a ",[32,77,78],{},"file",[32,80,81],{},"connection"," or ",[32,84,85],{},"database",[32,87,88],{},"SQL console","\n(including a multi-source federated one), or a ",[32,91,92],{},"stream config",".",[14,95,96,97,101,102,105],{},"The chip always names the current scope, so you can tell at a glance whether\nyou're asking about ",[98,99,100],"em",{},"this"," config or ",[98,103,104],{},"all"," streams.",[24,107,109],{"id":108},"switch-scope","Switch scope",[14,111,112,113,115],{},"The scope chip is also a switcher — click it to jump between chats without hunting\nfor the right ",[32,114,66],{}," button:",[44,117,118,129],{},[47,119,120,122,123,122,125,128],{},[32,121,56],{},", ",[32,124,60],{},[32,126,127],{},"Workspace"," — the broad scopes, always\navailable.",[47,130,131,134],{},[32,132,133],{},"Recent"," — chats you've opened lately, so you can hop back to a specific\nconfig or database.",[14,136,137,138,141],{},"Switching is safe: each scope keeps its ",[32,139,140],{},"own"," conversation, so moving between\nthem loses nothing.",[143,144],"img",{"className":145,"src":148,"alt":149},[146,147],"block","dark:hidden","\u002Fdocs\u002Fimages\u002Fgenerated\u002Fai-chat-scope-switcher-light.png","AI Chat scope switcher showing All streams, All connections, Workspace, and recent chats",[143,151],{"className":152,"src":155,"alt":149},[153,154],"hidden","dark:block","\u002Fdocs\u002Fimages\u002Fgenerated\u002Fai-chat-scope-switcher-dark.png",[24,157,159],{"id":158},"suggestions","Suggestions",[14,161,162,163,166],{},"A fresh chat shows a few ",[32,164,165],{},"one-click suggestions"," tuned to its scope — e.g.\n\"List my stream configs\", \"Find tables without primary keys\", \"Show the first\nrows\" for a file, or \"Compare a table with a file\" in a multi-source console.\nThey're starting points; click one, or just type your own question.",[14,168,169,170,122,173,122,176,179],{},"In a SQL console with a query in the editor, the suggestions become\nquery-specific — ",[32,171,172],{},"Explain current SQL",[32,174,175],{},"Optimize this query",[32,177,178],{},"Suggest\nindexes for this query"," — and attach the editor's query for you.",[24,181,183],{"id":182},"watch-the-work","Watch the work",[14,185,186],{},"While answering, the chat shows a card for every DBConvert tool the agent calls.\nThe card names the tool and shows its status:",[44,188,189,195,204],{},[47,190,191,194],{},[32,192,193],{},"completed"," — the tool returned its result to the agent.",[47,196,197,82,200,203],{},[32,198,199],{},"in progress",[32,201,202],{},"pending"," — the agent is still working.",[47,205,206,209,210,213],{},[32,207,208],{},"failed"," — that one attempt did not work; the agent may still recover and\ngive a useful answer. Expand ",[32,211,212],{},"Details"," on a failed card when it is relevant.",[14,215,216,217,220],{},"Click ",[32,218,219],{},"Stop"," beside the composer to cancel a turn that is taking too long.",[143,222],{"className":223,"src":224,"alt":225},[146,147],"\u002Fdocs\u002Fimages\u002Fgenerated\u002Fai-chat-stream-analysis-light.png","AI Chat stream analysis with completed read-only tool cards and a formatted answer",[143,227],{"className":228,"src":229,"alt":225},[153,154],"\u002Fdocs\u002Fimages\u002Fgenerated\u002Fai-chat-stream-analysis-dark.png",[24,231,233],{"id":232},"sessions-and-memory","Sessions and memory",[44,235,236,242,249],{},[47,237,238,241],{},[32,239,240],{},"New"," (header) starts a fresh conversation in the current scope.",[47,243,244,245,248],{},"Each scope is its own thread and its history ",[32,246,247],{},"persists"," while the app is open,\nso switching away and back — or closing and reopening the panel — resumes right\nwhere you left off, with the agent still remembering the conversation.",[47,250,251,252,255,256,259],{},"To keep things light, only a few agents stay ",[98,253,254],{},"live"," at once; older chats are put\nto sleep and ",[32,257,258],{},"reattached with their memory"," when you return. (GitHub Copilot\nCLI is the exception — it can't reattach, so returning to a slept Copilot chat\nstarts a fresh session; the transcript is still on screen.)",[24,261,263],{"id":262},"usage-and-cost","Usage and cost",[14,265,266,267,42],{},"The header badge shows this chat's usage — for example ",[268,269,270],"code",{},"↑812 ↓239 · ctx 11% · $0.0000",[44,272,273,283,289],{},[47,274,275,278,279,282],{},[32,276,277],{},"↑"," input tokens (sent to the model) and ",[32,280,281],{},"↓"," output tokens (its reply) for\nthe latest turn.",[47,284,285,288],{},[32,286,287],{},"ctx N%"," — how full the model's context window is; it climbs as the\nconversation grows.",[47,290,291,294,295,298],{},[32,292,293],{},"$"," — the session's running cost. It reads ",[268,296,297],{},"$0.0000"," on a free model; paid\nproviders show the real amount.",[14,300,301,302,305],{},"Hover the badge for exact numbers. Costs are billed by ",[32,303,304],{},"your"," provider, not\nDBConvert.",[24,307,309],{"id":308},"reuse-an-answer","Reuse an answer",[14,311,312,313,82,316,319,320,323,324,327],{},"Hover an AI response to ",[32,314,315],{},"Copy answer",[32,317,318],{},"Download .md",". A runnable SQL\nblock has its own ",[32,321,322],{},"Copy"," action and, when the chat belongs to the matching SQL\nconsole, ",[32,325,326],{},"Insert into editor",". Inserting replaces the editor's current query;\nreview it before you run it.",[24,329,331],{"id":330},"agent-settings","Agent settings",[14,333,334],{},"The provider and model chip opens the selected agent's settings. The available\noptions differ by provider. AI Chat only lets an agent use DBConvert's\nread-only tools — it does not grant the agent's own shell, filesystem, or\ncode-editing tools.",[24,336,338],{"id":337},"export-a-conversation","Export a conversation",[14,340,341,342,344,345,82,348,350],{},"Click the ",[32,343,281],{}," icon in the header to ",[32,346,347],{},"Copy as Markdown",[32,349,318],{}," —\nhandy for saving a good analysis or pasting a transcript into an issue.",[24,352,354],{"id":353},"next","Next",[44,356,357,364,371,378],{},[47,358,359,363],{},[18,360,362],{"href":361},"\u002Fdocs\u002Fai-chat\u002Fgenerate-sql","Generate SQL"," — the same engine in the SQL editor.",[47,365,366,370],{},[18,367,369],{"href":368},"\u002Fdocs\u002Fai-chat\u002Ffix-failed-query","Fix a failed query"," — repair a SQL error the\nsame way.",[47,372,373,377],{},[18,374,376],{"href":375},"\u002Fdocs\u002Fai-chat\u002Fexamples","Examples"," — real exchanges end to end.",[47,379,380,384],{},[18,381,383],{"href":382},"\u002Fdocs\u002Fmcp\u002Fsafety-and-privacy","Safety & privacy"," — what reaches your model\nprovider.",{"title":386,"searchDepth":387,"depth":387,"links":388},"",2,[389,390,391,392,393,394,395,396,397,398],{"id":26,"depth":387,"text":27},{"id":108,"depth":387,"text":109},{"id":158,"depth":387,"text":159},{"id":182,"depth":387,"text":183},{"id":232,"depth":387,"text":233},{"id":262,"depth":387,"text":263},{"id":308,"depth":387,"text":309},{"id":330,"depth":387,"text":331},{"id":337,"depth":387,"text":338},{"id":353,"depth":387,"text":354},"Scope a chat to what you're looking at, switch scopes, use one-click suggestions, and understand sessions, memory, and the usage badge.","md",{},false,"\u002Fdocs\u002Fai-chat\u002Fusing-ai-chat",null,{"title":5,"description":399},"docs\u002Fai-chat\u002Fusing-ai-chat","A2dvUQ9B8CNi_gPK-F2jNfeq6Pm6tkTEBsfn45vOzXU",1784670668657]