通过 Google Cloud 控制台共享智能体

本页介绍了如何与组织中的用户共享代理，以及管理员如何转移共享代理的所有权。作为管理员，您可以与组织中的个人用户、群组、员工身份池群组或所有用户共享可用的代理（Google 制作的代理、员工制作的代理和自定义代理），并将共享的员工制作的代理的所有权转移给自己或其他用户。如需详细了解 Gemini Enterprise 中提供的不同类型的代理 ，请参阅 代理概览。

**注意**： 如需共享员工制作的智能体，您必须在 Gemini Enterprise Web 应用中使用 Workflow Builder 创建一个或多个智能体。如需了解如何使用 Workflow Builder 创建智能体，请参阅使用 Workflow Builder 创建智能体。

准备工作

您必须满足以下要求，然后才能共享代理：

1. 您必须拥有现有的 Gemini Enterprise Web 应用。如需创建新应用，请参阅 创建应用。

2. 如需共享自定义代理，您必须使用以下任一选项在 Gemini Enterprise 中注册或添加自定义代理：

   • 注册和管理 A2A 智能体
   • 注册和管理托管在 Gemini Enterprise Agent Platform 上的 Agent Runtime 中的 ADK 代理
   • 添加和管理来自 Google Cloud Marketplace 的 A2A 代理
   • 注册和管理 Dialogflow 代理

共享代理

如需共享代理，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

前往 Gemini Enterprise

1. 选择您的项目。

2. 点击名称 列中的应用。导航菜单会更新。

3. 在导航菜单中，点击代理 。

4. 点击要共享的代理的显示名称。

5. 点击用户权限标签页，系统会显示拥有权限的用户页面。

6. 点击添加用户。系统会显示向代理添加用户权限角色 对话框。

7. 配置权限详细信息：

   1. 在成员类型部分中选择以下选项之一：

      • 用户：单个最终用户。如需使此会员类型正常运行，您必须添加正确的 IAM 角色。如需了解详情，请参阅 IAM 角色和权限。

      • 群组：一组最终用户。如需使此会员类型正常运行，您必须添加正确的 IAM 角色。如需了解更多 信息，请参阅 IAM 角色和 权限。

      • 主账号：员工身份池群组中的单个身份， 包括不受管理的外部群组 Google。

      • 员工身份池：员工身份 池中的所有身份。

      • 所有用户：组织内的所有用户。

   2. 输入唯一的成员标识，然后选择角色：

      成员类型	说明
      用户	在成员 字段中输入邮箱。 在分配角色 字段中选择一个角色。
      群组	在成员 字段中输入邮箱。 在分配角色 字段中选择一个角色。
      主账号	WIF 中的单个身份。
      员工身份池	在成员 字段中输入 主账号标识符。 在分配角色 字段中选择一个角色。 如需查看主账号集示例，请参阅主账号集。
      所有用户	在分配角色 字段中选择一个角色。

8. 点击保存 。

主账号集

以下是您可以为员工身份池 成员类型指定的主账号集示例：

主账号集	说明
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID	WIF 中的单个身份。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/GROUP_ID	群组中的所有员工身份。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE	具有特定属性值的所有员工身份。
//iam.googleapis.com/locations/global/workforcePools/POOL_ID/*	员工身份池中的所有身份。

将以下占位符替换为代码示例中的值：

• PROJECT_NUMBER：资源路径中用于标识特定 Google Cloud 项目的编号 。
• GROUP_ID：外部身份提供方 (IdP) 中的特定群组标识符，可让您向该群组的所有成员授予访问权限。
• POOL_ID：您在 Google Cloud中创建的员工身份 池的唯一 ID。
• SUBJECT_ID：员工身份池中单个身份的唯一主体标识符。
• ATTRIBUTE_NAME：您从外部身份提供方 (IdP) 映射的自定义属性的用户定义名称。
• ATTRIBUTE_VALUE：用于限制访问权限的 ATTRIBUTE_NAME 的特定值。

转移代理所有权

作为管理员，您可以将共享代理的所有权转移给组织中的其他用户或自己。此功能在以下场景中非常有用：

• 员工离职： 将离职员工创建的代理转移给在职团队成员，以确保维护不中断。
• 承包商交接： 将临时工或合同工创建的代理交给全职员工。
• 团队重组： 随着角色或项目的变化，重新分配代理职责。

注意事项和限制

在转移代理所有权之前，请注意以下注意事项和限制：

• 管理员权限： 只有具有 Gemini Enterprise Admin 角色 (roles/discoveryengine.agentspaceAdmin) 或 Discovery Engine Admin 角色 (roles/discoveryengine.admin) 的管理员才能转移代理所有权。除非当前代理所有者也是管理员，否则无法转移所有权。
• 仅限共享代理： 您只能转移已共享的代理的所有权。在 Google Cloud 控制台的代理 页面中， 代理的共享 列必须显示已启用。无法转移专用（未共享）代理。
• 单个所有者： 每个代理有且仅有一个所有者。转移所有权后，所选接收者将成为代理的唯一所有者。
• 先前所有者的访问权限： 转移所有权后，先前所有者将降级为具有 agentUser 角色的代理用户。他们保留查询和运行代理的权限，但无法再修改代理的配置或设置。
• 支持的代理类型： 员工制作的代理（在 Web 应用中创建的低代码代理和工作流代理）支持所有权转移。
• 具有时间表或触发器的代理： 如果转移的代理具有时间表触发器或事件触发器，转移操作会将它们标记为已停用的时间表或事件。新所有者必须先启用时间表或事件触发器，然后才能使用该代理。

转移代理的所有权

如需转移代理的所有权，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往 Gemini Enterprise 页面。

   前往 Gemini Enterprise

2. 选择您的项目。

3. 点击名称 列中的应用。导航菜单会更新。

4. 在导航菜单中，点击代理 。

5. 点击共享代理的显示名称 。

6. 点击用户权限 标签页。系统会显示拥有权限的用户 列表。

7. 点击转让所有权 。系统会打开转让所有权 对话框。

8. 在将所有权转让给 下，选择以下选项之一：

   • 我自己：将代理的所有权转移给您当前的 管理员账号。如果您已拥有该代理，此选项将被停用。
   • 其他用户：将所有权转移给组织中的其他用户。

9. 如果您选择了其他用户，请指定新所有者：

   • Google Identity 和 Cloud Identity： 在新所有者电子邮件地址 字段中输入用户的电子邮件地址（例如 [e-mail]）。
   • 员工身份联合 (WIF) 账号： 在新所有者主账号 字段中输入单个身份主账号标识符：

   //iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   或者，您也可以添加 principal: 前缀：

   principal://iam.googleapis.com/locations/global/workforcePools/POOL_ID/subject/SUBJECT_ID
   

   替换以下内容：

   • POOL_ID：员工身份池的唯一 ID。
   • SUBJECT_ID：用户在员工 身份池中的主体标识符。
   注意：员工身份联合主账号标识符 区分大小写。确保标识符与身份提供方的google.subject 映射中配置的大小写完全一致。

10. 点击转让所有权 。

    代理的所有者已更新。先前所有者将保留为具有 agentUser 角色的拥有权限的用户。

    注意 ：如果转移的代理具有时间表触发器或事件触发器，转移操作会将它们标记为已停用的时间表或事件。新所有者必须先启用触发器，然后才能使用该代理。