概念介绍

开发者操作的对象以工作区为边界组织。动手调用前，先理解对象的层次，以及几对容易混淆的概念。

工作区与对象层次

工作区是资源的主要治理边界，承载成员、角色、数据、工作流和计算资源。开发者通常按下面的层次取得并使用对象 ID：

工作区
├─ 成员（关联用户账号）与角色
├─ 目录 → 数据库 → 表或卷 → 文件
├─ 连接器 → 导入任务 → 导入运行
├─ 工作流 → 工作流作业 → 产物与数据血缘
├─ 知识库 → 知识来源与语义配置
├─ 智能体 → 会话或自动化任务 → 智能体产物
└─ 计算实例、数据发布与数据订阅

容易混淆的概念

直接调用模型与配置模型服务。 应用需要获得模型生成结果时，使用 Genesis API 或兼容 SDK。工作流、知识库和智能体需要使用模型时，在 AI Studio 中配置 LLM 模型服务。这项配置供 AI Studio 内部选择模型服务，不会生成可替代 Genesis 服务地址的模型调用地址。需要调整模型服务的选择规则时，见配置模型路由。

定义与运行实例。 很多对象分两层：你先创建并保存一个「定义」（比如一个工作流、一个导入任务），它本身不做任何事；每次触发它，才产生一个「运行实例」（一次工作流作业、一次导入运行），真正执行的是实例。所以：保存或部署只改了定义，不代表跑过；提交运行返回成功，只代表受理、不代表跑完——要拿实例的 ID 去查状态和结果。删除定义也不会撤销已经跑出来的数据。

用户账号与工作区成员。 用户账号是平台级登录身份；工作区成员是账号在某个工作区中的成员关系，带角色和标签（见用户管理）。移除工作区成员只解除该工作区关系，不等于删除平台账号。

数据发布与数据订阅。 数据发布把工作区中的数据库提供给其他工作区，另一工作区再通过数据订阅建立对发布的访问关系。删除订阅不删源数据；删除发布前，先检查现有订阅和下游依赖。

下一步

最后更新于