与组织内的其他用户共享您使用 Agent Designer 创建并启动的工作流代理。
借助智能体分享功能,您可以:
- 与组织中的用户和群组共享实时代理。
- 设置自定义跑步时间表或基于事件的触发器。
- 跟踪预览执行和自动化运行。
- 复制共享的工作流智能体,以自定义其步骤。
根据应用的功能控制配置,您可能需要管理员审核并批准您的请求,然后才能共享代理。
共享工作流智能体
如需共享工作流代理,请执行以下操作:
应用
打开 Gemini Enterprise 应用,然后前往 Agent Gallery 页面。
系统随即会显示Agent Gallery页面,其中会显示所有预建代理和自定义代理。
在您的代理部分,找到您要共享的代理。
在 Agent Designer 画布的右上角标题中,点击
共享。输入您要与之共享代理的用户或 Google 群组的电子邮件地址。
点击完成。
管理员审核控制
默认情况下,代理所有者可以与组织内的任何用户共享其代理,而无需应用管理员批准。不过,应用管理员可以更改应用功能控制配置,以要求在应用中共享代理时必须经过管理员审核和批准。
默认情况下,代理所有者无法与群组共享其代理。 不过,Gemini Enterprise 应用管理员可以选择让智能体可与 Google 群组共享,无论是否需要管理员批准。
分享流程
只有首次共享代理需要管理员审核和批准。后续的代理修订版本无需重新获得批准。
如果启用了管理员审核,智能体共享流程分为两个步骤:
代理所有者与一位或多位用户或 Google 群组共享代理。
应用管理员审核共享请求,然后批准或拒绝该请求。
审核共享请求
应用管理员负责审核和管理代理共享请求。
控制台
如需以应用管理员身份审核共享请求,请执行以下操作:
在 Google Cloud 控制台中,依次前往 Gemini Enterprise > 应用页面。
点击包含代理的应用的名称。
在应用导航菜单中,点击代理。
在用户权限列中找到具有审核共享请求操作的代理。

点击审核共享请求。
在共享请求窗格中:
- 查看请求与以下用户共享下的访问权限列表。
- 可选:修改访问权限列表,以添加或移除用户账号、Google 群组或 WIF 身份池。
如要批准请求并授予访问权限,请点击批准并启用。
如需拒绝请求,请点击拒绝。
使用共享代理
当代理所有者与您共享工作流代理时,您可以访问并预览其图配置。虽然工作流图表对共享用户而言是只读的,但您可以手动运行预览版、配置自己的触发器设置、查看自己的运行历史记录或复制代理。
应用
- 在浏览器中打开 Gemini Enterprise Web 应用。
- 在 Web 应用导航菜单中,点击
代理。 - 前往与我共享 > 来自您组织的成员部分。
点击要查看的共享工作流代理。 代理会在只读设计工具布局中启动,并显示实时节点图。 注意:如果共享代理被暂停或关闭,Agent Designer 画布不会呈现,但您仍然可以查看其运行情况。
可选:如需手动测试运行代理工作流,请执行以下操作:
- 点击 Agent Designer 画布右上角标题中的预览。
- 运行预览。如果预览运行失败,原因是工作流使用的连接器未获得授权,请点击错误消息下方的启用连接器,以完成 OAuth 流程。
设置您自己的触发器
共享代理上的触发器是特定于用户的。您可以配置自定义运行时间表或事件过滤条件,以自动运行共享代理。
如需设置自己的触发器,请执行以下操作:
应用
- 在浏览器中打开 Gemini Enterprise Web 应用。
- 在 Web 应用导航菜单中,依次点击
代理 > 库。 - 前往与我共享 > 来自您的组织部分,然后点击要为其设置触发器的共享工作流代理。
访问触发器配置:
- 依次选择 操作菜单 > 设置触发器。
- 或者,在 Agent Designer 编辑器画布中打开工作流代理,点击代理标题,然后选择设置触发器。
您可以使用以下任一模式配置触发器:
- 时间安排:选择按计划运行,然后配置代理为您运行的时间(例如频率和时区)。
- 事件:选择在应用事件发生时运行,然后配置事件过滤器以指定代理何时为您运行。
例如,对于 Google 云端硬盘事件触发器,您可以按“所有者”(例如 Google ID,如
janedoe)、“名称”“MIME 类型”“修改时间”或“父文件夹”等字段进行过滤。您可以选择一个运算符(例如包含或等于),输入一个值,然后使用与或或条件组合多个规则。
如果工作流使用的连接器需要进行身份验证(例如,代理步骤中使用的连接器,而不是触发器本身),请在系统提示时在 Agent Designer 画布编辑器中启用并授权这些连接器。
点击保存。系统会保存触发器,并自动运行代理。您可以手动触发代理,以预览当调度或事件触发器运行此代理时会发生什么情况。 如果您希望代理停止运行,请在设置触发器窗口中选择不根据应用事件运行或不按计划运行。
查看跑步记录
如需查看跑步记录,请执行以下操作:
应用
- 在 Web 应用导航菜单中,点击
代理。 - 前往与我共享 > 来自您的组织部分,然后点击共享的工作流智能体。
- 在 Agent Designer 画布中,点击运行标签页。
- 点击特定运行,即可查看其执行日志和逐步轨迹。
如需了解详情,请参阅工作流代理运行。
创建共享工作流代理的副本
对于共享用户,共享代理是只读的,触发器配置除外。如果您想修改和自定义共享智能体的工作流步骤,可以在自己的工作区中创建副本。
如需创建共享代理的可修改副本,请执行以下操作:
应用
- 在浏览器中打开 Gemini Enterprise Web 应用。
- 在 Web 应用导航菜单中,依次点击
代理 > 库。 - 前往与我共享 > 来自您的组织部分,然后点击要复制的共享工作流代理。
- 在 Agent Designer 编辑器画布中,点击代理标题,然后选择复制。该副本会添加到您的代理列表中。
共享代理依赖项
如果您的代理在其工作流步骤中导入并引用其他代理(子代理),请注意以下几点:
- 访问权限要求:当您共享父智能体或将代理导入到您的代理中时,请确保访问权限列表中的所有用户也拥有对所有导入的子代理的访问权限。
- 运行失败:如果用户在没有对导入的子代理的访问权限的情况下运行代理,则运行会失败,并显示一条消息,要求用户向所有者请求访问权限。
注意事项
如果代理所有者启用新版本或更新工作流代理的有效版本,所有共享用户都会在后续执行中自动运行新的有效版本。
如果智能体被关闭或暂停,智能体设计器画布不会呈现,共享用户无法运行该智能体,但仍可在运行库中查看其过往的运行历史记录和会话日志。如果代理被取消分享、停用或删除,分享用户将失去所有访问权限,包括对过去运行历史记录和会话日志的访问权限。
修改外部数据的操作需要人机协同 (HITL) 审批,但您发送给自己的电子邮件或日历活动除外。
后续步骤
- 了解如何创建工作流代理。
- 了解如何修改工作流代理。
- 了解如何管理工作流代理版本。
- 了解如何监控工作流代理运行情况。