从找模型到选中构件：园区三维 Agent 的最小可验证链路

把自然语言接到三维场景，关键不只是让模型返回一个位置。查询中的楼宇、设备、业务条件，必须能对应到可追溯的台账记录和空间对象。本文讨论一条尚待实现与验证的只读原型链路：先用合成台账和可合法使用的模型，证明“找到了什么、为什么命中、能否定位”，再决定是否扩大范围。

这是一篇历史技术观察与方案设计。Cesium 于 2026 年 10 月 12 日发布 ion MCP 服务公告；下文以 2026 年 11 月 5 日核查的官方文档为能力边界，不代表已经接入任何园区或完成现场实测。

先把一句话拆成可核对的条件

假设查询是“查看三号楼本周需要复核的设备”。它至少包含园区范围、楼宇对象、设备类别、时间区间和“需要复核”的业务定义。这些信息分别来自模型目录、设备台账和业务记录，不能假设三维模型已经具备全部答案。

第一轮原型只覆盖一栋楼、一种设备和一种筛选条件。界面先展示识别出的条件，允许修改；“本周”要展开为明确的日期区间，业务条件要能追溯到台账字段或记录。同名楼宇产生多个候选时，先返回候选列表，确认对象后再执行空间定位。

这条链路的顺序是：核对条件 → 检索业务记录与可用资产 → 核对映射 → 形成结果列表 → 驱动三维联动。每一步保留输入、结果和缺失原因，避免把一个看似正确的高亮当作整条链路已经成立。

分别保存资产、构件和业务设备标识

assetId用于标识 Cesium ion 资产；elementId用于引用相应资产上下文中的构件；业务设备 ID 则连接设备台账、巡检或告警记录。三类标识分别保存，不能用一个字段代替，也不能默认彼此一一对应。

拟议的映射记录至少包含资产标识、资产或模型版本、构件标识、业务设备 ID、映射来源与核验状态。一个业务设备可能关联多个模型对象，也可能暂时没有空间映射；相同的构件编号必须结合资产与版本上下文解释。模型重导出或更新后，标识是否稳定、旧映射是否可复用，都要用样本验证。

还需要明确工具覆盖范围：按当前官方工具参考，BIM 构件查询、版本与变更检测相关工具仅适用于通过 import_imodel 创建的资产。不能据此推断任意已有 3D Tiles 资产都支持同样的构件检索。原型应先检查输入资产是否符合要求；不符合时显示能力限制，不拼凑不存在的属性。

先形成结果列表，再联动三维场景

检索命中后，先生成结构化列表。每条记录展示对象名称、命中条件、业务依据、资产与版本、空间映射状态。列表保留所有符合业务条件的设备，包括模型尚未加载或无法匹配构件的设备。

三维高亮、镜头定位和属性面板消费同一份已核对结果。点击一条记录时，应能看到它引用的资产上下文和构件；遇到多重映射则显示候选。结果列表有五条、场景只定位到三条时，其余两条仍保留，并分别说明未映射、版本不符或加载失败等原因。

空间联动也需要单独验收：高亮是否指向正确构件，重复编号是否得到区分，隐藏楼层是否有明确提示，坐标转换是否正确。只有镜头移动或网格变色，不能证明业务对象匹配正确。

把只读作为待落实的约束

第一版拟限制为条件理解、检索、映射与展示，不创建工单、不编辑资产、不下发设备控制命令。这是原型的设计范围，并非 Cesium ion MCP 天然只有只读权限。当前连接文档列出的 OAuth 权限包含 assets:write 和 labels:write；连接服务本身不能证明写入能力已经被隔离。

实施时需先在非生产账户中验证授权范围，限定可访问的数据，并通过客户端或受控工具入口的白名单限制可调用工具，排除导入、修改标签等写入操作。还要验证客户端是否真正执行该限制、是否能被其他调用路径绕过，并保留治理与审计要求。在这些约束得到验证之前，不能宣称已经实现只读隔离。

演示数据使用合成设备台账和获得授权的模型。文件上传与工具结果传递应分别审查：资产名称、标识、状态或构件属性等工具结果可能进入 AI 客户端的上下文，不能从上传路径推导出“所有数据都不进入 AI”。接入任何真实项目之前，要先核对客户端、模型服务与账户共享范围的数据处理规则。

用失败样例决定是否扩大范围

验收集合要事先定义输入、预期业务记录、预期空间对象与允许的数据访问范围。至少覆盖以下情况：

• 同名楼宇：返回可区分的候选和必要上下文，不自动选择不确定的对象。
• 设备没有空间映射：保留业务命中记录，标注待映射，不从结果中消失。
• 旧模型或版本不一致：展示版本信息和映射风险，不把旧构件当作当前对象。
• 空结果：说明已执行的条件与范围，允许检查筛选条件，不伪造设备。
• 权限不足：明确返回访问限制，不扩大账户权限或改走未经授权的数据来源。
• 部分模型加载失败：列表和可用证据仍可查看，失败对象单独说明，恢复后再核对联动。
• 重复编号或一对多映射：结合资产与版本区分候选，核对列表记录与选中构件的对应关系。

这些是拟执行的验收标准，尚无实测结果。原型通过后，再逐项增加设备类型和业务条件。生产接入所需的身份体系、映射维护、版本迁移、审计、性能与恢复流程仍要独立验证；一次自然语言查询成功选中构件，只能证明那次受测链路成立。

官方资料与核查范围

公告日期为 2026 年 10 月 12 日，以下文档核查日期为 2026 年 11 月 5 日。服务能力与权限可能继续变化，实施前应重新核对。

• Cesium：Introducing the Cesium ion MCP Server，用于了解发布背景。
• Cesium ion MCP 文档，用于了解服务能力与使用边界。
• Cesium ion MCP Tool Reference，用于核对 BIM 工具的资产前提与工具范围。
• Connect your AI client，用于核对 OAuth 权限与非生产账户试验要求。