Aptli

AI 助手

Aptli 的 AI 助手可帮助您获取答案并自动填写记录，无需在菜单中反复查找。 它提供两种使用方式：桌面端的聊天面板，您可在其中提问，并让助手为您填写表单或筛选当前查看的列表；以及移动端的语音和照片采集流程，可将现场工作人员的语音和照片内容转化为报告草稿、验证结果或库存查询结果。

该助手在 Aptli 中始终包含——无需单独购买许可。管理员仍可在整个部署范围内将其关闭，且由于每个请求都会发送至配置的 AI 提供商，因此需要网络连接。

**助手绝不会自行更改您的数据。它生成的所有内容均为建议——包括草拟的答案、建议的表单修改、一组筛选条件以及捕获的记录。必须由人工进行审核，并通过点击“应用”**或通过常规写入路径保存。 AI 无法自行创建、编辑或删除记录。

AI 聊天（桌面版）

聊天窗口采用 滑出式 设计——您可通过顶部导航栏中的 闪烁按钮 打开侧边面板。 在底部的编辑器中输入问题，然后按 Enter 键（或点击“发送”）。即使在不同页面之间切换，对话记录也会保留；这是一个贯穿整个会话的固定面板，而非仅限于单个页面的控件。

基于您共享的上下文运行

助手不会自行查询数据库。相反，每个页面会提供其当前显示的数据——列表中的记录、您正在编辑的表单、您在地图上选中的功能——而聊天功能会将该上下文中经过筛选的精简片段与您的问题一同发送出去。 面板顶部的上下文选择器可让您选择要共享的数据包。上下文的数量与任务相关：一个状态查询所携带的信息远少于一整屏的要素。

由于上下文范围仅限于您当前会话中可见的内容，因此助手绝不会显示因您的角色权限限制而被隐藏的数据。

查询选定的地图要素

在现场记录中，按常规方式选择要素——点击它们，或画一个套索来选中某个区域内的所有要素——然后使用闪光图标打开聊天窗口，此时这些要素已作为上下文加载完毕。 您可以提出诸如 “汇总涉及这些电杆的工作单” 或 “这些站点中哪些库存低于最低库存量？” 之类的问题。助手会根据您选中的要素进行回答；它不会自行调用外部地图数据。

让它自动填写表单

当您打开记录表单时，助手可以提供表单补丁：用通俗语言描述您的需求，它就会返回已填好的字段值供您审核。 无法编辑的字段绝不会被修改，且每个值在提供前都会与表单的实际字段进行核对——因此，虚构的字段或超出范围的选项会被忽略，而非应用。您仍需点击 应用 按钮来接受该补丁。

让它过滤列表

在支持此功能的列表界面中，可要求助手缩小显示范围——例如 “仅显示 B 区的逾期工作单”——它会为您设置列表的 筛选条件和排序规则，而非填写表单字段。 与表单填写功能类似，任何无法与实际控件匹配的筛选条件都会被静默忽略。

速率限制

每位用户每小时都有一个令牌预算（默认 150,000 个令牌，可由管理员配置），该预算以滚动的一小时窗口为单位计算——而非固定数量的问题——因此，许多简短的问题消耗的令牌远少于几个长问题。 当您超出预算时，系统会提示您等待；随着小时的推移，预算将自动恢复。同一预算同时适用于聊天功能和下文所述的移动端数据采集流程，因此无论由哪项功能驱动，AI 消耗都将保持在限定范围内。

提供商和模型设置

管理员可在聊天面板的设置中直接选择 AI 提供商和模型（仅对拥有 appSettingSchemasModify 权限的用户可见）。如果 AI 响应不可用或质量下降，请联系您的管理员。

语音和照片录入（移动端）

在移动端，助手支持三种现场录入流程。每种流程都会将语音录入和照片转换为供您审核并提交的草稿——绝不会自动静默保存。

  • 报告采集 —— 口述您完成的工作内容并拍摄照片；助手会整理转录内容，核查其是否确实描述了工作情况，查找附近的任务或工作单进行关联，并起草一份已填入已完成工作内容和消耗材料的报告。您确认后提交。
  • 验收记录 — 拍摄工作现场并口述您的判定结果；助手会将您已做出的“合格”、“不合格”或“需修改”的决定映射到正确的状态，并整理好备注。它绝不会根据照片自行对工作做出判断——最终决定权始终在您手中。
  • 查找库存（照片搜索） —— 拍摄物品照片，助手会建议识别标签，然后根据这些标签进行库存搜索，这样您就能找到无法说出名称的物品。
**AI 关闭时同样适用。**如果管理员已禁用 AI 或无法连接到服务提供商，这些流程仍会运行——您的语音输入将原封不动地作为草稿的描述，其余部分由您手动填写。采集流程会降级为手动输入，而非消失。

通过 AI 列映射导入文件

当您通过 数据传输 窗口导入 CSV 或 XLSX 文件时，助手可帮助将文件的列标题与 Aptli 的字段进行匹配——系统会建议一种映射方案，您可在应用前对其进行审核、调整或覆盖。 对于 GIS 专用格式（GDB、SHP、GeoPackage、DXF、DGN），请参阅 GIS 文件导入 —— 这些格式会通过独立的处理流程。

提示与限制

  • AI 需要网络连接。 每个请求都会发送到外部服务提供商；当您在无信号的设备上操作时，助手无法响应。
  • AI 绝不会修改数据。 所有输出均为建议；保存、创建或删除操作始终需要您明确执行。
  • 上下文范围有限。 非常大的选定内容在发送前可能会被截断。如果回答似乎不完整，请缩小选定范围或提供更具体的描述。
  • 服务器端不存储任何内容。 您的聊天记录仅保存在您自己的浏览器中——服务器端没有聊天记录，因此它不会跟随您转移到其他设备，管理员也无法查看。
  • 服务商中断时会优雅处理。 如果配置的服务商出现故障，助手会显示错误提示，而不是阻碍您的工作。