Aptli

AI 助手

Aptli 的 AI 助手加速了对资产和运营数据的发现。用自然语言提问——"显示变电站附近的电缆走线"或"哪些站点库存低于最低水平？"——系统在调用 AI 提供商之前会先搜索您的地图要素、工单和数据库。您还可以在地图上绘制套索区域查询范围内的所有内容，AI 还可在导入 CSV 或 XLSX 文件时帮助映射列标题。

AI 工具栏

AI 工具栏是询问数据问题的主要方式。它出现在顶部导航栏（桌面端），在移动端也可从地图页面访问。

打开工具栏

  • 键盘快捷键： Enter（当没有输入字段聚焦时）立即打开 AI 输入
  • 点击： 点击工具栏中的 AI 图标
  • 地图页面： 在地图侧边栏顶部作为固定输入框显示

工作原理 — 分层搜索

提交查询时，系统按顺序尝试三个层级，一旦获得可信答案即停止：

1. 本地  → 搜索地图中已加载的要素（即时，无需服务器调用）
           → 按名称/属性值返回匹配的点、线、多边形
           ↓ 无匹配？
2. 服务器 → 查询数据库中的要素、工单、报告、用户
           → 全文 + 结构化过滤
           ↓ 仍无匹配，或查询是一个句子？
3. AI     → 将查询发送至配置的 AI 提供商
           → 提供商解释问题并返回结构化数据

句子检测决定查询是否应直接跳至第三层。"显示变电站附近所有电缆走线"等查询被检测为自然语言并直接发送给 AI；"电缆 42"等简短查询则先经过本地和服务器搜索。

可以询问的内容

  • 要素查找："杆塔 A-123"、"所有非活跃站点"、"容量 > 100 的线要素"
  • 工作状态："分配给 Sarah 的未完成工单"、"本周提交的报告"
  • 位置查询："主街和第 5 街附近的要素"
  • 聚合："B 区有多少任务逾期"
  • 属性："计量单位为米的资源"

速率限制

每个用户每小时有 AI 查询次数限制（默认 20 次，管理员可在 AI 设置中配置）。本地搜索和服务器搜索不计入此限制——只有第三层 AI 调用计入。当您接近限制时，工具栏会显示剩余配额。

提供商和模型设置

管理员在管理 → 设置 → AI 中配置 AI 提供商和模型。如果 AI 响应不可用或出现问题，请联系您的管理员。

AI 套索模式

AI 套索是一种地图工具，允许您绘制自由手势区域，并向 AI 询问该区域内的所有内容。

激活套索模式

  1. 打开地图
  2. 从模式选择器中选择 AI 套索（地图工具栏中的橙色多边形图标）
  3. 光标变为十字准线

绘制查询区域

  1. 点击（或触摸）放置第一个点
  2. 继续点击以描绘感兴趣的区域
  3. 双击（或触摸起始点）以闭合多边形
  4. 地图上出现橙色多边形；AI 查询面板自动打开

查询

套索收集：

  • 绘制区域内的所有 Aptli 要素（点、线、多边形）
  • 同一区域的 OSM / Overpass 上下文（道路名称、土地用途、基础设施类型）

这些综合上下文会与您的问题一起发送给 AI。您可以询问：

  • "这个街区穿越了哪些基础设施？"
  • "总结覆盖此区域的工单"
  • "有没有没有分配维护区域的要素？"
  • "此多边形内哪些站点低于最低库存？"

编辑多边形

首次查询后橙色套索多边形仍可编辑：

  • 拖动顶点以调整大小
  • 点击边以添加新顶点
  • 重新提交查询以使用新形状刷新结果

清除套索

点击清除套索按钮（×）或切换到任何其他地图模式。橙色多边形即被移除。

示意图 AI 上下文

在示意图页面，专用的 AI 上下文构建器会汇总打开的图表并将其发送给 AI 进行推理。

功能说明

AI 构建图表的结构化摘要，包括：

  • 节点类型和数量（变压器、分路器、端点等的数量）
  • 边类型和连接关系（哪些节点与哪些节点相连）
  • 容量和负载注释（如果示意图属性中存在）
  • 孤立节点（没有连接的节点）

该结构化摘要作为上下文与您的查询一起发送，因此您可以询问：

  • "哪个段的负载最高？"
  • "找出没有下游连接的节点"
  • "如果节点 7 发生故障会怎样？"
  • "总结从前端到端点 E-42 的路径"

访问示意图 AI

  1. 从示意图页面或从要素的关系面板打开示意图
  2. AI 输入框出现在示意图工具栏中（图表视图右上角）
  3. 输入您的问题并按 Enter

AI 列映射（CSV / XLSX 导入）

使用数据传输面板（或批量导入工作流）导入 CSV 或 XLSX 文件时，AI 辅助将文件列标题映射到 Aptli 的字段 schema。

列映射工作原理

上传文件后：

  1. Aptli 读取文件的第一行（标题）
  2. 对于每个标题，AI 建议最佳匹配的 Aptli 字段（名称、纬度、经度、资源、站点、状态等）
  3. 匹配的列在映射表中预填充
  4. 未匹配的列标记为需要手动分配或跳过

审查和确认

映射表显示：

  • 文件列 — 您的原始标题名称
  • 映射字段 — Aptli 建议的字段
  • 示例值 — 该列的前 3 行数据

您可以：

  • 接受建议（点击复选标记）
  • 更改映射（下拉选择）
  • 跳过该列（切换关闭）
  • 标记为自定义属性（存储在 properties 对象中）

应用导入

映射确认后，点击应用。系统将：

  1. 根据确认的映射处理每一行
  2. 在目标模型中创建或更新记录（要素、资源、库存项目等）
  3. 报告已创建 / 已更新 / 已跳过 / 失败的行数

支持的文件类型

类型说明
.csvUTF-8 或 UTF-8-BOM；第一行为标题
.xlsx仅第一个工作表；富文本单元格转换为纯文本

对于 GIS 专用格式（GDB、SHP、GeoPackage、DXF、DGN），请参阅 GIS 文件导入——这些格式通过不同的处理流程。

提示与限制

AI 查询需要网络连接。 第三层 AI 调用发送到外部提供商。本地（第一层）和服务器（第二层）搜索可离线使用。

AI 不修改数据。 所有 AI 输出均为只读。保存、创建或删除记录始终需要明确的用户操作。

上下文窗口。 非常大的示意图或要素集在发送给 AI 之前可能会被压缩摘要。如果结果看起来不完整，请尝试缩小套索区域或在查询中更加具体。

提供商中断。 如果配置的 AI 提供商不可用，第三层搜索会优雅地失败并显示错误消息。第一层和第二层仍然正常工作。