共享工作流

与组织内的其他用户共享您使用 Workflow Builder 创建并启动的工作流。

借助工作流共享，您可以：

• 与组织中的用户和群组共享实时工作流。
• 设置自定义运行时间表或基于事件的触发器。
• 跟踪预览执行和自动运行。
• 复制共享的工作流，以便自定义其步骤。

根据应用的功能控制配置，您可能需要管理员审核并批准您的请求，然后才能共享工作流。

如果您共享工作流，则共享对象将看到并使用实时版本。

注意：分享代理时，请考虑以下数据访问行为：

• 知识文件：任何有权访问共享代理的用户都可以查询和查看上传到代理知识部分的文件中的信息，即使他们没有直接访问或权限访问源文件。例如，如果您将机密文件上传到知识部分，则所有有权访问共享代理的用户都可以询问有关该文件内容的问题。
• 连接器和数据存储区：当智能体通过连接器访问数据时，系统会保留用户访问控制列表 (ACL) 和权限。用户只能查询和检索其个人用户账号有权访问的数据存储区和连接器中的数据。

分享工作流

如需共享工作流，请执行以下操作：

应用

1. 打开 Gemini Enterprise 应用，然后前往 Agent Gallery 页面。

   系统随即会显示代理库页面，其中会显示所有预建代理和自定义代理。

2. 在您的智能体部分中，找到要分享的工作流。

   注意： 您可以共享处于 draft 状态的工作流，但其他用户必须先开启该工作流，然后才能运行。

3. 在 Workflow Builder 画布的右上角标题中，点击 分享。

4. 输入要与之共享工作流的用户或 Google 群组的邮箱。

   注意： 您可以与个人用户邮箱共享工作流。未为最终用户启用 Google 群组共享功能。Gemini Enterprise 应用管理员或具有 Discovery Engine Admin (discoveryengine.admin) 角色的任何用户都可以在 Gemini Enterprise 应用级别启用群组共享。

5. 点击完成。

   注意： 如果您的应用管理员已为工作流共享启用管理员审核，则系统会向应用管理员发送共享请求，以供审核和批准。应用管理员批准请求后，工作流会与访问权限列表中的用户共享。您可以随时修改共享请求来添加或移除用户，也可以取消请求。

管理员审核控制

默认情况下，工作流所有者可以与组织内的任何用户共享其工作流，而无需应用管理员批准。不过，应用管理员可以更改应用功能控制配置，要求管理员审核和批准应用中的共享工作流。

默认情况下，工作流所有者无法与群组共享其工作流。 不过，Gemini Enterprise 应用管理员可以选择允许与 Google 群组共享工作流，无论是否需要管理员批准。

分享流程

只有工作流的初始共享需要管理员审核和批准。后续工作流修订版本无需重新审批。

启用管理员审核后，工作流共享遵循两步流程：

1. 工作流所有者与一个或多个用户或 Google 群组共享工作流。

2. 应用管理员审核共享请求，并批准或拒绝该请求。

审核共享请求

应用管理员负责审核和管理工作流共享请求。

注意：

• 仅当应用的特征控件中停用了无需管理员批准即启用工作流共享特征时，本部分才适用。
• 只有具有 Gemini Enterprise Admin IAM 角色的应用管理员才能审核和批准共享请求。

控制台

如需以应用管理员身份审核共享请求，请执行以下操作：

1. 在 Google Cloud 控制台中，依次前往 Gemini Enterprise > 应用页面。

   Gemini Enterprise

2. 点击包含工作流的应用的名称。

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

4. 在用户权限列中找到具有审核共享请求操作的工作流。

   

5. 点击审核共享请求。

6. 在共享请求窗格中：

   • 查看请求与以下用户共享下的访问权限列表。
   • 可选：修改访问权限列表，以添加或移除用户账号、Google 群组或 WIF 身份池。

7. 如需批准请求并授予访问权限，请点击批准并启用。

8. 如要拒绝请求，请点击拒绝。

使用共享工作流

当工作流所有者与您共享工作流时，您可以访问和预览其图表配置。虽然工作流图表对共享用户是只读的，但您可以手动运行预览、配置自己的触发器设置、查看自己的运行历史记录或复制工作流。

应用

1. 在浏览器中打开 Gemini Enterprise Web 应用。
2. 在 Web 应用导航菜单中，点击 代理。
3. 前往与我共享 > 来自贵组织部分。

4. 点击要查看的共享工作流。 工作流会在只读设计器布局中启动，并显示实时节点图。注意：如果共享工作流被暂停或关闭，Workflow Builder 画布不会呈现，您也无法运行该工作流，但您仍然可以查看其之前的运行记录。

5. 可选：如需手动测试运行工作流，请执行以下操作：

   • 点击 Workflow Builder 画布右上角标题中的预览。
   • 运行预览。如果预览运行因工作流使用的连接器未获授权而失败，请点击错误消息下方的启用连接器，以完成 OAuth 流程。

设置您自己的触发器

共享工作流上的触发器因用户而异。您可以配置自定义运行时间表或事件过滤条件，以自动运行共享工作流。

如需设置您自己的触发器，请执行以下操作：

应用

1. 在浏览器中打开 Gemini Enterprise Web 应用。
2. 在 Web 应用导航菜单中，依次点击 代理 > 库。
3. 前往与我共享 > 来自贵组织部分，然后点击要为其设置触发器的共享工作流。

4. 访问触发器配置：

   • 选择 操作菜单 > 设置触发器。
   • 或者，在 Workflow Builder 编辑器画布中打开工作流，点击工作流名称，然后选择设置触发器。

5. 您可以使用以下任一模式配置触发器：

   • 时间表：选择按时间表运行，并配置工作流的运行时间（例如频率和时区）。
   • 事件：选择在应用事件发生时运行，并配置事件过滤条件，以指定工作流何时为您运行。例如，对于 Google 云端硬盘事件触发器，您可以按所有者（例如 Google ID，如 janedoe）、名称、MIME 类型、修改时间或父文件夹等字段进行过滤。您可以选择运算符（例如包含或等于），输入值，然后使用 AND 或 OR 条件组合多条规则。

6. 如果工作流使用的连接器需要身份验证（例如，在工作流步骤中使用的连接器，而不是触发器本身），请在 Workflow Builder 画布编辑器中根据提示启用连接器并为其授权。

7. 点击保存。触发器会保存并自动运行工作流。您可以手动触发工作流，以预览时间表或事件触发器运行此工作流时会发生什么。如果您希望工作流停止运行，请从设置触发器对话框中选择不针对应用事件运行或不按时间表运行。

查看运行作业

如需查看运行，请执行以下操作：

应用

1. 在 Web 应用导航菜单中，点击 代理。
2. 前往与我共享 > 来自您的组织部分，然后点击共享的工作流。
3. 在 Workflow Builder 画布中，点击运行标签页。
4. 点击特定运行可查看其执行日志和分步跟踪记录。

如需了解详情，请参阅工作流运行。

创建共享工作流的副本

共享工作流对共享用户而言是只读的，但其触发器配置除外。如果您想修改和自定义共享工作流的步骤，可以在自己的工作区中创建副本。

如需创建共享工作流的可修改副本，请执行以下操作：

应用

1. 在浏览器中打开 Gemini Enterprise Web 应用。
2. 在 Web 应用导航菜单中，依次点击 代理 > 库。
3. 前往与我共享 > 来自贵组织部分，然后点击要复制的共享工作流。
4. 在 Workflow Builder 编辑器画布中，点击工作流标题，然后选择制作副本。 副本会添加到您的代理列表中。

共享工作流依赖项

如果您的工作流在其工作流步骤中导入并引用其他工作流（子工作流），请注意以下事项：

• 访问权限要求：当您共享父级工作流或将工作流导入到您的工作流时，请确保访问权限列表中的所有用户也都有权访问所有导入的子工作流。
• 运行失败：如果用户在无权访问导入的子工作流的情况下运行工作流，则运行会失败，并显示一条消息，要求用户向所有者请求访问权限。

共享限制

共享工作流时，需遵循以下限制：

• 最多 1,500 个个人账号：Workflow Builder 使用底层 Google Cloud IAM 允许政策管理代理访问权限，这些政策强制规定每个政策最多只能有 1,500 个成员。与超过 1,500 个个人用户账号共享代理会导致操作失败，并显示以下错误：

  The number of members in the policy (1,501) is larger than the maximum allowed size 1,500.
  

• 使用群组进行大规模共享：每个 Google 群组或 Workspace 群组都算作一个成员，计入 1,500 名成员的政策上限。如果您需要与组织内的数百或数千名同事共享代理，请让应用管理员启用群组共享，并输入群组邮箱（例如 [e-mail]），而不是个人用户账号。

如需查看系统限制的完整列表，请参阅 Workflow Builder 配额和限制。

注意事项

• 如果工作流所有者启用新版本或更新工作流的实时版本，则所有共享用户都会在后续执行中自动运行新的实时版本。

• 如果工作流已停用或暂停，Workflow Builder 画布不会呈现，共享用户无法运行该工作流，但他们仍然可以在运行库中查看过去的运行记录和会话日志。如果工作流被取消共享、停用或删除，共享用户将失去所有访问权限，包括对其过去运行历史记录和会话日志的访问权限。

• 修改外部数据的操作需要人机协同 (HITL) 审批，但您发送给自己的电子邮件或日历活动除外。

• 应用管理员可以在 Google Cloud 控制台中将共享工作流的所有权转移给其他用户或自己。如果工作流具有时间表触发器或事件触发器，则转移操作会将其标记为已停用的时间表或事件，新所有者应在使用代理之前启用它们。如需了解详情，请参阅转移代理所有权。

后续步骤

• 了解如何创建工作流。
• 了解如何修改工作流。
• 了解如何管理工作流版本。
• 了解如何监控工作流运行。
• 查看 Workflow Builder 配额和限制。