https://cosmograph.app/_next/static/chunks/pages/docs-app/ai-assistant-ada07ef67ab46857.js

1(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[2867],{15675:(e,s,n)=>{"use strict";n.d(s,{A:()=>a});let a={src:"/_next/static/media/ai-assistant.698b953b.png",height:1748,width:3e3,blurDataURL:"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAFCAMAAABPT11nAAAAGFBMVEUkKjMeJS8zNT8oLThEQE4rLz86OUNDP2fTPIy1AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAJ0lEQVR4nBXJsREAMAwCsQeMvf/GuagVQUSCc68CSmc9wYBn/2MJPQiNAFq2cjIrAAAAAElFTkSuQmCC",blurWidth:8,blurHeight:5}},19941:(e,s,n)=>{"use strict";n.d(s,{P:()=>d});var a=n(37876),t=n(69241),r=n(30087);let i={default:"\uD83D\uDCA1",error:"\uD83D\uDEAB",info:(0,a.jsx)(r.KS,{className:"_mt-1"}),warning:"⚠️"},o={default:(0,t.A)("_border-orange-100 _bg-orange-50 _text-orange-800 dark:_border-orange-400/30 dark:_bg-orange-400/20 dark:_text-orange-300"),error:(0,t.A)("_border-red-200 _bg-red-100 _text-red-900 dark:_border-red-200/30 dark:_bg-red-900/30 dark:_text-red-200"),info:(0,t.A)("_border-blue-200 _bg-blue-100 _text-blue-900 dark:_border-blue-200/30 dark:_bg-blue-900/30 dark:_text-blue-200"),warning:(0,t.A)("_border-yellow-100 _bg-yellow-50 _text-yellow-900 dark:_border-yellow-200/30 dark:_bg-yellow-700/30 dark:_text-yellow-200")};function d({children:e,type:s="default",emoji:n=i[s]}){return(0,a.jsxs)("div",{className:(0,t.A)("nextra-callout _overflow-x-auto _mt-6 _flex _rounded-lg _border _py-2 ltr:_pr-4 rtl:_pl-4","contrast-more:_border-current contrast-more:dark:_border-current",o[s]),children:[(0,a.jsx)("div",{className:"_select-none _text-xl ltr:_pl-3 ltr:_pr-2 rtl:_pr-3 rtl:_pl-2",style:{fontFamily:'"Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"'},children:n}),(0,a.jsx)("div",{className:"_w-full _min-w-0 _leading-7",children:e})]})}},31868:(e,s,n)=>{(window.__NEXT_P=window.__NEXT_P||[]).push(["/docs-app/ai-assistant",function(){return n(69851)}])},69851:(e,s,n)=>{"use strict";n.r(s),n.d(s,{default:()=>h,useTOC:()=>l});var a=n(37876),t=n(71807),r=n(45974),i=n(89707),o=n(15675),d=n(19941);function l(e){return[{value:"Open the Assistant",id:"open-the-assistant",depth:2},{value:"Ask questions about your data",id:"ask-questions-about-your-data",depth:2},{value:"Sessions and prompt suggestions",id:"sessions-and-prompt-suggestions",depth:2},{value:"Modes, models, and providers",id:"modes-models-and-providers",depth:2},{value:"Data and provider awareness",id:"data-and-provider-awareness",depth:2},{value:"Personal API keys",id:"personal-api-keys",depth:2},{value:"Usage and limits",id:"usage-and-limits",depth:2}]}let h=(0,t.e)(function(e){let{toc:s=l(e)}=e,n={a:"a",h1:"h1",h2:"h2",img:"img",li:"li",ol:"ol",p:"p",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{children:"AI Assistant"}),"\n",(0,a.jsx)(n.p,{children:"The AI Assistant helps you explore the data loaded in a Cosmograph project. You can ask for summaries, trends, explanations of the data structure, and other insights without leaving the project."}),"\n",(0,a.jsx)(n.p,{children:(0,a.jsx)(n.img,{alt:"Cosmograph AI Assistant analyzing a world population graph and creating a scatter plot",placeholder:"blur",src:o.A})}),"\n",(0,a.jsxs)(n.p,{children:["The Assistant is available after you sign in. All signed-in users can use the built-in Assistant within a daily allowance. Pro and Team plans include higher limits. Team also includes bring-your-own-key access to supported providers. See ",(0,a.jsx)(n.a,{href:"/docs-app/plans",children:"Plans"})," and the ",(0,a.jsx)(n.a,{href:"/pricing",children:"Cosmograph Pricing page"})," for plan information."]}),"\n",(0,a.jsx)(n.h2,{id:s[0].id,children:s[0].value}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsx)(n.li,{children:"Sign in or create a Cosmograph account."}),"\n",(0,a.jsx)(n.li,{children:"Open a project and load its data."}),"\n",(0,a.jsxs)(n.li,{children:["Open the ",(0,a.jsx)(n.strong,{children:"AI Assistant"})," panel from the project interface."]}),"\n",(0,a.jsx)(n.li,{children:"Ask a question in the composer."}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"The Assistant needs the project data to be loaded before it can analyze the graph."}),"\n",(0,a.jsx)(n.h2,{id:s[1].id,children:s[1].value}),"\n",(0,a.jsx)(n.p,{children:"You can use plain language to ask questions such as:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:"“Give me a summary of this data.”"}),"\n",(0,a.jsx)(n.li,{children:"“What are the key trends?”"}),"\n",(0,a.jsx)(n.li,{children:"“What questions can I ask to get insights from this data?”"}),"\n",(0,a.jsx)(n.li,{children:"“Help me understand the data structure.”"}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"The Assistant can run read-only queries against the project’s loaded data, return explanations, create supporting charts, and select matching points on the graph. Review generated answers against the underlying data before using them in important decisions."}),"\n",(0,a.jsx)(n.h2,{id:s[2].id,children:s[2].value}),"\n",(0,a.jsx)(n.p,{children:"Assistant conversations are organized into sessions. Use the session control to switch between conversations and keep separate questions or investigations organized."}),"\n",(0,a.jsx)(n.p,{children:"Prompt suggestions provide examples of questions to ask. You can hide the suggestions when you want more room for the conversation and show them again from the Assistant controls."}),"\n",(0,a.jsx)(n.h2,{id:s[3].id,children:s[3].value}),"\n",(0,a.jsx)(n.p,{children:"The built-in Cosmograph Assistant provides two modes:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Fast"})," for quick analysis and everyday help."]}),"\n",(0,a.jsxs)(n.li,{children:[(0,a.jsx)(n.strong,{children:"Deep"})," for harder reasoning and planning."]}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"The built-in Assistant uses Cosmograph-managed model access. Team members can also select a supported external provider and add their personal API key from the Assistant composer. The current Team catalog includes GPT-5.6 Sol, Terra, and Luna; Claude Fable 5, Opus 4.8, and Sonnet 5; and Gemini 3.5 Flash, 3.1 Flash-Lite, and 3.1 Pro Preview."}),"\n",(0,a.jsx)(n.h2,{id:s[4].id,children:s[4].value}),"\n",(0,a.jsx)(n.p,{children:"The Assistant runs its data queries against the project’s browser-based database. To answer a request, the selected model receives the conversation and the context or tool results included in that Assistant session. Query results can include sample rows used for analysis."}),"\n",(0,a.jsx)(n.p,{children:"With the built-in Assistant, this model request uses Cosmograph-managed access. With a Team personal provider, Cosmograph relays the request to that provider’s official API endpoint; it does not use Cosmograph’s OpenRouter connection. Do not use a provider with sensitive data unless its data-handling terms meet your organization’s requirements."}),"\n",(0,a.jsx)(d.P,{type:"warning",emoji:"⚠️",children:(0,a.jsx)(n.p,{children:"Treat prompts, model context, and personal API keys as sensitive. Avoid including secrets in prompts, review the selected provider before sending a request, and use your organization’s approved AI workflow for c

1onfidential data."})}),"\n",(0,a.jsx)(n.h2,{id:s[5].id,children:s[5].value}),"\n",(0,a.jsx)(n.p,{children:"Team personal API keys are stored only in this browser’s SQLRooms AI settings. They are not included in the saved or published project configuration, and are used only for the provider you select. Their availability, model catalog, usage, and billing are controlled by that provider in addition to Cosmograph’s Team plan access."}),"\n",(0,a.jsx)(n.h2,{id:s[6].id,children:s[6].value}),"\n",(0,a.jsxs)(n.p,{children:["The Assistant displays usage and context information in its controls. A session keeps prior messages, reasoning, and tool results in model context. Use ",(0,a.jsx)(n.strong,{children:"Summarize and Fork"})," from the context control to continue with a compact summary in a new session."]}),"\n",(0,a.jsx)(n.p,{children:"Daily quotas and budgets can vary by plan and may change over time. When a quota or budget is reached, the composer shows a limit notice until more usage becomes available."}),"\n",(0,a.jsxs)(n.p,{children:["The Assistant’s model selector, settings, usage indicator, and ",(0,a.jsx)(n.a,{href:"https://run.cosmograph.app/subscription",children:"Subscription page"})," are the current sources of truth for availability and access."]})]})},"/docs-app/ai-assistant",{filePath:"pages/docs-app/ai-assistant.mdx",timestamp:1784604833e3,pageMap:r.O,frontMatter:{},title:"AI Assistant"},"undefined"==typeof RemoteContent?l:RemoteContent.useTOC)}},e=>{var s=s=>e(e.s=s);e.O(0,[3629,8511,9897,4587,7590,5974,636,6593,8792],()=>s(31868)),_N_E=e.O()}]);