SuperAPI AI 工具集

start-flows-app

智能体与模型

查看项目

更新于 10-16 05:02

技能介绍

用途:在新启动 Flows 自定义应用时使用,尤其是 Fusion Custom apps 的 Start building 提示结束或执行 npx 命令之后。目标是在 https://localhost 上尽快跑出可点击原型,用户故事、数据模型探索与 App-Brief.md 可在 localhost 启动后并行推进;缺少 appHostingAcl 的 WRITE 权限属于并行事项,不是前置门槛。

主要能力与用法:

  1. 在 https://localhost 提供脚手架并打开对应端口,Fusion 从该地址加载应用,不必等角色或 App-Brief 完成;遇到证书警告可用 npx @cognite/cli@latest apps setup-https,参考 https://docs.cognite.com/cdf/flows/guides/local-https。
  2. 按 connect-atlas-mcp 连接 Industrial MCP:原样运行 Fusion 提示中的 MCP 命令,再在浏览器完成 OAuth。
  3. 检查应用托管权限:Industrial MCP 不查 IAM,应调用 GET {baseUrl}/api/v1/token/inspect,请求头 Authorization: Bearer <session>。该路径无 project;inspect 自身需要 projectsAcl:LIST 与 groupsAcl:LIST。若返回 403 视为权限未知并继续。在 capabilities[] 中找 appHostingAcl,按项目范围过滤,权限为 READ | WRITE | RUN;创建并部署托管应用需要 WRITE 且 scope 为 { all: {} }。缺少 WRITE 时提示联系 CDF 项目管理员申请,同时继续本地构建。
  4. 查看本项目数据模型,优先用 MCP 的 list/query 工具,回退接口为 GET {baseUrl}/api/v1/projects/{project}/models/datamodels?limit=1000&includeGlobal=true,并指出与意图相关的模型。
  5. 从 SME 视角帮助梳理角色、一句话用户故事与用例。
  6. 在对话之后再写 App-Brief.md,使用 flows-app-brief,只根据对话与数据模型推断,未知项留空。
  7. 按 flows-external-app-submit 部署、以 builder 身份签名并提交审核。

限制:不要把空的 App-Brief 模板当作开场;不要臆造 mkcert / brew / choco 步骤,也不要重建 MCP URL 或选择 client id;不要粘贴令牌或完整 IAM JSON;不要用 MCP 查询工具检查 IAM;不要凭空编造 space 或 view。若浏览器登录卡住、循环或无法保持会话,应停下询问构建者。若已经设置 createdVia 字段,保持原样。Fusion Custom apps 目录展示需要部署加 appHostingAcl WRITE。