如需有效管理代理舰队，您需要查看和更新代理详情，以确保注册表准确无误，随着 AI 生态系统的发展，您还可以替换元数据或移除不再使用的代理。
本文档详细介绍了如何查看和修改已注册代理的详细信息和配置。
准备工作
在管理代理之前，请确保 您的代理已在 Agent Registry 中注册。您还需要 项目 ID 才能执行这些任务。
如需使用本文档中的 Google Cloud CLI 命令，请确保您已 设置 gcloud CLI 环境。
所需角色
如需获得在 Agent Registry 中管理已注册代理所需的权限，请让您的管理员为您授予项目的 Agent Registry API Editor (roles/agentregistry.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。
探索可用代理
注册代理后，您可以在环境中探索这些代理，并查看其详细配置，例如端点、技能和关联的元数据。
列出和查看所有代理
您可以列出在环境中注册的所有代理，并查看其详细配置，例如端点、技能和关联的元数据：
控制台
在 Google Cloud 控制台中，前往 Agent Registry：
在项目选择器中，选择您在其中 设置了 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表。该列表包含代理的名称、标识符、类型、说明、版本、运行时和位置。
如需查看代理的完整详细信息，请点击代理的 名称。
gcloud
如需列出特定位置的所有代理，请使用 agents list 命令：
gcloud agent-registry agents list \
--project=PROJECT_ID \
--location=REGION
替换以下内容：
PROJECT_ID：项目 ID。REGION：注册表区域。
过滤已注册代理
如果您有多个代理，或者想要确认特定代理的注册，可以按代理的元数据过滤列表：
控制台
在 Google Cloud 控制台中，前往 Agent Registry：
在项目选择器中，选择您在其中 设置了 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表。该列表包含代理的名称、标识符、类型、说明、版本、运行时和位置。
按代理的位置或运行时资源过滤列表：
- 如需按位置过滤，请点击位置 菜单，选择要过滤的位置，然后点击应用 。
- 如需按运行时过滤，请点击运行时 菜单，选择要过滤的运行时，然后点击应用 。
该页面会显示根据您选择的条件过滤后的已注册代理列表。
gcloud
使用 --filter 标志过滤代理列表，以仅返回与特定元数据匹配的资源：
gcloud agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
将 FILTER_EXPRESSION 替换为您要过滤的代理的过滤表达式。例如，您可以使用以下过滤条件：
- 如需按显示名过滤，请使用
displayName='DISPLAY_NAME'。 - 如需按全局唯一
标识符 (URN) 搜索，请使用
agentId='urn:agent:AGENT_URN'。
Terraform
如需通过根据元数据过滤来检索特定的已注册代理，请使用 filter 实参配置 google_agent_registry_agent 数据源：
data "google_agent_registry_agent" "filtered_agent" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
替换以下内容：
REGION：注册表区域。DISPLAY_NAME：要过滤的代理的人类可读名称，例如Support Agent。
查看代理的详细信息
查看特定代理的详细信息，包括其协议、技能和身份：
控制台
在 Google Cloud 控制台中，前往 Agent Registry：
在项目选择器中，选择您在其中 设置了 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表。该列表包含代理的名称、标识符、类型、说明、版本、运行时和位置。
点击您要查看的代理的名称。
详细信息页面包含代理详细信息的标签页。
点击相应的标签页即可查看特定的代理详细信息。
功能可用性取决于您的运行时。会话、 平台、记忆和评估等标签页是针对在托管运行时（例如 Gemini Enterprise Agent Platform 上的 Agent Runtime）上构建的代理的特定功能：
- 概览：代理的核心详细信息，包括代理的 名称、标识符、 位置、说明和运行时。概览还会显示 技能和 资源 URI，您需要在 拓扑图中构建查询时使用这些信息。
- 可观测性：以应用为中心的洞见，例如延迟时间、 流量、错误和令牌支出。此标签页与 Google Cloud 可观测性工具集成，可显示实时性能指标和系统级利用率，帮助您管理费用和用户体验。 如需了解详情，请参阅可观测性概览。
- 跟踪记录：对话的确切路径（逐步），包括输入和助理消息的详细格式，以便实时调试复杂的多代理推理循环或工具调用错误。如需了解详情，请参阅查看代理跟踪记录。
- 安全性：来自 Model Armor 和 Security Command Center 的发现结果， 包括内容政策违规、数据泄露风险和 合规性评估。如需详细了解安全性，请参阅 查看安全发现结果。
- 拓扑：代理、其分配的代理网关及其与之交互的 MCP 服务器之间的关系和流量的可视化地图。如需详细了解代理网关，请参阅 代理网关概览。 如需详细了解拓扑，请参阅 查看已注册代理的图。
- 身份：用于政策执行的代理正文 。例如，您可以使用此身份 配置 身份验证提供方绑定 ，以便对工具和资源进行身份验证。
- 会话：持久对话记录和与代理的活跃 互动跟踪。
- 平台：用于测试代理行为的直接聊天界面。
- 记忆：长期个性化功能，可生成或 回忆与代理的过往对话中的详细信息，以在多次互动中保留 上下文。
- 评估：所有代理评估任务的详细信息。借助此标签页，您可以创建新的评估任务、上传指标，并根据实时流量或合成模拟评估代理的认知性能和模型可靠性。
gcloud
如需查看特定代理的详细元数据，请使用 agents describe 命令：
gcloud agent-registry agents describe AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
将 AGENT_NAME 替换为代理的名称，例如 my-custom-agent。
Terraform
如需使用特定已注册代理的 ID 检索其详细信息，请配置 google_agent_registry_agent 数据源：
data "google_agent_registry_agent" "my_agent" {
location = "REGION"
agent_id = "AGENT_ID"
}
output "agent_create_time" {
description = "The timestamp when the agent was registered."
value = data.google_agent_registry_agent.my_agent.create_time
}
output "agent_update_time" {
description = "The timestamp when the agent was last updated."
value = data.google_agent_registry_agent.my_agent.update_time
}
替换以下内容：
REGION：注册表区域。AGENT_ID：代理的唯一标识符，例如my-custom-agent。
更新代理元数据和端点
如果代理的运行时网址发生变化，或者您想要替换其显示名、说明或规范，可以更新代理元数据。
对于 Agent Registry API，Agent 资源用于探索。因此，您必须直接更新已注册的 Service 资源。
控制台
在 Google Cloud 控制台中更新可用代理的详细信息：
在 Google Cloud 控制台中，前往 Agent Registry：
在项目选择器中，选择您在其中 设置了 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表。该列表包含代理的名称、标识符、类型、说明、版本、运行时和位置。
点击您要更新的代理的名称。
在代理的概览 标签页中，点击 修改。
在修改服务 面板中，输入代理的更新信息，例如新名称或说明。
点击保存 。
gcloud
使用带有特定标志的 gcloud CLI 修改代理的参数：
更新显示名和说明：使用
--display-name和--description标志，例如：gcloud agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --display-name="New display name" \ --description="Updated description of the agent's purpose."替换以下内容：
AGENT_NAME：代理的名称，例如my-support-agent。PROJECT_ID：项目 ID。REGION：注册表区域。
更新端点网址：使用
--interfaces标志指定新 端点，例如：gcloud agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL替换以下内容：
ENDPOINT_URL：新的代理端点网址，例如https://new-api.example.com/agent。PROTOCOL：端点的协议绑定。有效值为HTTP_JSON、GRPC或JSONRPC。
更新代理的规范：使用
--agent-spec-content标志， 例如，如果您有新的 代理卡片：gcloud agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --agent-spec-content=AGENT_SPEC将
AGENT_SPEC替换为新代理规范文件的名称，例如new-agent-card.json。规范文件的文件大小上限为 10 KB。
Terraform
如需更新已注册代理的元数据、端点网址或规范，请修改配置中现有 google_agent_registry_service 资源的参数，然后运行 terraform apply：
resource "google_agent_registry_service" "rest_agent" {
location = "REGION"
service_id = "AGENT_NAME"
display_name = "New Display Name"
description = "Updated description of the agent's purpose."
agent_spec {
type = "NO_SPEC"
}
interfaces {
url = "ENDPOINT_URL"
protocol_binding = "PROTOCOL"
}
}
替换以下内容：
REGION：注册表区域。AGENT_NAME：您要为代理指定的唯一名称，例如my-support-agent。ENDPOINT_URL：代理的 API 端点网址，例如https://api.remote-service.com/v1/agents/1234。PROTOCOL：端点的协议绑定。 有效值为HTTP_JSON、GRPC或JSONRPC。
移除代理
如需删除自动注册到 Agent Registry 的代理，您 必须在其特定 Google Cloud 运行时中删除底层代理。然后，系统会自动从注册表中移除该代理。
如需从注册表中移除手动注册的代理，您必须删除底层 Service 资源。此操作会从搜索结果中移除代理，并使其无法被其他工具探索：
控制台
在 Google Cloud 控制台中，前往 Agent Registry：
在项目选择器中，选择您在其中 设置了 Agent Registry的 Google Cloud 项目。
选择代理 标签页。
该页面会显示所有已注册代理的列表。该列表包含代理的名称、标识符、类型、说明、版本、运行时和位置。
点击您要移除的代理的名称。
在代理的概览 标签页中，点击 删除 。
在确认对话框中，输入 DELETE 以确认操作。
点击删除 。
gcloud
gcloud agent-registry services delete AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
替换以下内容：
AGENT_NAME：您要移除的代理的名称，例如my-support-agent。PROJECT_ID：项目 ID。REGION：注册表区域。
Terraform
从 Terraform 配置中移除表示代理的 google_agent_registry_service 资源，然后运行 terraform apply。
后续步骤
- 了解如何查看代理关系 使用拓扑图。
- 了解如何使用自然语言查询搜索代理和工具 。