# 产品能力与接口边界

平台对象、界面动作和 API 调用不是一一对应关系。开发时应先确认操作的是哪个对象、动作是否创建新的运行实例，以及需要保存哪个 ID。

## 模型调用与模型供给配置

- Genesis 模型 API 用于外部应用直接调用模型，包括模型发现、对话、Responses、Embeddings 和 Rerank。
- Product 中的 Provider、Backend、Endpoint 和 Router 用于配置工作流、语义模型或智能体内部使用的模型服务。
- 在 Product 中创建 Provider 或 Backend，不会生成可替代 Genesis Base URL 的模型调用地址。

## 工作流定义与工作流作业

工作流是由算子和连线组成的流程对象；工作流作业是每次触发后产生的运行实例。

- 保存或部署工作流只更新定义，不表示工作流已经运行。
- 启动工作流后保存工作流作业 ID，并查询状态、结果和算子状态。
- 暂停工作流通常阻止新的运行，不能据此推断已有工作流作业已经停止。
- 发布 WorkItem API 服务与运行普通工作流是两条流程；发布成功也不代表服务已被调用。

## 导入任务与导入运行

导入任务持续保存来源、目标和运行配置；导入运行是该任务每次触发后产生的运行实例。提交导入任务后，应分别检查任务状态、导入运行状态和导入任务文件结果。删除任务记录不会自动回滚已经写入的目标数据。

## 智能体任务与自动化任务

通过 A2A 调用智能体时，Task 表示一次智能体执行，产物表示该执行产生的文本、数据或文件结果。自动化任务则是具有名称和触发方式的长期任务对象，每次触发会形成历史记录。两者都不能只凭提交请求成功判断执行完成。

## 用户账号与工作区成员

用户账号是平台级登录身份；工作区成员是用户账号在当前工作区中的成员关系，并具有成员状态、角色和标签。邀请、移除或修改角色操作针对工作区成员，不等同于创建或删除平台账号。

## 数据发布与数据订阅

数据发布将指定数据对象发布给目标工作区；数据订阅是在另一工作区中建立对该发布的访问关系。删除数据订阅不会删除源数据，删除发布前则应检查现有订阅和下游依赖。

## 使用接口前确认

1. 页面是否已经为该对象提供公开 API、SDK 方法或 CLI 命令。
2. 操作修改的是定义对象，还是创建一次异步运行。
3. 成功响应中需要保存对象 ID、运行 ID 还是请求 ID。
4. 后续应查询哪个状态或结果接口，以及什么结果才算业务完成。
5. 删除、取消、重试或重新提交是否可能留下外部副作用。

未在开发者文档中列出的界面功能，不应根据网页请求、内部路径或相似命令推断为稳定公开接口。

## 下一步

- [查看 Product API 任务入口](../api/product-api/index.md)
- [了解分页、异步任务与幂等](../api/common/pagination-async-idempotency.md)
- [选择 Product SDK 任务指南](../sdk/product-sdk/guides/index.md)