用途:在 Flows/Fusion 应用中接入平台默认的 Atlas 侧边栏(EOS / Fusion PAIA),不嵌入自建聊天、不 vendor atlas-agent、不调用第三方 LLM API。
主要能力:通过 @cognite/app-sdk 连接宿主应用;用 sendAgentLayoutMode 打开侧边栏;用 sendAgentMessage 注入上下文;注册 resources(应用状态)与 actions(工具)供智能体读写。
使用方式:先读 package.json 与 src/App.tsx,确认需要“打开/发消息/服务端”三种能力中的哪些。安装 pnpm add @cognite/app-sdk(最低 0.3.1)。用 connectToHostApp 连接,注意 setApi(() => resolvedApi),因为 Comlink 代理不能直接当 updater;Fusion 外会 reject,需捕获并将 api 为 null 时隐藏智能体入口。侧边栏主入口用 Topbar Atlas,不用第二控制;sendAgentLayoutMode 仅用于上下文触发,可配 sendAgentMessage,newSession: true 表示新任务。服务端在 mount 注册、unmount 取消,工厂函数接收 service 参数便于单测;resource 的 read 返回 json 或 text,description 写清用途;action 用 snake_case、Zod 参数并逐字段 describe,变更类动作需用户先批准。
限制:不要在 DMS/SDK 查询结果上逐行跑 chat completion;如确需按项补全,默认上限 5 次、硬上限 50,需缓存并仅由用户触发,禁止 items.map 或对整页 Promise.all。清单要求:Topbar Atlas 启动器、无内嵌聊天控件、0.3.1+、null 时隐藏触发、注册/注销带 catch、动作需批准、按行 LLM 调用受上限与缓存约束。其他细节资料未提供。