[{"data":1,"prerenderedAt":516},["ShallowReactive",2],{"guide:en:field-operations/ai-assistant":3},{"id":4,"title":5,"body":6,"description":508,"extension":509,"meta":510,"navigation":511,"path":512,"seo":513,"stem":514,"__hash__":515},"guide_en/en/user/field-operations/ai-assistant.md","AI Assistant — Natural Language Search and Map Queries",{"type":7,"value":8,"toc":479},"minimark",[9,14,18,23,26,31,59,63,66,76,82,86,103,107,110,114,121,124,128,131,135,151,155,169,173,176,184,187,201,205,208,219,223,230,232,236,239,243,246,260,263,277,281,292,294,298,305,309,312,326,330,333,353,356,374,378,385,396,400,440,449,451,455,461,467,473],[10,11,13],"h1",{"id":12},"ai-assistant","AI Assistant",[15,16,17],"p",{},"Aptli's AI assistant accelerates data discovery across your asset and operations data. Ask a question in plain language — \"show me cable runs near the substation\" or \"which sites are below minimum stock?\" — and the system searches your map features, work orders, and database before calling the AI provider. You can also draw a lasso area on the map to query everything within it, and the AI helps map column headers when importing CSV or XLSX files.",[19,20,22],"h2",{"id":21},"ai-toolbar","AI Toolbar",[15,24,25],{},"The AI toolbar is the primary way to ask questions about your data. It appears in the top navigation bar (desktop) and is accessible from the map page on mobile.",[27,28,30],"h3",{"id":29},"opening-the-toolbar","Opening the Toolbar",[32,33,34,47,53],"ul",{},[35,36,37,41,42,46],"li",{},[38,39,40],"strong",{},"Keyboard shortcut:"," ",[43,44,45],"code",{},"Enter"," (when no input field is focused) opens the AI input immediately",[35,48,49,52],{},[38,50,51],{},"Click:"," tap the AI icon in the toolbar",[35,54,55,58],{},[38,56,57],{},"Map page:"," available as a persistent input at the top of the map sidebar",[27,60,62],{"id":61},"how-it-works-tiered-search","How It Works — Tiered Search",[15,64,65],{},"When you submit a query, the system tries three tiers in sequence, stopping as soon as it has a confident answer:",[67,68,73],"pre",{"className":69,"code":71,"language":72},[70],"language-text","1. Local  → Search features already loaded in the map (instant, no server call)\n           → Returns matching points, lines, polygons by name / property value\n           ↓ No match?\n2. Server → Query the database for features, work orders, reports, users\n           → Full-text + structured filter\n           ↓ Still no match, or query is a sentence?\n3. AI     → Send query to the configured AI provider\n           → Provider interprets the question and returns structured data\n","text",[43,74,71],{"__ignoreMap":75},"",[15,77,78,81],{},[38,79,80],{},"Sentence detection"," determines whether a query should skip straight to tier 3. Queries like \"show me all cable runs near the substation\" are detected as natural language and sent to AI directly; short queries like \"cable 42\" go through local and server first.",[27,83,85],{"id":84},"what-you-can-ask","What You Can Ask",[32,87,88,91,94,97,100],{},[35,89,90],{},"Feature lookups: \"Pole A-123\", \"all inactive sites\", \"linestrings with capacity > 100\"",[35,92,93],{},"Work status: \"open work orders assigned to Sarah\", \"reports submitted this week\"",[35,95,96],{},"Location queries: \"features near Main Street and 5th\"",[35,98,99],{},"Aggregation: \"how many tasks are overdue in Zone B\"",[35,101,102],{},"Properties: \"resources where unit of measure is meters\"",[27,104,106],{"id":105},"rate-limiting","Rate Limiting",[15,108,109],{},"Each user is subject to a per-hour AI query limit (default 20, configurable by admin in AI Settings). Local and server searches do not count against this limit — only tier-3 AI calls do. The toolbar shows remaining quota when you approach the limit.",[27,111,113],{"id":112},"provider-and-model-settings","Provider and Model Settings",[15,115,116,117,120],{},"Admins configure the AI provider and model in ",[38,118,119],{},"Admin → Settings → AI",". Contact your admin if AI responses are unavailable or appear degraded.",[122,123],"hr",{},[19,125,127],{"id":126},"ai-lasso-mode","AI Lasso Mode",[15,129,130],{},"The AI lasso is a map tool that lets you draw a freehand area and ask the AI about everything within it.",[27,132,134],{"id":133},"activating-lasso-mode","Activating Lasso Mode",[136,137,138,141,148],"ol",{},[35,139,140],{},"Open the map",[35,142,143,144,147],{},"Select ",[38,145,146],{},"AI Lasso"," from the mode selector (the orange polygon icon in the map toolbar)",[35,149,150],{},"The cursor changes to a crosshair",[27,152,154],{"id":153},"drawing-a-query-area","Drawing a Query Area",[136,156,157,160,163,166],{},[35,158,159],{},"Click (or tap) to place the first point",[35,161,162],{},"Continue clicking to trace the area of interest",[35,164,165],{},"Double-click (or tap the starting point) to close the polygon",[35,167,168],{},"An orange polygon appears on the map; the AI query panel opens automatically",[27,170,172],{"id":171},"the-query","The Query",[15,174,175],{},"The lasso collects:",[32,177,178,181],{},[35,179,180],{},"All Aptli features (points, lines, polygons) inside the drawn area",[35,182,183],{},"OSM / Overpass context for the same area (road names, land use, infrastructure types)",[15,185,186],{},"This combined context is sent to the AI with your question. You can ask:",[32,188,189,192,195,198],{},[35,190,191],{},"\"What infrastructure crosses this block?\"",[35,193,194],{},"\"Summarise the work orders covering this area\"",[35,196,197],{},"\"Are there any features without an assigned maintenance zone?\"",[35,199,200],{},"\"Which sites within this polygon are below minimum stock?\"",[27,202,204],{"id":203},"editing-the-polygon","Editing the Polygon",[15,206,207],{},"The orange lasso polygon stays editable after the first query:",[32,209,210,213,216],{},[35,211,212],{},"Drag vertices to resize",[35,214,215],{},"Click an edge to add a new vertex",[35,217,218],{},"Re-submit the query to refresh results with the new shape",[27,220,222],{"id":221},"clearing-the-lasso","Clearing the Lasso",[15,224,225,226,229],{},"Click the ",[38,227,228],{},"Clear Lasso"," button (×) or switch to any other map mode. The orange polygon is removed.",[122,231],{},[19,233,235],{"id":234},"schematic-ai-context","Schematic AI Context",[15,237,238],{},"On the schematics page, a dedicated AI context builder summarises the open diagram and sends it to the AI for reasoning.",[27,240,242],{"id":241},"what-it-does","What It Does",[15,244,245],{},"The AI builds a structured summary of the diagram that includes:",[32,247,248,251,254,257],{},[35,249,250],{},"Node types and counts (how many transformers, splitters, endpoints)",[35,252,253],{},"Edge types and connections (which nodes link to which)",[35,255,256],{},"Capacity and load annotations (if present in schematic properties)",[35,258,259],{},"Orphaned nodes (nodes with no connections)",[15,261,262],{},"This structured summary is sent as context with your query, so you can ask:",[32,264,265,268,271,274],{},[35,266,267],{},"\"Which segment has the highest load?\"",[35,269,270],{},"\"Find nodes with no downstream connections\"",[35,272,273],{},"\"What would happen if Node 7 fails?\"",[35,275,276],{},"\"Summarise the path from the head-end to endpoint E-42\"",[27,278,280],{"id":279},"accessing-schematic-ai","Accessing Schematic AI",[136,282,283,286,289],{},[35,284,285],{},"Open a schematic from the schematics page or from a feature's relationship panel",[35,287,288],{},"The AI input appears in the schematic toolbar (top-right of the diagram view)",[35,290,291],{},"Type your question and press Enter",[122,293],{},[19,295,297],{"id":296},"ai-column-mapping-csv-xlsx-import","AI Column Mapping (CSV / XLSX Import)",[15,299,300,301,304],{},"When you import a CSV or XLSX file using the ",[38,302,303],{},"Data Transfer"," panel (or the bulk import workflow), the AI assists with mapping your file's column headers to Aptli's field schema.",[27,306,308],{"id":307},"how-column-mapping-works","How Column Mapping Works",[15,310,311],{},"After uploading a file:",[136,313,314,317,320,323],{},[35,315,316],{},"Aptli reads the first row (headers) from the file",[35,318,319],{},"For each header, the AI suggests the best matching Aptli field (name, latitude, longitude, resource, site, status, etc.)",[35,321,322],{},"Matched columns appear pre-filled in the mapping table",[35,324,325],{},"Unmatched columns are flagged for manual assignment or skipped",[27,327,329],{"id":328},"reviewing-and-confirming","Reviewing and Confirming",[15,331,332],{},"The mapping table shows:",[32,334,335,341,347],{},[35,336,337,340],{},[38,338,339],{},"File Column"," — your original header name",[35,342,343,346],{},[38,344,345],{},"Mapped Field"," — Aptli's suggested field",[35,348,349,352],{},[38,350,351],{},"Sample Values"," — first 3 rows of data for that column",[15,354,355],{},"You can:",[32,357,358,361,364,367],{},[35,359,360],{},"Accept the suggestion (click checkmark)",[35,362,363],{},"Change the mapping (dropdown)",[35,365,366],{},"Skip the column (toggle off)",[35,368,369,370,373],{},"Mark as a custom property (stores in ",[43,371,372],{},"properties"," object)",[27,375,377],{"id":376},"applying-the-import","Applying the Import",[15,379,380,381,384],{},"Once mapping is confirmed, click ",[38,382,383],{},"Apply",". The system:",[136,386,387,390,393],{},[35,388,389],{},"Processes each row against the confirmed mapping",[35,391,392],{},"Creates or updates records in the target model (features, resources, stock items, etc.)",[35,394,395],{},"Reports a count of created / updated / skipped / failed rows",[27,397,399],{"id":398},"supported-file-types","Supported File Types",[401,402,403,416],"table",{},[404,405,406],"thead",{},[407,408,409,413],"tr",{},[410,411,412],"th",{},"Type",[410,414,415],{},"Notes",[417,418,419,430],"tbody",{},[407,420,421,427],{},[422,423,424],"td",{},[43,425,426],{},".csv",[422,428,429],{},"UTF-8 or UTF-8-BOM; first row = headers",[407,431,432,437],{},[422,433,434],{},[43,435,436],{},".xlsx",[422,438,439],{},"First worksheet only; rich-text cells flattened to plain text",[15,441,442,443,448],{},"For GIS-specific formats (GDB, SHP, GeoPackage, DXF, DGN), see ",[444,445,447],"a",{"href":446},"/guide/field-operations/imports","GIS File Imports"," — those go through a different pipeline.",[122,450],{},[19,452,454],{"id":453},"tips-and-limitations","Tips and Limitations",[15,456,457,460],{},[38,458,459],{},"AI queries require network access."," Tier-3 AI calls go to an external provider. Local (tier 1) and server (tier 2) searches work offline.",[15,462,463,466],{},[38,464,465],{},"AI does not modify data."," All AI outputs are read-only. Saving, creating, or deleting records always requires an explicit user action.",[15,468,469,472],{},[38,470,471],{},"Context window."," Very large schematics or feature sets may be summarised before being sent to the AI. If results seem incomplete, try narrowing the lasso area or being more specific in your query.",[15,474,475,478],{},[38,476,477],{},"Provider outages."," If the configured AI provider is unavailable, tier-3 searches fail gracefully with an error message. Tier 1 and 2 still work.",{"title":75,"searchDepth":480,"depth":480,"links":481},2,[482,490,497,501,507],{"id":21,"depth":480,"text":22,"children":483},[484,486,487,488,489],{"id":29,"depth":485,"text":30},3,{"id":61,"depth":485,"text":62},{"id":84,"depth":485,"text":85},{"id":105,"depth":485,"text":106},{"id":112,"depth":485,"text":113},{"id":126,"depth":480,"text":127,"children":491},[492,493,494,495,496],{"id":133,"depth":485,"text":134},{"id":153,"depth":485,"text":154},{"id":171,"depth":485,"text":172},{"id":203,"depth":485,"text":204},{"id":221,"depth":485,"text":222},{"id":234,"depth":480,"text":235,"children":498},[499,500],{"id":241,"depth":485,"text":242},{"id":279,"depth":485,"text":280},{"id":296,"depth":480,"text":297,"children":502},[503,504,505,506],{"id":307,"depth":485,"text":308},{"id":328,"depth":485,"text":329},{"id":376,"depth":485,"text":377},{"id":398,"depth":485,"text":399},{"id":453,"depth":480,"text":454},"Ask questions about your assets, work orders, and map features in plain language. Draw an AI lasso on the map to query any geographic area, analyse schematics, or map import columns automatically.","md",{},true,"/en/user/field-operations/ai-assistant",{"title":5,"description":508},"en/user/field-operations/ai-assistant","vqWWf8hRFbrbvdfZ-TDxxvf3cIfrVeCpJO2bY1cPyb8",1776295546621]