产品能力与接口边界¶
平台对象、界面动作和 API 调用不是一一对应关系。开发时应先确认操作的是哪个对象、动作是否创建新的运行实例，以及需要保存哪个 ID。
模型调用与模型供给配置¶
Genesis 模型 API 用于外部应用直接调用模型，包括模型发现、对话、Responses、Embeddings 和 Rerank。
Product 中的 Provider、Backend、Endpoint 和 Router 用于配置工作流、语义模型或智能体内部使用的模型服务。
在 Product 中创建 Provider 或 Backend，不会生成可替代 Genesis Base URL 的模型调用地址。
工作流定义与工作流作业¶
工作流是由算子和连线组成的流程对象；工作流作业是每次触发后产生的运行实例。
保存或部署工作流只更新定义，不表示工作流已经运行。
启动工作流后保存工作流作业 ID，并查询状态、结果和算子状态。
暂停工作流通常阻止新的运行，不能据此推断已有工作流作业已经停止。
发布 WorkItem API 服务与运行普通工作流是两条流程；发布成功也不代表服务已被调用。
导入任务与导入运行¶
导入任务持续保存来源、目标和运行配置；导入运行是该任务每次触发后产生的运行实例。提交导入任务后，应分别检查任务状态、导入运行状态和导入任务文件结果。删除任务记录不会自动回滚已经写入的目标数据。
智能体任务与自动化任务¶
通过 A2A 调用智能体时，Task 表示一次智能体执行，产物表示该执行产生的文本、数据或文件结果。自动化任务则是具有名称和触发方式的长期任务对象，每次触发会形成历史记录。两者都不能只凭提交请求成功判断执行完成。
用户账号与工作区成员¶
用户账号是平台级登录身份；工作区成员是用户账号在当前工作区中的成员关系，并具有成员状态、角色和标签。邀请、移除或修改角色操作针对工作区成员，不等同于创建或删除平台账号。
数据发布与数据订阅¶
数据发布将指定数据对象发布给目标工作区；数据订阅是在另一工作区中建立对该发布的访问关系。删除数据订阅不会删除源数据，删除发布前则应检查现有订阅和下游依赖。
使用接口前确认¶
页面是否已经为该对象提供公开 API、SDK 方法或 CLI 命令。
操作修改的是定义对象，还是创建一次异步运行。
成功响应中需要保存对象 ID、运行 ID 还是请求 ID。
后续应查询哪个状态或结果接口，以及什么结果才算业务完成。
删除、取消、重试或重新提交是否可能留下外部副作用。
未在开发者文档中列出的界面功能，不应根据网页请求、内部路径或相似命令推断为稳定公开接口。