mcpField
I
integrate-atlas-chat

integrate-atlas-chat

github.com/cognitedataAgent 工作流61.9k 次安装1 天前更新
代码仓库

关于 integrate-atlas-chat

此技能用于在宿主 Atlas 侧边栏不可用且用户同意采用非标准方案时，将 Atlas Agent 聊天集成到应用界面中。它要求先检查宿主兼容性，并保留现有产品界面。

主要功能

  1. 01嵌入式聊天须获明确同意
  2. 02先检查宿主侧边栏是否可用
  3. 03依据 Atlas 聊天集成指南操作
  4. 04保留现有产品界面

适用场景

  1. 01为独立应用添加嵌入式 Atlas 聊天
  2. 02在宿主侧边栏与应用内聊天间作出选择

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cognitedata/builder-skills --skill integrate-atlas-chat

安装后在 Claude Code 中输入/integrate-atlas-chat确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

code/
client.ts
index.ts
pyodide-react.ts
pyodide-runtime.ts
pyodide.ts
python.ts
react.ts
session.test.ts
session.ts
types.ts
validation.test.ts
validation.ts

详细介绍

集成 Atlas Agent Chat（特殊路径）

停下。 除非以下条件全部满足，否则请使用 integrate-fusion-agent（Atlas / EOS 侧边栏）：

  1. 用户要求的是应用内 / 嵌入式聊天，而不是“添加 Atlas” / “添加聊天”
  2. 无法使用宿主 Atlas 侧边栏。没有对应的 manifest 字段。请检查应用：
    • 在 Fusion/EOS 中，@cognite/app-sdk + connectToHostApp / useHostApp 可正常解析 → 侧边栏可用；请勿继续
    • 仅支持独立运行（宿主连接始终被拒绝；应用从未在 Fusion 中加载）→ 允许使用应用内聊天
    • 如果不确定，请询问。默认使用侧边栏。
  3. 用户接受这条非标准路径

然后按照 https://docs.cognite.com/cdf/flows/guides/ai_agent_integration，为 $ARGUMENTS 接入 useAtlasChat。保留产品 UI；不要将应用替换成聊天视图。

不要对 DMS 行映射 send() / 聊天补全。如果需要逐项补全：每次用户操作最多 5 次，总上限 50 次，按 space:externalId:lastUpdatedTime 缓存。参见 integrate-fusion-agent。

评论

支持 Markdown