研发协作
当应用无法使用 Atlas 侧边栏且用户明确要求内嵌聊天时…
在独立应用(无法接入 Fusion/EOS 侧边栏)中,用户明确要求应用内嵌 Atlas 聊天时,按官方文档接入 useAtlasChat。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
当应用无法使用 Atlas 侧边栏且用户特定
解决思路
- 先停下:除非同时满足以下全部条件,否则改用 integrate-fusion-agent(Atlas / EOS 侧边栏)路径。
- 确认用户要求的是应用内嵌(in-app / embedded)聊天,而不是笼统的“加个 Atlas”或“加个聊天”。
- 确认宿主 Atlas 侧边栏无法工作:没有对应的 manifest 字段,需要探测应用——若 @cognite/app-sdk 配合 connectToHostApp / useHostApp 能在 Fusion/EOS 内解析成功,则侧边栏可用,不要继续走此路径。
- 若应用仅能独立运行(host connect 总是被拒绝、应用从不被加载进 Fusion),则允许使用应用内嵌聊天。
- 若不确定,先询问用户;默认选择侧边栏方案。
- 确认用户已接受这是非标准路径。
- 随后参照 https://docs.cognite.com/cdf/flows/guides/ai_agent_integration 文档,为 $ARGUMENTS 接入 useAtlasChat。
- 保留产品原有 UI,不要用聊天视图替换整个应用。
- 不要把 send() / chat completions 映射到 DMS 行上。
- 若确实需要按条目(per-item)生成补全:每次用户操作最多 5 次,上限 50 次,并按 space:externalId:lastUpdatedTime 做缓存;详见 integrate-fusion-agent。
适用边界 · 注意事项
- 用户只是笼统地说“加个聊天”或“加个 Atlas”,并未明确要求应用内嵌聊天。
- 宿主 Atlas 侧边栏可以正常工作(应用能在 Fusion/EOS 内通过 connectToHostApp / useHostApp 解析)。
- 用户未接受这是非标准路径,或情况不确定时(应默认走侧边栏方案)。