本页面解答了有关管理和使用 Gemini Enterprise 许可的常见问题。
管理订阅
本部分介绍了与管理 Gemini Enterprise 订阅相关的常见问题。
为什么我无法查看和修改订阅,包括收回和分配许可?
您必须具有 Billing Account Administrator 角色才能管理订阅。您还可以使用具有特定权限的自定义角色。验证您是否拥有此角色或所需权限。如果您没有上述任一角色,请与您的结算账号管理员联系。
有关详情,请参阅:
我可以更新订阅名称吗?
不可以,订阅创建后,您无法更新订阅名称。
如果订阅名称显示为 n/a,则表示该订阅是通过销售渠道或线下订单表单购买的,但这并不意味着该订阅无效。
我可以减少许可数量吗?
不可以,您无法在有效订阅期内减少许可数量。 只有在订阅期结束或续订时,才能减少许可数量。
为什么我无法通过 Google Cloud 控制台修改或管理订阅?
如果您是通过线下订单购买的订阅,则无法直接在 Google Cloud 控制台中修改或管理该订阅。线下订单表单在控制台的自助服务界面之外处理。如需对订阅进行任何更改或更新,例如调整许可数量或续订,请与您的 Google 客户经理联系。
为什么“管理用户”页面上的“修改”功能处于关闭状态?
在管理用户页面的 Gemini Enterprise 许可部分中,修改按钮处于关闭状态。
您无法直接在此页面上修改订阅设置。如需更新许可数量等设置,请参阅更新订阅设置。
尝试购买新订阅时出现 Subscription already exists 错误是什么意思?
此错误表示,您的 Cloud Billing 账号已具有同一 Gemini Enterprise 版本的有效订阅,无论订阅周期是按月还是按年。一个 Cloud Billing 账号一次只能有一个有效订阅。
如需在其他项目中使用现有订阅,请执行以下操作:
我可以将订阅周期从按月改为按年,或从按年改为按月吗?
不能,您无法直接在 Google Cloud 控制台中更改有效 Gemini Enterprise 订阅的结算周期。在当前订阅有效期间,您也无法在同一 Cloud Billing 账号中为同一版本购买第二个订阅。
如需在按月结算周期和按年结算周期之间切换,请选择以下选项之一:
- 在当前期限结束时改换。通过清除自动续订取消当前订阅。您的订阅在当前结算期结束之前仍然有效。订阅到期后,请购买新的订阅,选择您偏好的结算周期,然后将许可分配给您的项目。
- 在当前期限结束前切换:请与 Cloud Billing 支持团队或您的 Google Cloud 销售代表或客户经理联系,请求提前取消有效订阅。取消完成后,请购买新的订阅,并选择您偏好的结算周期。
免费试用许可是否包含 AI 开发者工具配额?
这取决于您的项目关联的 Cloud Billing 账号类型:
- 自助(在线)结算账号:否。免费试用订阅不包含对 AI 开发者工具的访问权限。如需使用 AI 开发者工具,您必须拥有有效的非试用订阅。
- 账单结算账号:是。免费试用订阅包含 AI 开发者工具的访问权限,但配额有限。
无论结算账号类型如何,免费试用订阅都不符合超配额用量随用随付的条件。
对于其他 Gemini Enterprise 功能,免费试用席位与付费席位共用相同的项目级池化配额分配。如需详细了解每周池计算,请参阅标准版和 Plus 版的配额。
分发和分配许可
本部分介绍了与向项目和用户分发和分配 Gemini Enterprise 许可相关的常见问题。
我可以在多个项目中使用一个 Gemini Enterprise 订阅吗?
可以,Gemini Enterprise 订阅在结算账号级别进行管理,您可以根据需要将许可分配给多个项目,从而灵活管理不同开发或生产环境中的访问权限。通过基于许可的订阅(例如 Gemini Enterprise Standard 或 Plus),您可以将许可分配给与任何 Cloud Billing 账号关联的项目。通过随用随付订阅,您只能将许可分配给与拥有该订阅的 Cloud Billing 账号关联的项目。
我可以将许可分配给其他组织或结算账号中的项目吗?
可以。许可分配规则取决于您的订阅版本:
- 基于席位的订阅(例如 Gemini Enterprise Standard 和 Plus):您可以将许可分配给不同 Google Cloud 组织中的项目以及与不同 Cloud Billing 账号关联的项目。
- 随用随付订阅:您可以将许可分配给不同组织中的项目,但目标项目必须关联到拥有随用随付订阅的同一 Cloud Billing 账号。
如何将许可移动或共享到其他项目或位置?
如需将许可分配移动、共享或更正到同一 Cloud Billing 账号下的其他项目或位置,请按照以下步骤操作:
- 在来源项目中取消分配许可:如果许可已分配给来源项目和位置中的用户,请在管理用户页面上从这些许可中移除用户。您只能收回未分配的许可(尝试收回已分配的席位会返回
Not enough licenses remaining错误)。 - 将未分配的许可回收至结算账号:从源项目和位置回收未分配的许可,以便将其返回到 Cloud Billing 账号的未分配订阅池。您每天只能执行一次此操作。
- 将许可分配到目标项目或位置:使用Google Cloud 控制台或 REST API 将订阅池中的可用许可分配到目标项目或位置。
- 将许可分配给用户:将分配的许可分配给目标项目和位置中的用户。
如何查看许可分配到的项目列表?
如需查看哪些项目从您的 Gemini Enterprise 订阅中分配了许可,请使用 REST API。订阅详情方法可提供您所需的信息,包括您如何在与结算账号关联的项目之间分配许可。
我可以在不同的项目中使用分配给我的许可吗?
不可以,用户的 Gemini Enterprise 许可仅在您分配该许可的特定项目中有效。虽然您在结算账号级别管理订阅,但您需要按项目分配许可。因此,如果您需要在多个项目中使用 Gemini Enterprise 功能,则必须明确向每个项目分配许可。
我可以将订阅转移到其他 Cloud Billing 账号吗?如果我更改项目的结算账号,会发生什么情况?
不可以。Gemini Enterprise 订阅与购买时使用的 Cloud Billing 账号相关联,无法转移到其他 Cloud Billing 账号。
如果您需要将项目移至新的 Cloud Billing 账号,请执行以下操作:
- 旧结算账号中的现有订阅:原始订阅仍保留在旧 Cloud Billing 账号中,并继续在该账号中结算,直到到期或取消。如果您想在仍与旧 Cloud Billing 账号关联的其他项目上重复使用该项目的席位,请先从许可中移除用户,并将未分配的许可回收到旧 Cloud Billing 账号,然后再更改项目的结算账号。
- 在新结算账号下为项目授予许可:
- 按席位订阅(例如 Gemini Enterprise Standard 和 Plus):由于按席位许可支持跨结算账号分配,因此在项目迁移到新结算账号后,之前从旧 Cloud Billing 账号分配的许可会继续有效,但订阅费用仍会从旧账号中扣除。如果您希望在新的 Cloud Billing 账号下进行订阅结算,请在新的 Cloud Billing 账号中购买订阅,将许可分配给项目,然后将用户转移或分配到新订阅。
- 随用随付订阅:您只能将许可分配给与拥有订阅的 Cloud Billing 账号关联的项目。如果使用随用随付方案的项目移至新的 Cloud Billing 账号,您必须在新的 Cloud Billing 账号中订阅随用随付版本,并从该账号分配许可。
问题排查
本部分介绍了与 Gemini Enterprise 许可相关的常见问题及其解决方案。
为什么我无法分发许可?
请检查以下详细信息:
- 验证您是否已在要分配许可的项目中启用 Discovery Engine API。
-
验证您是否拥有 Billing Account Administrator 角色 (
roles/billing.admin) 或具有所需权限的自定义角色。如需了解详情,请参阅“获取 Gemini Enterprise 订阅并分配许可”中的“准备工作”。 - Google Cloud 控制台不支持将许可分发到多个项目。因此,请使用 REST API 方法执行此任务。
- 在订阅详情页面上验证订阅的订单状态。如果订阅已过期,则系统不会显示分配许可按钮。如需了解详情,请参阅为什么我的订阅缺少“分配许可”按钮或“添加用户”功能处于关闭状态?
为什么我的订阅缺少“分配许可”按钮,或者“添加用户”功能处于关闭状态?
Google Cloud 控制台仅显示许可仍可使用的订阅的许可操作:
在订阅详情页面上,仅当订单状态为未开始、有效、正在停用或宽限期时,系统才会显示分发许可和分配许可按钮。当订单状态为已过期时,这些按钮不会显示,并且您无法分发或分配该订阅中的许可。
在管理用户页面上,如果所选项目和位置没有处于有效、停用或宽限期状态的许可,则添加用户按钮处于停用状态,并显示提示
Please add an active license configuration first to add users。添加用户窗格仅列出许可处于这些状态的订阅。
如需查看订阅状态,请参阅订阅状态简介。 如需为订阅已到期的用户恢复访问权限,请获取新订阅,将其许可分配给项目,然后将用户转移到新订阅。
Not enough licenses remaining 错误意味着什么?
此错误表示您尝试收回的许可数量超过了可用且未分配的许可数量。您只能收回未分配给用户的许可。如需解决此问题,请减少您尝试收回的许可数量,或取消分配用户的许可。
The quantity exceeds the maximum limit of seats for this account 错误意味着什么?
如果您直接在 Google Cloud 控制台中购买或修改许可,当您尝试购买的席位数超出 Cloud Billing 账号的上限时,就会出现此错误。
如果您尝试通过Google Cloud 控制台将席位数量增加到超出此上限,或者尝试向之前使用线下订单表单预配的席位数量超出此上限的账号添加席位,则操作会失败,并显示席位上限错误。
如需申请超出在线上限的席位数,请与您的 Google Cloud 销售代表或客户经理联系,以更新您的订单或为您的结算账号申请许可清单例外。
404 Error: License config not found 错误意味着什么?
此错误表示请求参数存在问题。在回收或分配任何许可之前,请在“订阅详情”页面上验证订阅信息,并在“管理用户”页面上验证区域(当前位置)和许可配置 ID(订阅 ID)。
为什么用户拥有许可却无法使用 Gemini Enterprise 功能?
用户可能无法使用功能的常见原因:
- 订阅类型:检查用户的许可是否来自包含其尝试访问的特定功能的订阅类型。
-
IAM 角色:确认用户拥有 Gemini Enterprise 项目的 Gemini Enterprise 企业用户角色 (
roles/discoveryengine.agentspaceUser)。如需了解详情,请参阅 IAM 角色和权限。 - 员工身份联合:如果您使用的是员工身份联合,请验证其配置是否正确,因为配置错误可能会导致访问问题。
FAILED_PRECONDITION: Failed to allocate quota for agent creation 错误意味着什么?
调用 AgentService.CreateAgent(或在Google Cloud 控制台中创建自定义代理)时,您可能会遇到以下错误:
400 FAILED_PRECONDITION: Failed to allocate quota for agent creation.
此错误意味着调用用户或服务账号无权在目标项目和位置中创建自定义代理。请验证以下原因:
- 未向调用用户或服务账号分配有效许可:如需创建自定义代理,调用主账号必须在创建代理的项目和位置中持有有效的符合条件的许可。如果您要使用服务账号(例如在 CI/CD 流水线中或使用 Terraform)创建代理,请在该项目和位置中为服务账号的邮箱分配一个有效的许可席位。
- 一线员工版许可:拥有 Gemini Enterprise 一线员工版许可的用户可以与管理员发布的预建智能体互动,但无法创建自定义智能体。请将该用户的许可升级到 Gemini Enterprise Standard 或 Plus,以便其创建自定义代理。
- 许可缓存传播延迟:如果您最近向用户或服务账号分发或分配了许可,请等待 5 到 15 分钟,让后端使用权缓存完成同步,然后再调用代理创建 API。
为什么用户会在 Antigravity 中收到 No license available for this project and location 错误?
如果开发者在登录 Google Antigravity 时收到 No license available for this project and
location 错误,常见原因包括:
- 未为 AI 开发者工具设置结算账号:确认您的项目已关联到支持 AI 开发者工具的符合条件的 Cloud Billing 账号(升级后的自助在线结算账号、账单结算账号或账单结算账号的结算子账号)。如果您的结算账号仍处于 Google Cloud 免费试用期,请将其升级为付费结算账号,以便使用 AI 开发者工具。转销商管理的子账号不支持预付赠金。
- 所选位置没有有效的非试用订阅:验证您的项目在开发者选择的多区域位置(
global、us或eu)是否有有效的非试用 Gemini Enterprise 订阅。只有当您的项目关联到账单结算账号时,免费试用订阅才会包含 AI 开发者工具。 - 所有席位均已分配:检查您在所选位置的订阅是否还有未分配的席位。在管理用户页面上分配许可,或为您的订阅添加席位。
- 选择了错误的项目:确认开发者选择了分配有 Gemini Enterprise 许可的Google Cloud 项目。
- AI 开发者工具切换开关未开启:对于现有订阅,管理员必须在 AI 开发者工具设置中为该位置手动开启 AI 开发者工具切换开关。
- 缺少 IAM 角色:确认开发者在项目中拥有 Gemini Enterprise User 角色 (
roles/discoveryengine.agentspaceUser)。
如需解决这些问题,请参阅排查 AI 开发者工具启用问题。