有效管理代理程式機群需要維持登錄檔的準確性，方法是隨著 AI 生態系統演進，查看及更新代理程式詳細資料、覆寫中繼資料，或移除不再使用的代理程式。
本文將詳細說明如何查看及修改已註冊代理程式的詳細資料和設定。
事前準備
管理代理前，請先確認代理已在代理登錄服務中註冊。您也需要專案 ID 才能執行這些工作。
如要使用本文中的 Google Cloud CLI 指令，請務必設定 gcloud CLI 環境。
必要的角色
如要取得管理 Agent Registry 中已註冊代理程式所需的權限，請要求管理員授予您專案的「Agent Registry API 編輯者」 (roles/agentregistry.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
探索可用的代理程式
註冊代理程式後，您可以在環境中探索這些代理程式，並查看詳細設定，例如端點、技能和相關聯的中繼資料。
列出及查看代理程式
您可以列出環境中註冊的所有代理程式，並查看詳細設定，例如端點、技能和相關聯的中繼資料：
控制台
前往 Google Cloud 控制台的「Agent Registry」：
在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。
選取「代理人」分頁。
這個頁面會顯示所有已註冊的代理程式。清單會列出代理程式的名稱、ID、類型、說明、版本、執行階段和位置。
如要查看代理程式的完整詳細資料，請按一下代理程式的名稱。
gcloud
如要列出特定位置的所有代理程式，請使用 agents list 指令：
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION
更改下列內容：
PROJECT_ID：專案 ID。REGION：登錄檔區域。
篩選已註冊的代理人
如果您有多個代理程式，或想確認特定代理程式的註冊狀態，可以依代理程式的中繼資料篩選清單：
控制台
前往 Google Cloud 控制台的「Agent Registry」：
在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。
選取「代理人」分頁。
這個頁面會顯示所有已註冊的代理程式。清單會列出代理程式的名稱、ID、類型、說明、版本、執行階段和位置。
依據代理程式位置或執行階段資源篩選清單：
- 如要依地點篩選，請按一下「地點」選單，選取要篩選的地點，然後按一下「套用」。
- 如要依執行階段篩選，請點選「執行階段」選單，選取要篩選的執行階段，然後點選「套用」。
頁面會顯示已根據所選條件篩選的註冊代理人清單。
gcloud
使用 --filter 標記篩選代理程式清單，只傳回符合特定中繼資料的資源：
gcloud alpha agent-registry agents list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
將 FILTER_EXPRESSION 替換為要篩選的代理程式篩選運算式。舉例來說，您可以使用下列篩選條件：
- 如要依顯示名稱篩選，請使用
displayName='DISPLAY_NAME'。 - 如要依全域專屬ID (URN) 搜尋，請使用
agentId='urn:agent:AGENT_URN'。
查看代理的詳細資料
查看特定代理程式的詳細資料，包括通訊協定、技能和身分：
控制台
前往 Google Cloud 控制台的「Agent Registry」：
在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。
選取「代理人」分頁。
這個頁面會顯示所有已註冊的代理程式。清單會列出代理程式的名稱、ID、類型、說明、版本、執行階段和位置。
按一下要查看的代理程式名稱。
詳細資料頁面包含代理程式詳細資料的分頁。
按一下對應的分頁標籤，即可查看特定代理商的詳細資料。
可用的功能取決於執行階段。「工作階段」、「Playground」、「記憶體」和「評估」等分頁是專屬功能，會顯示在以受管理執行階段建構的代理程式中，例如 Gemini Enterprise Agent Platform 的 Agent Runtime：
- 總覽：代理程式的核心詳細資料，包括代理程式的名稱、ID、位置、說明和執行階段。總覽也會顯示技能和資源 URI，您需要在拓撲圖中建構查詢。
- 可觀測性：以應用程式為主的洞察資料，例如延遲時間、流量、錯誤和權杖用量。這個分頁與 Google Cloud Observability 工具整合，可顯示即時效能指標和系統層級用量，協助您管理費用和使用者體驗。詳情請參閱「可觀測性總覽」。
- 追蹤記錄：對話的確切路徑，包括輸入內容和助理訊息的詳細格式，可即時偵錯複雜的多代理程式推理迴圈或工具叫用錯誤。詳情請參閱「查看代理程式追蹤記錄」。
- 安全性：Model Armor 和 Security Command Center 的發現項目，包括違反內容政策、資料外洩風險和法規遵循評估。如要進一步瞭解安全性，請參閱「查看安全性調查結果」。
- 拓撲：以視覺化地圖呈現代理程式、其指派的 Agent Gateway，以及與其互動的 MCP 伺服器之間的關係和流量。如要進一步瞭解 Agent Gateway，請參閱「Agent Gateway 總覽」。如要進一步瞭解拓撲，請參閱「查看已註冊代理程式的圖表」。
- 身分：用於執行政策的代理程式主體。舉例來說，您可以使用這個身分，為工具和資源的驗證設定授權提供者繫結。
- 工作階段：持續追蹤對話記錄，以及與代理程式的互動。
- 測試區：直接對話介面，可測試代理的行為。
- 記憶：長期個人化功能，可生成或回想與代理程式的對話細節，在互動過程中保留脈絡。
- 評估：所有代理程式評估工作的詳細資料。您可以在這個分頁中建立新的評估工作、上傳指標，並根據實際流量或合成模擬結果，評估代理程式的認知能力和模型可靠性。
gcloud
如要查看特定代理程式的詳細中繼資料，請使用 agents describe 指令：
gcloud alpha agent-registry agents describe AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
將 AGENT_NAME 替換為代理程式的名稱，例如 my-custom-agent。
更新代理程式中繼資料和端點
如果服務專員的執行階段網址有變更，或是您想覆寫服務專員的顯示名稱、說明或規格，可以更新服務專員的中繼資料。
對於 Agent Registry API，Agent 資源用於探索。因此，您必須直接更新已註冊的 Service 資源。
使用 gcloud CLI 和特定旗標修改代理程式的參數：
更新顯示名稱和說明：使用
--display-name和--description旗標，例如：gcloud alpha 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 alpha 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 alpha agent-registry services update AGENT_NAME \ --project=PROJECT_ID \ --location=REGION \ --agent-spec-content=AGENT_SPEC將
AGENT_SPEC替換為新代理程式規格的名稱，例如new-agent-card.json。
移除代理人
如要刪除自動註冊至 Agent Registry 的代理程式，請務必在特定 Google Cloud 執行階段中刪除基礎代理程式。代理程式隨後會自動從登錄檔中移除。
如要從登錄檔移除手動註冊的代理程式，必須刪除基礎 Service 資源。這項操作會從搜尋結果中移除代理程式，
並讓其他工具無法探索：
gcloud alpha agent-registry services delete AGENT_NAME \
--project=PROJECT_ID \
--location=REGION
更改下列內容：
AGENT_NAME：要移除的代理程式名稱，例如my-support-agent。PROJECT_ID：專案 ID。REGION：登錄檔區域。