[{"data":1,"prerenderedAt":399},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fanalysis\u002Fask-a-question":3},{"page":4,"navigation":315,"surround":396},{"_path":5,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":9,"description":10,"body":11,"_type":309,"_id":310,"_source":311,"_file":312,"_stem":313,"_extension":314},"\u002Fdocs\u002Fanalysis\u002Fask-a-question","analysis",false,"","Asking questions","Ask the agent a question in a sentence, in any language, and get back SQL, a chart, and the assumptions it made.",{"type":12,"children":13,"toc":299},"root",[14,38,45,50,62,76,82,140,145,151,172,178,183,203,209,214,220,240,246],{"type":15,"tag":16,"props":17,"children":18},"element","p",{},[19,22,28,30,36],{"type":20,"value":21},"text","The ",{"type":15,"tag":23,"props":24,"children":25},"strong",{},[26],{"type":20,"value":27},"Agent",{"type":20,"value":29}," page answers questions about your data. Ask in a sentence, such as ",{"type":15,"tag":31,"props":32,"children":33},"em",{},[34],{"type":20,"value":35},"\"Which lead sources produced the most closed-won revenue this year?\"",{"type":20,"value":37},", and Datachef writes the SQL, runs it, and charts the result.",{"type":15,"tag":39,"props":40,"children":42},"h2",{"id":41},"ask-in-your-own-language",[43],{"type":20,"value":44},"Ask in your own language",{"type":15,"tag":16,"props":46,"children":47},{},[48],{"type":20,"value":49},"Ask in whichever language you work in, and the answer comes back in it too:",{"type":15,"tag":51,"props":52,"children":53},"blockquote",{},[54],{"type":15,"tag":16,"props":55,"children":56},{},[57],{"type":15,"tag":31,"props":58,"children":59},{},[60],{"type":20,"value":61},"¿Cuál es el valor de las oportunidades de venta abiertas que se consideran de calidad?",{"type":15,"tag":16,"props":63,"children":64},{},[65,67,74],{"type":20,"value":66},"Datachef reads the question, writes the SQL against your tables, and explains the result and its assumptions in Spanish. If your workspace has a ",{"type":15,"tag":68,"props":69,"children":71},"code",{"className":70},[],[72],{"type":20,"value":73},"qualified_pipeline",{"type":20,"value":75}," model, it's used here too, whatever language the question is in.",{"type":15,"tag":39,"props":77,"children":79},{"id":78},"what-an-answer-includes",[80],{"type":20,"value":81},"What an answer includes",{"type":15,"tag":83,"props":84,"children":85},"ul",{},[86,106,117,129],{"type":15,"tag":87,"props":88,"children":89},"li",{},[90,92,97,99,104],{"type":20,"value":91},"A ",{"type":15,"tag":23,"props":93,"children":94},{},[95],{"type":20,"value":96},"title",{"type":20,"value":98}," and the ",{"type":15,"tag":23,"props":100,"children":101},{},[102],{"type":20,"value":103},"result",{"type":20,"value":105},", with a chart chosen to fit it.",{"type":15,"tag":87,"props":107,"children":108},{},[109,110,115],{"type":20,"value":21},{"type":15,"tag":23,"props":111,"children":112},{},[113],{"type":20,"value":114},"SQL",{"type":20,"value":116}," it ran, which you can open and edit in the SQL editor.",{"type":15,"tag":87,"props":118,"children":119},{},[120,122,127],{"type":20,"value":121},"An ",{"type":15,"tag":23,"props":123,"children":124},{},[125],{"type":20,"value":126},"explanation",{"type":20,"value":128}," of what the query does.",{"type":15,"tag":87,"props":130,"children":131},{},[132,133,138],{"type":20,"value":21},{"type":15,"tag":23,"props":134,"children":135},{},[136],{"type":20,"value":137},"assumptions",{"type":20,"value":139}," it made, such as which stage counts as closed-won, or which date it filtered on. Read these first. They're where a plausible-looking answer can quietly differ from what you meant.",{"type":15,"tag":16,"props":141,"children":142},{},[143],{"type":20,"value":144},"If the SQL fails, the agent tries to fix it once before reporting the error.",{"type":15,"tag":39,"props":146,"children":148},{"id":147},"it-uses-your-models",[149],{"type":20,"value":150},"It uses your models",{"type":15,"tag":16,"props":152,"children":153},{},[154,156,163,165,170],{"type":20,"value":155},"The agent is given your workspace's ",{"type":15,"tag":157,"props":158,"children":160},"a",{"href":159},"\u002Fdocs\u002Fmodels\u002Foverview",[161],{"type":20,"value":162},"models",{"type":20,"value":164}," along with its tables. If you've saved a ",{"type":15,"tag":68,"props":166,"children":168},{"className":167},[],[169],{"type":20,"value":73},{"type":20,"value":171}," model, a question about qualified pipeline is answered with your definition, not one the agent made up. The best way to get consistent answers is to save the definitions your team agrees on as models.",{"type":15,"tag":39,"props":173,"children":175},{"id":174},"long-running-questions",[176],{"type":20,"value":177},"Long-running questions",{"type":15,"tag":16,"props":179,"children":180},{},[181],{"type":20,"value":182},"A question runs in the background for up to five minutes. While it runs:",{"type":15,"tag":83,"props":184,"children":185},{},[186,198],{"type":15,"tag":87,"props":187,"children":188},{},[189,191,196],{"type":20,"value":190},"The question is locked. Choose ",{"type":15,"tag":23,"props":192,"children":193},{},[194],{"type":20,"value":195},"Stop",{"type":20,"value":197}," to cancel it and edit the question.",{"type":15,"tag":87,"props":199,"children":200},{},[201],{"type":20,"value":202},"Leaving the page doesn't stop it. The answer is saved on the tab, so reopen the tab to see it.",{"type":15,"tag":39,"props":204,"children":206},{"id":205},"whats-sent-to-the-ai-model",[207],{"type":20,"value":208},"What's sent to the AI model",{"type":15,"tag":16,"props":210,"children":211},{},[212],{"type":20,"value":213},"Only your question and your workspace's schema (table names, column names and types, and model definitions) are sent to the AI model provider. Your rows aren't sent. The query runs inside Datachef, against your synced data.",{"type":15,"tag":39,"props":215,"children":217},{"id":216},"usage-allowance",[218],{"type":20,"value":219},"Usage allowance",{"type":15,"tag":16,"props":221,"children":222},{},[223,225,230,232,238],{"type":20,"value":224},"Each organization has a monthly allowance of AI tokens, which depends on your plan. Owners and admins can see usage under ",{"type":15,"tag":23,"props":226,"children":227},{},[228],{"type":20,"value":229},"Settings → Usage",{"type":20,"value":231},". When the allowance runs out, the agent stops answering until the next month. Querying in the SQL editor isn't affected. ",{"type":15,"tag":157,"props":233,"children":235},{"href":234},"\u002Fcontact",[236],{"type":20,"value":237},"Contact us",{"type":20,"value":239}," to raise the limit.",{"type":15,"tag":39,"props":241,"children":243},{"id":242},"tips",[244],{"type":20,"value":245},"Tips",{"type":15,"tag":83,"props":247,"children":248},{},[249,273,289],{"type":15,"tag":87,"props":250,"children":251},{},[252,257,259,264,266,271],{"type":15,"tag":23,"props":253,"children":254},{},[255],{"type":20,"value":256},"Name the systems and the time range.",{"type":20,"value":258}," ",{"type":15,"tag":31,"props":260,"children":261},{},[262],{"type":20,"value":263},"\"Closed-won Salesforce opportunities in Q3, by Marketo lead source\"",{"type":20,"value":265}," beats ",{"type":15,"tag":31,"props":267,"children":268},{},[269],{"type":20,"value":270},"\"how did marketing do?\"",{"type":20,"value":272},".",{"type":15,"tag":87,"props":274,"children":275},{},[276,281,282,287],{"type":15,"tag":23,"props":277,"children":278},{},[279],{"type":20,"value":280},"Ask for the definition you want.",{"type":20,"value":258},{"type":15,"tag":31,"props":283,"children":284},{},[285],{"type":20,"value":286},"\"Count a customer as active if they had a usage event in the last 30 days.\"",{"type":20,"value":288}," Then save the answer as a model so nobody has to say it again.",{"type":15,"tag":87,"props":290,"children":291},{},[292,297],{"type":15,"tag":23,"props":293,"children":294},{},[295],{"type":20,"value":296},"Check the assumptions",{"type":20,"value":298}," before you share the number.",{"title":8,"searchDepth":300,"depth":300,"links":301},2,[302,303,304,305,306,307,308],{"id":41,"depth":300,"text":44},{"id":78,"depth":300,"text":81},{"id":147,"depth":300,"text":150},{"id":174,"depth":300,"text":177},{"id":205,"depth":300,"text":208},{"id":216,"depth":300,"text":219},{"id":242,"depth":300,"text":245},"markdown","content:docs:3.analysis:1.ask-a-question.md","content","docs\u002F3.analysis\u002F1.ask-a-question.md","docs\u002F3.analysis\u002F1.ask-a-question","md",[316],{"title":317,"_path":318,"children":319},"Welcome","\u002Fdocs",[320,321,331,353,367,373,383],{"title":317,"_path":318},{"title":322,"_path":323,"children":324},"Getting started","\u002Fdocs\u002Fgetting-started",[325,328],{"title":326,"_path":327},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart",{"title":329,"_path":330},"Key concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts",{"title":332,"_path":333,"children":334},"Connecting data","\u002Fdocs\u002Fconnections",[335,338,341,344,347,350],{"title":336,"_path":337},"Overview","\u002Fdocs\u002Fconnections\u002Foverview",{"title":339,"_path":340},"Sync settings","\u002Fdocs\u002Fconnections\u002Fsync-settings",{"title":342,"_path":343},"Salesforce","\u002Fdocs\u002Fconnections\u002Fsalesforce",{"title":345,"_path":346},"Marketo","\u002Fdocs\u002Fconnections\u002Fmarketo",{"title":348,"_path":349},"Google Analytics 4","\u002Fdocs\u002Fconnections\u002Fgoogle-analytics-4",{"title":351,"_path":352},"PostgreSQL and MySQL","\u002Fdocs\u002Fconnections\u002Fpostgres-mysql",{"title":354,"_path":355,"children":356},"Analysis","\u002Fdocs\u002Fanalysis",[357,358,361,364],{"title":9,"_path":5},{"title":359,"_path":360},"SQL editor","\u002Fdocs\u002Fanalysis\u002Fsql-editor",{"title":362,"_path":363},"Charts","\u002Fdocs\u002Fanalysis\u002Fcharts",{"title":365,"_path":366},"Tabs and sharing","\u002Fdocs\u002Fanalysis\u002Ftabs-and-sharing",{"title":368,"_path":369,"children":370},"Models","\u002Fdocs\u002Fmodels",[371],{"title":372,"_path":159},"Working with models",{"title":374,"_path":375,"children":376},"AI agents","\u002Fdocs\u002Fai-agents",[377,380],{"title":378,"_path":379},"Claude connector","\u002Fdocs\u002Fai-agents\u002Fclaude-connector",{"title":381,"_path":382},"Tools","\u002Fdocs\u002Fai-agents\u002Ftools",{"title":384,"_path":385,"children":386},"Administration","\u002Fdocs\u002Fadministration",[387,390,393],{"title":388,"_path":389},"People and roles","\u002Fdocs\u002Fadministration\u002Fpeople-and-roles",{"title":391,"_path":392},"Sign-in and SSO","\u002Fdocs\u002Fadministration\u002Fsign-in-and-sso",{"title":394,"_path":395},"Security","\u002Fdocs\u002Fadministration\u002Fsecurity",[397,398],{"_path":352,"title":351},{"_path":360,"title":359},1792546943111]