三种入口，汇入统一设备业务
协议可控的设备使用原生接入；既有报文通过协议适配；现场网关组织子设备与采集链路。接入后继续使用产品、设备和物模型管理。
- 客户少做什么
- 把设备差异留在接入侧，避免行业应用分别理解每种硬件协议。
- 选择与取舍
- 接入方式取决于协议资料、网络与设备固件；支持扩展不等于任意协议免开发。
这张界面看什么
看协议选择和接入配置：设备差异在接入侧处理，后续业务使用统一设备能力。
点击截图可放大查看IoT / PART OF THE SAME FOUNDATION
设备协议不同，业务不必重新开始。
区分原生设备、存量协议和现场网关，以认证、协议转换和上下行扩展连接统一设备业务。
THE CUSTOMER PROBLEM
设备接入与协议扩展，
从业务问题开始。
新产品可以选择接入协议，已经运行的设备往往不能重新刷固件。项目团队需要判断在哪一层做适配，而不只是验证 MQTT 能否连上：身份、字段含义、控制返回与异常记录都要进入交付范围。
INSIDE THE FOUNDATION
先选择接入位置，再验证业务链路
接入方式示意 · 三种入口按设备与现场条件选择。
MECHANISM / REASON / TRADE-OFF
结合界面，看懂能力如何工作。
Go / Yaegi：给上下行留出明确扩展位置
协议脚本区分上行前、上行后、下行前与下行后。前处理用于转换输入，后处理承接处理完成后的附加工作；脚本按产品或设备绑定。
- 客户少做什么
- 复用 Go 消息类型与已开放能力，让局部协议变化不必都改进核心服务。
- 选择与取舍
- 脚本仍需要调试、权限和运行成本评估；不能把协议脚本描述为任意代码的强隔离容器。
接通之后，还要验证双向链路
上行检查字段、类型和事件；下行检查目标、参数、发送记录和回执。网关接入同时核对父子设备关系。
- 客户少做什么
- 连接成功只是第一步，业务需要可解释的数据与可追溯的操作。
- 选择与取舍
- 只看到设备在线，不足以证明属性、动作、OTA 或控制都可用。
这张界面看什么
看设备名称、产品与状态；接着还要用测试设备检查上报、查询和下行。
点击截图可放大查看GIVE YOUR DEVICES AI CAPABILITIES
让普通设备，
进入 AI 能理解和操作的业务。
对于已经能联网并提供读写接口的设备，可以把 AI 理解与工具调用放在平台侧，不必让每台设备运行大模型。原有采集、控制和安全保护仍由设备与业务系统承担。
TRY A BUSINESS TASK
给设备一个任务，看看背后发生了什么。
模拟设备状态尚未查询选择任务开始体验
准备就绪：点击任务按钮
从身份与项目范围开始检查；控制路径还要核对回执和实际状态。
阅读当前路径的全部步骤
- 确认身份与项目
检查实际授权，不以对话中的项目名或请求头代替权限。 确定可访问项目；CloneGroup 关联项目化身。
- 核对工具与权限
核对数据范围、字段与时间窗。 允许进入已配置业务接口；不是直接交给模型操作设备。
- 执行业务查询
走实际配置的接口路径，不把所有调用都画入 Sandbox。 取得接口返回，继续检查记录与时间。
- 解释结果与依据
区分数据存在、缺失与过期，确认统计口径。 模拟查询：24.6 °C · 样本已更新。数值仅存在于本页，不是现场读数。
预设任务和确定性样本，不是在官网运行大模型。设备需先联网、定义物模型并配置获准工具；CLI / Skills 用于辅助开发，不是每次运行时请求的必经步骤。
已有联网设备
复用上报、查询与控制接口，补齐模型和工具配置。
存量协议设备
通过适配或网关接入；无通信能力的设备先评估联网模组或采集改造。
只读采集设备
可以查询与辅助分析；需要控制时还必须有执行器和有效控制接口。
当前阶段 / 04
让用户能问、能查，再验证控制
- 你提供什么
- 业务问题、验收样例以及失败/离线处理要求。
- 复用什么
- AI 工作台、业务工具、设备状态与历史查询。
- 交付什么
- 带真实数据依据的交互；通过验收后集成到自己的产品。
这张界面看什么
看返回曲线、时间与明细：这张图证明设备查询展示，不证明新增了设备自身不具备的感知或控制能力。
点击截图可放大查看INSIDE THE FOUNDATION
AI 在平台侧理解需求，设备侧执行已有能力
运行架构示意 · 不调用真实接口。只读采集设备不会因接入 AI 自动获得执行器；开发用 Skills / CLI 不在每次运行请求中。
BUILD WITH YOUR OWN AI
用你的 WorkBuddy 等 AI 工具，
更快完成接入与产品开发。
Skills 提供方法、模板和检查指引，CLI 按本人授权操作平台。它们服务于开发过程，不是每一次设备查询的必经通道。
- 提供资料把协议样例、物模型字段和想实现的问题交给自己的开发 AI。
- 使用 Skills / CLI让 WorkBuddy 等读取联犀 Skills，按本人授权通过 CLI 查询、配置与核验。
- 适配与验证复用已有模板和接口；补齐设备协议或行业工具，先验证一台设备。
- 集成与交付把通过验证的交互接入自有 SaaS、应用或终端，再扩展到同类设备。
从一台设备试点，到可交付的产品。
先验上报与字段，再验只读查询；对可控设备继续验证越权拒绝、只读过滤、设备离线、接口失败和回执超时。验收时区分“指令已提交”和“设备状态已改变”。语音交互需要对应入口与音频能力，并非所有普通设备自动具备语音硬件。
设备侧现有 MCP 工具按已绑定的设备会话识别目标；项目网页通过已配置业务工具及接口使用项目范围。两种入口不混成一个任意设备控制通道，组级 MCP 代理不作为已实现能力。
A CONCRETE EXAMPLE / 机制示意
把一台已有协议的温度设备接入园区
机制示意：已有报文字段 t 不直接成为业务协议；先确认数值含义，再映射为约定的温度属性。
- 提供报文、单位、频率和身份资料
- 选择适配位置，定义产品物模型
- 验证上报、查询及异常记录；有控制能力时再验下行
READY TO INTEGRATE
接入前，一起确认。
- 设备协议与样例报文、认证方式及网络条件
- 明确字段单位、上报周期与是否支持控制
- 先用测试设备验证，不凭连接状态验收
IN PRACTICE
这些能力，如何进入行业现场？
案例证明其实际展示范围，不表示每个历史项目都启用了全部 AI 能力。