> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 核心概念与对象关系

> 了解人工智能平台中的协作范围、部署位置、资源、资产、任务、服务和运行实例之间的关系。

本文帮助您理解人工智能平台中的主要对象，以及这些对象在开发环境、训练任务和推理服务运行时如何配合。

## 协作范围与部署位置

创建开发环境、训练任务或推理服务前，先确认“谁可以使用”和“在哪里运行”。这两个维度需要分别选择。

| 概念        | 说明                            | 使用时需要确认                               |
| --------- | ----------------------------- | ------------------------------------- |
| **租户**    | 企业或组织的管理范围。                   | 当前登录账号属于本次工作对应的租户。                    |
| **项目组**   | 团队协作和对象可见性的管理范围，不等于一组物理服务器。   | 对象归属哪个项目组，哪些成员可以查看或操作。                |
| **区域、集群** | 工作负载的部署位置，也是资源、镜像、数据和模型的可用范围。 | 所需资源和资产在同一区域、集群中可用；切换区域或集群后，应重新检查可选项。 |
| **资源池**   | 按资源类型、隔离方式和使用策略组织的计算资源。       | 有资源池使用权，资源池支持本次负载类型，并有合适实例规格和额度。      |

选择项目组不会自动授予资源池、镜像、模型或 Volume 权限。创建任务或服务时，需要同时满足对象可见性、资源使用权和数据读写权限。

## 工作负载引用资源和资产

下图以一个任务或服务为中心，说明创建配置与实际运行实例之间的关系。

<img src="https://mintcdn.com/siflow/avekptrv6O-LsLPz/ai-platform/get-started/media/platform-object-relationships-orange.svg?fit=max&auto=format&n=avekptrv6O-LsLPz&q=85&s=26783d300a7d8097b5808fcb7863480f" alt="平台对象与运行关系" width="1600" height="900" data-path="ai-platform/get-started/media/platform-object-relationships-orange.svg" />

图中的 **数据与模型** 表示输入文件。需要使用时，按对应模块支持的方式选择数据集、模型来源或存储挂载；不是每个工作负载都必须同时使用数据和模型。

| 对象             | 在创建和运行中的作用                      |
| -------------- | ------------------------------- |
| **项目组**        | 决定任务或服务的协作范围和可见性。               |
| **区域与集群**      | 决定任务或服务部署位置，以及可选资源和资产范围。        |
| **资源池与规格**     | 为任务或服务提供 GPU、CPU、内存等计算资源。       |
| **镜像**         | 提供容器运行所需的软件环境和镜像内代码。            |
| **数据与模型**      | 作为输入文件被工作负载读取，可来自数据集、模型来源或存储挂载。 |
| **任务或服务**      | 保存创建配置，是平台管理、查看、变更和排查的对象。       |
| **运行实例**       | 平台根据创建配置和资源调度结果启动的实际执行单元。       |
| **持久输出、日志与指标** | 分别用于保存运行结果、解释程序行为和观察运行趋势。       |

提交创建只表示平台接受了配置，后续还需要经过资源调度、镜像拉取、存储挂载和程序启动。

## 镜像、数据集、模型与 Volume

这几类对象承担不同职责。将它们分别管理，便于更新依赖、复用数据和保留成果。

| 对象         | 主要保存或描述什么             | 使用示例                              | 需要注意                                             |
| ---------- | --------------------- | --------------------------------- | ------------------------------------------------ |
| **镜像**     | 容器所需的软件环境，以及构建进镜像的代码。 | 固定 Python、训练框架、CUDA 和系统依赖版本。      | 保存镜像用于保留软件环境，不能替代存储备份。                           |
| **数据集**    | 已有数据的来源、路径及使用信息。      | 登记 Volume 或对象存储中的语料，供开发与训练读取。     | 数据集记录需要对应实际可访问的文件；登记数据集不等于复制底层文件。                |
| **模型**     | 模型名称、版本、来源及相关信息。      | 为推理指定权重、tokenizer 和配置文件。          | 模型记录需要对应实际可访问的文件；训练产物用于推理前，可能还需要整理或转换。           |
| **Volume** | 工作负载可挂载的持久文件空间。       | 保存项目代码、Notebook、训练结果和 checkpoint。 | 容器中的路径由挂载配置决定；例如程序读取 `/mnt/data`，就需要把目标数据挂载到该路径。 |

运行进度需要由程序保存，例如训练程序保存 checkpoint。平台可以重新拉起训练任务，但不能替代程序完成进度保存与加载。

## 任务、服务与运行实例

创建训练任务或推理服务时，您配置的是平台管理对象。平台会根据该配置启动一个或多个运行实例。

| 关系           | 说明                                | 使用时需要判断                      |
| ------------ | --------------------------------- | ---------------------------- |
| **创建配置**     | 包含镜像、命令、资源、挂载、端口、环境变量等信息。         | 配置是否与代码、数据、模型和资源需求匹配。        |
| **运行实例**     | 平台根据创建配置和资源调度结果启动的实际执行单元。         | 目标实例是否创建，就绪实例是否达到预期。         |
| **状态、事件和日志** | 记录对象生命周期、调度过程和程序运行输出。             | 是配置未生效、资源未调度，还是程序自身异常。       |
| **持久输出**     | 由程序写入 Volume 或其他持久存储，用于保存结果和恢复进度。 | 输出、checkpoint 或模型文件是否写入持久位置。 |

任务或服务与运行实例不能按数量直接等同。一个服务可能有多个副本，一个训练任务也可能包含多个角色或多个执行单元。

## 规格份数、副本与资源用量

**实例规格** 描述一份资源组合，例如 GPU、CPU 和内存。**规格份数** 决定一个执行单元申请多少份规格，**副本数** 决定需要多少个这样的执行单元。

例如，每份规格包含 2 张 GPU，每个副本使用 2 份规格，共运行 2 个副本：

| 计算项         | 计算结果              |
| ----------- | ----------------- |
| 单副本 GPU 需求  | 2 张 × 2 份 = 4 张。  |
| 全部副本 GPU 需求 | 4 张 × 2 副本 = 8 张。 |

CPU 和内存也按同样的份数与副本数计算。多角色任务需要逐角色汇总；多节点推理还需计入每组节点数，具体以对应创建页面的资源配置为准。

**额度** 表示允许使用的资源量，**可调度量** 表示当前条件下能够实际安排运行的资源量。额度足够时，任务或服务仍可能因为节点、规格组合、资源池状态或调度策略等待。

## 权限与可见性边界

项目组可见性、资源使用权和数据读写权限是不同的权限边界。

| 需求           | 需要具备的条件                          |
| ------------ | -------------------------------- |
| 查看任务配置、状态和日志 | 对象可见性及相应查看权限。                    |
| 停止、删除或修改对象   | 对应操作权限及对象范围授权。                   |
| 使用资源池提交任务或服务 | 资源池使用权、可用额度和适合的实例规格。             |
| 读取数据或写入结果    | Volume、目录或数据源的读写权限。              |
| 复用他人的配置      | 自己具备对应计算、镜像、模型和存储使用条件，并重新设置输出路径。 |

任务链接用于定位对象，本身不授予访问权限。分享配置、命令、环境变量或日志前，应先确认不包含密码、访问令牌、存储密钥或其他敏感信息。

## 后续操作

* [快速上手人工智能平台](./quickstart-ai-platform)
