本文介绍如何在模型路由实例中创建用户组，并配置用户组限制、关联 API Key 及模型访问范围。
简介
用户组用于对模型路由访问密钥（API Key）进行分组管理。您可以按照团队、业务线、项目或环境创建用户组，并统一配置组内 API Key 可访问的模型、意图路由规则和资源限制。
前提条件
2. 已创建模型路由实例，详细操作指导请参见 创建模型路由实例。
3. 已创建 BYOK 实例，详细操作指导请参见 创建 BYOK 实例。
4. 已创建模型路由访问密钥（API Key），详细操作指导请参见 创建模型路由访问密钥。
5. 如需为用户组配置积分预算，请先创建积分预算。详细操作指导请参见 配置积分预算。
操作步骤
创建用户组操作步骤
1. 登录 模型路由 控制台，在实例管理页面，单击目标实例 ID。
2. 在实例详情页，选择用户组页签。
3. 在用户组页签中，单击新建用户组，在新建用户组弹窗中，按照页面提示完成用户组配置。
4. 配置用户组，填写用户组的基本信息。
参数 | 说明 |
用户组名称 | 自定义用户组名称，用于标识团队、业务线、项目或环境。最多支持 255 个字符。 |
用户组限制 | 可选。为用户组关联积分预算，用于限制组内 API Key 的积分消耗及调用速率。 |
标签 | 可选。配置标签键和标签值，用于对用户组进行分类管理。 |
5. 关联 API Key，选择需要分配至该用户组的 API Key。如果暂时不需要关联 API Key，可跳过该步骤，待用户组创建完成后再进行分配。详细操作指导请参见 分配 API Key 至用户组。
6. 关联模型和意图路由规则：为用户组指定可用的模型或意图路由规则。若不指定，默认允许使用当前 CMR 下所有模型和意图路由规则。
参数 | 说明 |
关联模型 | 选择用户组内 API Key 可以直接访问的模型。 |
关联意图路由规则 | 选择用户组内 API Key 可以使用的意图路由规则。 |
7. 配置完成后，单击保存。
删除用户组操作步骤
当业务不再需要按用户组维度管理 API Key 的可用模型、意图路由、积分预算、限速或标签策略时，您可以删除对应的自定义用户组，以简化资源管理。
1. 登录 模型路由 控制台，在实例管理页面，单击目标实例 ID。
2. 在实例详情页，选择用户组页签。
3. 在用户组页签中，在页面左侧的用户组列表中选择需要删除的用户组。
4. 清空组内 API Key。
若用户组内仍存在 API Key，请在下方 Key 列表中选择对应 Key，单击切换用户组，并将其迁移至其他用户组。
您也可以在更多操作中删除选中的 API Key。
说明：
当用户组内仍有关联 API Key 时，用户组详情区域的删除按钮将置灰，无法执行删除操作。
5. 发起删除。在用户组详情区域，单击删除。
6. 确认删除。在弹出的确认窗口中核对用户组信息，确认无误后单击确定。
其他操作
向用户组添加或转移 API Key，详细操作指导请参见 分配 API Key 至用户组。
调整用户组的积分预算，详细操作指导请参见 配置积分预算。
配置模型和意图路由规则，详细操作指导请参见 配置模型调度管理。