添加和管理来自 Google Cloud Marketplace 的 A2A 代理

管理员可以从 Google Cloud Marketplace 添加使用 Agent-to-Agent (A2A) protocol的代理。采购(购买)代理并将其添加到 Gemini Enterprise 后,用户可以通过 Gemini Enterprise Web 应用访问该代理。

准备工作

请确保您已备好:

将来自 Cloud Marketplace 的代理添加到 Gemini Enterprise

如需将来自 Cloud Marketplace 的代理添加到 Gemini Enterprise 应用,请按以下步骤操作:

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

    Gemini Enterprise

  2. 点击要向其添加代理的应用的名称。

  3. 依次点击代理 > 添加代理。

  4. 在选择代理类型部分,对于通过 Marketplace 获取的代理,点击添加。

  5. 搜索要添加的代理,然后点击该代理。您可以按代理名称进行搜索,也可以使用语义搜索,通过描述代理的功能或用途(例如“生成报告”或“翻译文本”)进行搜索。

  6. 点击下一步。

  7. 查看代理详情,然后点击下一步。

  8. 输入所需的身份验证详细信息,然后点击完成。

配置 Marketplace 公开范围

管理员可以决定 Cloud Marketplace 中的哪些代理对 Agent Gallery 中的最终用户可见。智能体的公开范围取决于其采购、集成和访问状态:

状态 说明
已采购 组织已购买的智能体。
集成 管理员在 Gemini Enterprise 应用中添加和配置的已采购智能体。用户可以访问或请求访问这些智能体。

如需配置 Marketplace 可见性,请执行以下操作:

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

    Gemini Enterprise

  2. 点击要配置的应用的名称。

  3. 点击代理。

  4. 点击“设置”图标,打开代理设置和配置面板。

  5. 在 Marketplace 公开范围部分中,选择以下选项之一:

    • 仅显示可访问的智能体:最终用户只能看到他们有权访问的智能体。如果没有可访问的代理,则不会显示 Marketplace 部分。
    • 仅显示已集成的智能体:最终用户只能看到已集成的智能体。这包括用户已拥有访问权限的代理以及他们可以申请访问权限的代理。
    • 仅显示已购买的智能体:(默认)最终用户会看到所有已购买的 Cloud Marketplace 智能体。这包括已集成的代理以及尚未集成的代理。
    • 全部显示:最终用户会看到所有 Cloud Marketplace 智能体,包括他们无权访问的智能体,无论这些智能体是采购的还是集成的。
  6. 点击完成以保存更改。

设置采购联系人

您可以设置联系人,以便在用户请求访问尚未采购的代理时接收通知。这些联系人会收到从 Cloud Marketplace 采购代理的通知。

如需设置采购联系人,请执行以下操作:

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

    Gemini Enterprise

  2. 点击要配置的应用的名称。

  3. 点击代理。

  4. 点击“设置”图标,打开代理设置和配置面板。

  5. 在采购联系人下,点击 + 添加联系人。

  6. 输入联系人的邮箱。

  7. 点击完成以保存更改。

查看并批准访问权限请求

当用户请求从 Cloud Marketplace 访问代理时,您需要审核并批准或拒绝这些请求。

如需审核访问权限请求,请执行以下操作:

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

    Gemini Enterprise

  2. 点击代理所属应用的名称。

  3. 点击代理。

  4. 如果代理已采购并集成,您可以授予访问权限。 代理列表会在具有任何访问权限请求的代理所在行中显示审核共享请求。选择审核共享请求,查看请求信息,然后点击授予访问权限以授予访问权限。

  5. 当代理需要采购或集成时,采购和集成请求上的红点表示有待处理的请求。点击采购和集成请求,即可查看和管理请求。

    • 查看请求列表。该列表会显示以下信息:

      • 显示名称:代理的名称。
      • 用户请求数量:请求使用该代理的用户数量。
      • 状态和操作:有关采购和集成的信息。
    • 该列表会显示尚未采购或尚未集成的代理的访问权限请求。

      • 如果尚未采购代理,则必须在下一步中进行采购。如果设置了代理的采购联系人,则会显示一条备注,指明采购请求已发送给该联系人。如果未设置代理的采购联系人,系统会提示您添加采购联系人。
      • 采购代理后,您可以点击集成并授予访问权限以完成集成。集成完成后,您就可以向用户授予访问权限。

从 Gemini Enterprise 中删除代理

如需从 Gemini Enterprise 应用中删除代理,请按以下步骤操作:

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

    Gemini Enterprise

  2. 点击向其注册了代理的应用的名称。

  3. 点击代理。

  4. 点击要删除的代理旁边的 图标。

  5. 点击删除。