SuperAPI AI 工具集

cap-apps-workflow

智能体与模型

查看项目

更新于 10-16 05:52

技能介绍

用途:该规则用于在 Domo App Platform 应用中通过 Toolkit 的 WorkflowClient 启动并监控工作流。规则为 toolkit 优先,旧的 endpoint 优先指引已归档至 archive/legacy-rules/domo-workflow.md。

主要能力与用法:安装依赖使用 yarn add @domoinc/toolkit,并从 @domoinc/toolkit 导入 WorkflowClient。启动工作流用 WorkflowClient.startModel('myWorkflow', { inputVar: 'value', anotherVar: 123 }),实例来自 startResponse.body;查询状态用 WorkflowClient.getInstance('myWorkflow', instance.id),状态取 statusResponse.body.status。还提供 getAllModels()(或 getAllModels(true))与 getModelDetails('myWorkflow')。

关键限制:工作流方法使用 manifest.json 中 workflowMapping 的 alias,而非 UUID。需要在 manifest.json 配置 workflowMapping,包括 alias、modelId 与 parameters(aliasedName、type、list、children)。同时要在 Domo 卡片/应用配置 UI 中把应用卡片映射到目标工作流;并确认工作流起始节点输入参数与 startModel 传入的键和类型一致,否则可能启动失败或静默错误处理输入。生成或推荐 startModel 调用时,须明确说明所传输入变量名与类型。

错误处理:建议用 try/catch 包裹 startModel,失败时记录日志并重新抛出;解析响应用 response.body。长耗时工作流应提供状态检查或异步用户反馈。相关规范参考 .cursor/rules/04-toolkit.mdc、06-manifest.mdc 与 09-gotchas.mdc。清单包括:已配置 workflowMapping、卡片已映射、输入参数匹配、使用别名方法(startModel、getModelDetails、getInstance)、明确变量名类型、传别名而非 UUID、解析 response.body、提供状态检查 UX。