通过 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. 在将所有权转移给下，选择以下选项之一：

   • Myself：将代理的所有权转移到您当前的管理员账号。如果您已拥有该代理，则此选项处于停用状态。
   • 其他用户：将所有权转移给组织中的其他用户。

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 角色的授权用户。

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