标签管理概述

资源标签是一组键值对（Key-Value）。您可以通过标签从不同维度对一站式 AI 平台内的资源进行分类与聚合管理，并用于按标签筛选等场景。

功能优势

资源标签作为 一站式 AI 平台资源管理的常用工具，具备以下优势：

• 便捷性：资源标签提供统一的、可视化操作的控制台，查询并管理标签相关的所有 AI 资源。
• 灵活性：资源标签支持通过控制台对标签进行单个或批量的增删改查操作。
• 可见性：支持通过资源标签按不同维度进行分账管理，使企业各部门、各项目的 AI 资源成本更加清晰。

标签管理概念

用户为资源添加的标签均为自定义标签，这些标签完全由您控制，可以根据业务需求自由定义。例如：

• 项目标签：Project: ChatBot-2024、Project: ImageRecognition
• 环境标签：Environment: Development、Environment: Staging、Environment: Production
• 部门标签：Department: AI-Research、Department: Product-Dev

您可以在一站式 AI 平台控制台直接为资源绑定自定义标签，也可以在项目规划阶段预先设置好标签模板，后续创建资源时直接使用这些预设标签进行标记和管理。

注意

本文术语资源指可在一站式 AI 平台中被创建、管理并支持绑定标签的实体对象，包括但不限于：开发机、任务、任务组、推理服务、镜像等。每个资源具备唯一的 ID，可与一个或多个标签键值对建立绑定关系。

标签键值对

标签由标签键（Key）和标签值（Value）组成，类似于给资源贴上便签。例如，您可以为一个自定义镜像添加标签 Environment: Production 来表示这是一个生产环境的自定义镜像，或者添加 Team: Agent 来标识智能体团队负责的资源。

这种 Key: Value 结构带来更清晰的分类和更强的可用性：

• 更强的筛选与组合：可以按 Key 快速筛选（如所有 Team），也可按具体值精准查询（如 Team: Agent），并支持多条件组合（如 Team: Agent 且 Environment: Production）。
• 统一词汇与标准：用固定的 Key（如 Environment、Team、Project）承载组织内通用语义，减少自由标签造成的同义词、错拼、口径不一致问题。
• 分析与报表友好：结构化的 Key/Value 更利于成本分账、资源统计与趋势分析，能直接用于看板和自动化流程。

注意

• 同一资源可以同时绑定多个标签键值对：比如同一个模型可以同时有 Environment: Production 和 Team: Agent
• 一个 Key 可以对应多个不同的 Value：比如一个 Environment Key 可以通过不同的 Value 生成 Environment: Development 和 Environment: Production 两个标签（设置时需要区分英文大小写，支持中文）
• 注意避免冲突与歧义：同一 Key 在同一资源上可能有多个值，例如资源可能同时被标记为 Environment: Development 和 Environment: Production。建议在规划标签策略时，约定同一 Key 在同一资源上只能赋单个值，避免混乱和歧义。

标签键值对的命名规则

标签键和标签值在命名时遵循以下规则：

• 大小写敏感存储：系统会保留您输入的确切大小写格式，并在界面上按原样显示。例如，输入 Environment 会显示为 Environment，输入 environment 会显示为 environment。
• 大小写不敏感验证：在验证唯一性时，系统不区分大小写。这意味着：
  • 如果已存在标签键 environment，则无法再添加 Environment、ENVIRONMENT 或其他大小写变体
  • 同样适用于标签值，如果已存在值 production，则无法添加 Production、PRODUCTION 等变体
• 唯一性约束：每个资源上的相同标签键只能有一个值，但不同大小写变体的键被视为相同键

这种设计既保持了标签命名的灵活性（允许不同大小写格式），又确保了标签系统的有序性（防止重复）。

标签设计原则

• 覆盖到位：核心资源在创建/规划阶段就打上关键标签。
  • 例：有 5 个业务团队，可用 Department 作为 Key，分别打上 Department: Search、Department: Ads、Department: Growth、Department: Infra、Department: Finance。
• 少而精：同一属性只用一个 Key 表达，避免多个别名。
  • 例：用 Environment: Development|Staging|Production；不要再加 isProd、prod、正式 等同义/冗余标签。
  • 例：如果统一使用 Owner，就不要再新增 Belonger、Possessor、负责人 等变体。

使用标签管理页面

在标签管理页面上您可以对多个可用区下多个服务的资源进行批量标签管理。

标签管理流程

通过以下步骤学习如何创建、浏览、删除标签，并查看标签已关联资源数量。

1. 访问一站式 AI 平台标签管理页面。

   标签管理

2. 浏览标签：在「我的」/「全部」页签间切换查看详情，可按标签键关键词进行搜索，快速定位目标标签。每个标签值都会展示对应的「绑定资源数」。

3. 新建标签：点击「创建标签」，输入标签键与标签值；「标签值」输入框中支持输入多个值，输入完成后按回车新增待添加标签值；点击「添加标签」可继续新增标签键（单次最多 10 个标签键）；确认无误后点击「确定」完成创建。

   注意

   如需为已有标签键新增标签值，点击创建标签，选择已有标签键即可。

4. 查看标签的绑定资源：选择目标标签，点击资源绑定管理可按「开发机」「任务」「任务组」「推理服务」「镜像」进行标签绑定与解绑。

5. 删除标签：在列表中选择要删除的标签值，点击删除，在二次确认弹窗中点击确定完成删除；支持多选批量删除。

   警告

   已绑定资源的自定义标签不可直接删除。

为标签绑定和解绑资源

为标签绑定资源是指将某一标签键值对关联到一个或多个资源的操作，使这些资源纳入该标签的分类体系，便于筛选、统计等场景；绑定关系可在资源绑定管理中查看和维护。

1. 访问一站式 AI 平台标签管理页面。

   标签管理

2. 绑定资源：找到需要使用的自定义标签，点击资源绑定管理。在弹窗中已按「开发机」「任务」「任务组」「推理服务」「镜像」分组展示当用户有权查看的资源。勾选目标资源后点击确认即可完成绑定。

   注意

   如果单个资源（例如单台开发机）已被绑定 20 个自定义标签，则已达到上限。需要先解绑才能绑定新的自定义标签。

3. 解绑资源：找到需要使用的自定义标签，点击资源绑定管理。在弹窗底部，查看当前已绑定标签，点击右侧删除按钮后，点击确认完成解绑操作。

在使用资源时管理标签

您可以在控制台中开发机、推理服务、任务、镜像页面进行标签管理。以开发机为例，标签的操作步骤在不同服务的页面都是类似的。

创建资源时绑定新标签

在创建开发机、推理服务、任务、任务组、镜像时，可完成标签新增、绑定标签等相关操作。

1. 访问智算云平台控制台，以创建开发机为例。
2. 在创建开发机页面的「基本信息」区域，找到标签，可为当前开发机新建和绑定自定义标签。
3. 点击确认创建按钮，在创建资源时同时完成标签创建和绑定操作。

为已创建的资源编辑标签

在开发机、推理服务、任务、任务组、镜像的列表页面，可完成标签新增、绑定标签等相关操作。

1. 访问智算云平台控制台，以开发机为例。
2. 在开发机列表页面中，找到标签列，可查看和编辑与当前开发机绑定的标签。
3. 点击编辑图标，可为当前开发机完成标签新增、编辑、删除等相关操作。
4. 点击确认按钮，完成标签管理操作。

通过标签检索资源

在开发机、推理服务、任务、任务组、镜像的列表页面，可完成标签筛选当前服务下的资源。

1. 访问智算云平台控制台，以开发机为例。
2. 在开发机列表中，找到标签列，点击表头旁边的筛选图标。
3. 您可以搜索标签键或标签值，选中标签键后，在二级菜单选择需要筛选的标签值。可跨标签键叠加多个自定义标签值。
4. 点击确定按钮，完成筛选。