查看代理关系

您可以在 Gemini Enterprise Agent Platform 中查看代理关系，包括代理之间的通信以及代理与 MCP 服务器之间的通信。

借助提供的查询，您可以将查询结果探索为拓扑图或表格。有关代理关系的信息有助于您了解依赖项并支持代理治理。

您可以查看已发现的代理和已向 Agent Registry注册的代理的数据。Gemini Enterprise Agent Platform 使用汇总的跟踪记录数据来确定关系。

限制

准备工作

  1. 启用 App Hub、App Topology、Observability 和 Trace API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您 创建了项目，则可能已通过 所有者角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。 了解如何授予角色。

    启用 API

    2. 如果您已将其他项目添加到您的 跟踪记录范围，建议您也为这些项目启用 Observability API。拓扑图仅显示与所选项目位于同一组织的跟踪记录范围 项目跟踪记录数据。

  2. 使用 OpenTelemetry 对 AI 应用进行插桩。

所需角色

如需获得查看拓扑图所需的权限，请让您的管理员向您授予项目的以下 IAM 角色：

  • 查看图表： App Topology Viewer (roles/apptopology.viewer)
  • 查看已注册的代理数据： Agent Registry API Viewer (agentregistry.viewer)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

查看项目的图表

  1. 在 Google Cloud 控制台中，前往拓扑页面。

    前往拓扑

  2. 在项目选择器中，选择包含代理的项目。

  3. 在查询 部分中，点击一个查询。

  4. 图表 部分会显示所选查询的结果。

    拓扑图是完全交互式的。您可以放大和缩小，并拖动节点来帮助您直观呈现关系。如需打开一个面板，其中提供有关图中节点的其他详细信息，请点击该节点。

  5. 如需以表格形式查看查询结果，请点击表格 。

    • 如需选择表格显示的列，请点击 列显示选项
    • 如需按特定属性过滤表格，请在过滤条件 字段中选择属性。
    • 您还可以按升序或降序对每个列进行排序。

  6. 如需优化或自定义查询，您可以在 Cloud Hub 中修改所选查询，并以拓扑图的形式查看结果。点击 在 Cloud Hub 中修改 。

如需查看有关所选项目中代理的其他数据，请查看 应用监控中的信息中心。

查看已注册代理的图表

  1. 在 Google Cloud 控制台中，前往 Agent Registry 页面。

    前往 Agent Registry

  2. 在项目选择器中，选择包含代理的项目。

  3. 在代理 标签页中，点击要查看的代理的名称。

  4. 点击拓扑 标签页。

  5. 在查询 部分中，点击一个查询。

  6. 图表 部分会显示所选查询的结果。

    拓扑图是完全交互式的。您可以放大和缩小，并拖动节点来帮助您直观呈现关系。如需打开一个面板，其中提供有关图中节点的其他详细信息，请点击该节点。

  7. 如需以表格形式查看查询结果，请点击表格 。

    • 如需选择表格显示的列，请点击 列显示选项
    • 如需按特定属性过滤表格，请在过滤条件 字段中选择属性。
    • 您还可以按升序或降序对每个列进行排序。

  8. 如需优化或自定义查询，您可以在 Cloud Hub 中修改所选查询，并以拓扑图的形式查看结果。点击 在 Cloud Hub 中修改 。

如需查看有关所选代理的其他数据，请查看 应用监控中的信息中心。

后续步骤