查看代理关系

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

使用提供的查询，您可以将查询结果显示为拓扑图或表格。有关代理关系的信息可帮助您了解依赖关系并支持代理管理。

您可以查看已发现的代理和已向代理注册表注册的代理的数据。Gemini Enterprise Agent Platform 使用汇总的轨迹数据来确定关系。

限制

  • 查询结果仅包含符合以下条件的组件：
    • 代理必须将功能类型设置为 AGENT，并使用 ADK、Gemini Enterprise 或 Cloud Run 进行部署；或者使用 GKE 进行部署，并向代理注册表注册。
    • MCP 服务器必须将功能类型设置为 MCP。使用 OneMCP、GKE 或 Cloud Run 部署的第一方 MCP 服务器包含在内。其他 MCP 服务器必须在代理注册表中注册才能包含在内。
    • 结果中不包含其他组件，例如工具和模型，也不包含 Workspace 智能体。
  • 当 MCP 服务器注册到代理注册表时，App Hub 会将其归类为共享资源，该资源不会在拓扑图中显示与其他节点的边。此限制仅在 MCP 服务器被归类为共享资源时适用，不适用于应用专用资源，例如 Gemini Enterprise 数据连接器或在 Cloud Run 上托管的 MCP 服务器。

准备工作

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

    启用 API 所需的角色

    如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

    启用 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

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

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

  4. 点击拓扑标签页。

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

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

    拓扑图是完全交互式的。您可以放大和缩小视图，也可以拖动节点，以便直观地了解关系。如需打开提供有关图表中节点的更多详情的面板，请点击相应节点。

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

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

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

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

后续步骤