[{"data":1,"prerenderedAt":673},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fai-agents\u002Ftools":3},{"page":4,"navigation":590,"surround":670},{"_path":5,"_dir":6,"_draft":7,"_partial":7,"_locale":8,"title":9,"description":10,"body":11,"_type":584,"_id":585,"_source":586,"_file":587,"_stem":588,"_extension":589},"\u002Fdocs\u002Fai-agents\u002Ftools","ai-agents",false,"","Tools","Every tool the Datachef connector gives an AI agent, what it does, and what it needs.",{"type":12,"children":13,"toc":576},"root",[14,31,38,169,175,245,251,339,345,350,404,410,430],{"type":15,"tag":16,"props":17,"children":18},"element","p",{},[19,22,29],{"type":20,"value":21},"text","These are the tools an AI agent gets through the ",{"type":15,"tag":23,"props":24,"children":26},"a",{"href":25},"\u002Fdocs\u002Fai-agents\u002Fclaude-connector",[27],{"type":20,"value":28},"Claude connector",{"type":20,"value":30},". You don't call them yourself: ask Claude a question in a sentence, and it picks the right ones.",{"type":15,"tag":32,"props":33,"children":35},"h2",{"id":34},"exploring",[36],{"type":20,"value":37},"Exploring",{"type":15,"tag":39,"props":40,"children":41},"table",{},[42,61],{"type":15,"tag":43,"props":44,"children":45},"thead",{},[46],{"type":15,"tag":47,"props":48,"children":49},"tr",{},[50,56],{"type":15,"tag":51,"props":52,"children":53},"th",{},[54],{"type":20,"value":55},"Tool",{"type":15,"tag":51,"props":57,"children":58},{},[59],{"type":20,"value":60},"What it does",{"type":15,"tag":62,"props":63,"children":64},"tbody",{},[65,84,101,118,135,152],{"type":15,"tag":47,"props":66,"children":67},{},[68,79],{"type":15,"tag":69,"props":70,"children":71},"td",{},[72],{"type":15,"tag":73,"props":74,"children":76},"code",{"className":75},[],[77],{"type":20,"value":78},"list_workspaces",{"type":15,"tag":69,"props":80,"children":81},{},[82],{"type":20,"value":83},"The workspaces the connection may read, with how many tables and models each has. Usually the first call.",{"type":15,"tag":47,"props":85,"children":86},{},[87,96],{"type":15,"tag":69,"props":88,"children":89},{},[90],{"type":15,"tag":73,"props":91,"children":93},{"className":92},[],[94],{"type":20,"value":95},"list_tables",{"type":15,"tag":69,"props":97,"children":98},{},[99],{"type":20,"value":100},"Synced tables grouped by connection, with each table's SQL name, source, row count, last sync and description",{"type":15,"tag":47,"props":102,"children":103},{},[104,113],{"type":15,"tag":69,"props":105,"children":106},{},[107],{"type":15,"tag":73,"props":108,"children":110},{"className":109},[],[111],{"type":20,"value":112},"describe_table",{"type":15,"tag":69,"props":114,"children":115},{},[116],{"type":20,"value":117},"A table's columns, types and your team's notes",{"type":15,"tag":47,"props":119,"children":120},{},[121,130],{"type":15,"tag":69,"props":122,"children":123},{},[124],{"type":15,"tag":73,"props":125,"children":127},{"className":126},[],[128],{"type":20,"value":129},"list_models",{"type":15,"tag":69,"props":131,"children":132},{},[133],{"type":20,"value":134},"Saved models, with their descriptions",{"type":15,"tag":47,"props":136,"children":137},{},[138,147],{"type":15,"tag":69,"props":139,"children":140},{},[141],{"type":15,"tag":73,"props":142,"children":144},{"className":143},[],[145],{"type":20,"value":146},"get_model",{"type":15,"tag":69,"props":148,"children":149},{},[150],{"type":20,"value":151},"A model's SQL, description, current version and version history",{"type":15,"tag":47,"props":153,"children":154},{},[155,164],{"type":15,"tag":69,"props":156,"children":157},{},[158],{"type":15,"tag":73,"props":159,"children":161},{"className":160},[],[162],{"type":20,"value":163},"get_lineage",{"type":15,"tag":69,"props":165,"children":166},{},[167],{"type":20,"value":168},"What a model reads, what reads it, and which tabs use it. Owners and admins also see how often it's queried.",{"type":15,"tag":32,"props":170,"children":172},{"id":171},"querying",[173],{"type":20,"value":174},"Querying",{"type":15,"tag":39,"props":176,"children":177},{},[178,192],{"type":15,"tag":43,"props":179,"children":180},{},[181],{"type":15,"tag":47,"props":182,"children":183},{},[184,188],{"type":15,"tag":51,"props":185,"children":186},{},[187],{"type":20,"value":55},{"type":15,"tag":51,"props":189,"children":190},{},[191],{"type":20,"value":60},{"type":15,"tag":62,"props":193,"children":194},{},[195,228],{"type":15,"tag":47,"props":196,"children":197},{},[198,207],{"type":15,"tag":69,"props":199,"children":200},{},[201],{"type":15,"tag":73,"props":202,"children":204},{"className":203},[],[205],{"type":20,"value":206},"run_query",{"type":15,"tag":69,"props":208,"children":209},{},[210,212,218,220,226],{"type":20,"value":211},"Runs one read-only ",{"type":15,"tag":73,"props":213,"children":215},{"className":214},[],[216],{"type":20,"value":217},"SELECT",{"type":20,"value":219}," in ",{"type":15,"tag":23,"props":221,"children":223},{"href":222},"\u002Fdocs\u002Fanalysis\u002Fsql-editor#dialect",[224],{"type":20,"value":225},"DuckDB's dialect",{"type":20,"value":227},". Results are capped, and marked as truncated when there's more.",{"type":15,"tag":47,"props":229,"children":230},{},[231,240],{"type":15,"tag":69,"props":232,"children":233},{},[234],{"type":15,"tag":73,"props":235,"children":237},{"className":236},[],[238],{"type":20,"value":239},"validate_sql",{"type":15,"tag":69,"props":241,"children":242},{},[243],{"type":20,"value":244},"Checks that SQL parses and would be allowed, without running it",{"type":15,"tag":32,"props":246,"children":248},{"id":247},"connections-and-syncs",[249],{"type":20,"value":250},"Connections and syncs",{"type":15,"tag":39,"props":252,"children":253},{},[254,268],{"type":15,"tag":43,"props":255,"children":256},{},[257],{"type":15,"tag":47,"props":258,"children":259},{},[260,264],{"type":15,"tag":51,"props":261,"children":262},{},[263],{"type":20,"value":55},{"type":15,"tag":51,"props":265,"children":266},{},[267],{"type":20,"value":60},{"type":15,"tag":62,"props":269,"children":270},{},[271,288,305,322],{"type":15,"tag":47,"props":272,"children":273},{},[274,283],{"type":15,"tag":69,"props":275,"children":276},{},[277],{"type":15,"tag":73,"props":278,"children":280},{"className":279},[],[281],{"type":20,"value":282},"list_connections",{"type":15,"tag":69,"props":284,"children":285},{},[286],{"type":20,"value":287},"Each connection's kind, status, synced-table count and non-secret settings",{"type":15,"tag":47,"props":289,"children":290},{},[291,300],{"type":15,"tag":69,"props":292,"children":293},{},[294],{"type":15,"tag":73,"props":295,"children":297},{"className":296},[],[298],{"type":20,"value":299},"describe_connection",{"type":15,"tag":69,"props":301,"children":302},{},[303],{"type":20,"value":304},"Every table a connection offers, whether it's synced and under what name, its mode, cursor and schedule, and its last and next sync",{"type":15,"tag":47,"props":306,"children":307},{},[308,317],{"type":15,"tag":69,"props":309,"children":310},{},[311],{"type":15,"tag":73,"props":312,"children":314},{"className":313},[],[315],{"type":20,"value":316},"describe_source_table",{"type":15,"tag":69,"props":318,"children":319},{},[320],{"type":20,"value":321},"Every column a source table offers and which are synced, its primary key, cursor options and the recommended sync settings",{"type":15,"tag":47,"props":323,"children":324},{},[325,334],{"type":15,"tag":69,"props":326,"children":327},{},[328],{"type":15,"tag":73,"props":329,"children":331},{"className":330},[],[332],{"type":20,"value":333},"get_sync_status",{"type":15,"tag":69,"props":335,"children":336},{},[337],{"type":20,"value":338},"Queued and running syncs, and recent runs with their outcome, row counts and errors",{"type":15,"tag":32,"props":340,"children":342},{"id":341},"query-activity",[343],{"type":20,"value":344},"Query activity",{"type":15,"tag":16,"props":346,"children":347},{},[348],{"type":20,"value":349},"For organization owners and admins only.",{"type":15,"tag":39,"props":351,"children":352},{},[353,367],{"type":15,"tag":43,"props":354,"children":355},{},[356],{"type":15,"tag":47,"props":357,"children":358},{},[359,363],{"type":15,"tag":51,"props":360,"children":361},{},[362],{"type":20,"value":55},{"type":15,"tag":51,"props":364,"children":365},{},[366],{"type":20,"value":60},{"type":15,"tag":62,"props":368,"children":369},{},[370,387],{"type":15,"tag":47,"props":371,"children":372},{},[373,382],{"type":15,"tag":69,"props":374,"children":375},{},[376],{"type":15,"tag":73,"props":377,"children":379},{"className":378},[],[380],{"type":20,"value":381},"list_query_activity",{"type":15,"tag":69,"props":383,"children":384},{},[385],{"type":20,"value":386},"The log of queries and questions, page by page",{"type":15,"tag":47,"props":388,"children":389},{},[390,399],{"type":15,"tag":69,"props":391,"children":392},{},[393],{"type":15,"tag":73,"props":394,"children":396},{"className":395},[],[397],{"type":20,"value":398},"summarize_query_activity",{"type":15,"tag":69,"props":400,"children":401},{},[402],{"type":20,"value":403},"Usage by person, kind and source, error rate, the most-used tables, models and questions, and the slowest and failing queries, over up to 365 days",{"type":15,"tag":32,"props":405,"children":407},{"id":406},"making-changes",[408],{"type":20,"value":409},"Making changes",{"type":15,"tag":16,"props":411,"children":412},{},[413,415,421,423,428],{"type":20,"value":414},"These need ",{"type":15,"tag":416,"props":417,"children":418},"strong",{},[419],{"type":20,"value":420},"Allow changes",{"type":20,"value":422}," ticked when you connected, and the ",{"type":15,"tag":416,"props":424,"children":425},{},[426],{"type":20,"value":427},"Editor",{"type":20,"value":429}," role in the workspace. Ask Claude to confirm before it makes a change.",{"type":15,"tag":39,"props":431,"children":432},{},[433,447],{"type":15,"tag":43,"props":434,"children":435},{},[436],{"type":15,"tag":47,"props":437,"children":438},{},[439,443],{"type":15,"tag":51,"props":440,"children":441},{},[442],{"type":20,"value":55},{"type":15,"tag":51,"props":444,"children":445},{},[446],{"type":20,"value":60},{"type":15,"tag":62,"props":448,"children":449},{},[450,467,484,501,518,535,559],{"type":15,"tag":47,"props":451,"children":452},{},[453,462],{"type":15,"tag":69,"props":454,"children":455},{},[456],{"type":15,"tag":73,"props":457,"children":459},{"className":458},[],[460],{"type":20,"value":461},"set_table_syncing",{"type":15,"tag":69,"props":463,"children":464},{},[465],{"type":20,"value":466},"Turns a table's sync on or off. Turning it off keeps the rows already synced.",{"type":15,"tag":47,"props":468,"children":469},{},[470,479],{"type":15,"tag":69,"props":471,"children":472},{},[473],{"type":15,"tag":73,"props":474,"children":476},{"className":475},[],[477],{"type":20,"value":478},"set_sync_settings",{"type":15,"tag":69,"props":480,"children":481},{},[482],{"type":20,"value":483},"Sets a table's mode, cursor and schedule (an interval of at least 5 minutes, a cron expression, or manual), or applies the recommended settings",{"type":15,"tag":47,"props":485,"children":486},{},[487,496],{"type":15,"tag":69,"props":488,"children":489},{},[490],{"type":15,"tag":73,"props":491,"children":493},{"className":492},[],[494],{"type":20,"value":495},"set_synced_columns",{"type":15,"tag":69,"props":497,"children":498},{},[499],{"type":20,"value":500},"Adds or removes synced columns",{"type":15,"tag":47,"props":502,"children":503},{},[504,513],{"type":15,"tag":69,"props":505,"children":506},{},[507],{"type":15,"tag":73,"props":508,"children":510},{"className":509},[],[511],{"type":20,"value":512},"sync_table",{"type":15,"tag":69,"props":514,"children":515},{},[516],{"type":20,"value":517},"Syncs one table now",{"type":15,"tag":47,"props":519,"children":520},{},[521,530],{"type":15,"tag":69,"props":522,"children":523},{},[524],{"type":15,"tag":73,"props":525,"children":527},{"className":526},[],[528],{"type":20,"value":529},"sync_connection",{"type":15,"tag":69,"props":531,"children":532},{},[533],{"type":20,"value":534},"Syncs every table in a connection now",{"type":15,"tag":47,"props":536,"children":537},{},[538,547],{"type":15,"tag":69,"props":539,"children":540},{},[541],{"type":15,"tag":73,"props":542,"children":544},{"className":543},[],[545],{"type":20,"value":546},"create_model",{"type":15,"tag":69,"props":548,"children":549},{},[550,552,557],{"type":20,"value":551},"Saves a ",{"type":15,"tag":73,"props":553,"children":555},{"className":554},[],[556],{"type":20,"value":217},{"type":20,"value":558}," as a new model with a lower-snake-case name",{"type":15,"tag":47,"props":560,"children":561},{},[562,571],{"type":15,"tag":69,"props":563,"children":564},{},[565],{"type":15,"tag":73,"props":566,"children":568},{"className":567},[],[569],{"type":20,"value":570},"update_model",{"type":15,"tag":69,"props":572,"children":573},{},[574],{"type":20,"value":575},"Changes a model's SQL, name or description, with an optional note for its history. Refused if the model was saved by someone else since Claude last read it.",{"title":8,"searchDepth":577,"depth":577,"links":578},2,[579,580,581,582,583],{"id":34,"depth":577,"text":37},{"id":171,"depth":577,"text":174},{"id":247,"depth":577,"text":250},{"id":341,"depth":577,"text":344},{"id":406,"depth":577,"text":409},"markdown","content:docs:5.ai-agents:2.tools.md","content","docs\u002F5.ai-agents\u002F2.tools.md","docs\u002F5.ai-agents\u002F2.tools","md",[591],{"title":592,"_path":593,"children":594},"Welcome","\u002Fdocs",[595,596,606,628,644,651,657],{"title":592,"_path":593},{"title":597,"_path":598,"children":599},"Getting started","\u002Fdocs\u002Fgetting-started",[600,603],{"title":601,"_path":602},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart",{"title":604,"_path":605},"Key concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts",{"title":607,"_path":608,"children":609},"Connecting data","\u002Fdocs\u002Fconnections",[610,613,616,619,622,625],{"title":611,"_path":612},"Overview","\u002Fdocs\u002Fconnections\u002Foverview",{"title":614,"_path":615},"Sync settings","\u002Fdocs\u002Fconnections\u002Fsync-settings",{"title":617,"_path":618},"Salesforce","\u002Fdocs\u002Fconnections\u002Fsalesforce",{"title":620,"_path":621},"Marketo","\u002Fdocs\u002Fconnections\u002Fmarketo",{"title":623,"_path":624},"Google Analytics 4","\u002Fdocs\u002Fconnections\u002Fgoogle-analytics-4",{"title":626,"_path":627},"PostgreSQL and MySQL","\u002Fdocs\u002Fconnections\u002Fpostgres-mysql",{"title":629,"_path":630,"children":631},"Analysis","\u002Fdocs\u002Fanalysis",[632,635,638,641],{"title":633,"_path":634},"Asking questions","\u002Fdocs\u002Fanalysis\u002Fask-a-question",{"title":636,"_path":637},"SQL editor","\u002Fdocs\u002Fanalysis\u002Fsql-editor",{"title":639,"_path":640},"Charts","\u002Fdocs\u002Fanalysis\u002Fcharts",{"title":642,"_path":643},"Tabs and sharing","\u002Fdocs\u002Fanalysis\u002Ftabs-and-sharing",{"title":645,"_path":646,"children":647},"Models","\u002Fdocs\u002Fmodels",[648],{"title":649,"_path":650},"Working with models","\u002Fdocs\u002Fmodels\u002Foverview",{"title":652,"_path":653,"children":654},"AI agents","\u002Fdocs\u002Fai-agents",[655,656],{"title":28,"_path":25},{"title":9,"_path":5},{"title":658,"_path":659,"children":660},"Administration","\u002Fdocs\u002Fadministration",[661,664,667],{"title":662,"_path":663},"People and roles","\u002Fdocs\u002Fadministration\u002Fpeople-and-roles",{"title":665,"_path":666},"Sign-in and SSO","\u002Fdocs\u002Fadministration\u002Fsign-in-and-sso",{"title":668,"_path":669},"Security","\u002Fdocs\u002Fadministration\u002Fsecurity",[671,672],{"_path":25,"title":28},{"_path":663,"title":662},1792546943323]