View a markdown version of this page

瀏覽核准的記錄 - Amazon Bedrock AgentCore
列出核准的記錄批次擷取核准的記錄

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

瀏覽核准的記錄

遷移現已開啟

AWS 代理程式登錄檔已在新的agent-registry命名空間下啟動。公有預覽bedrock-agentcore命名空間的支援將於 2026 年 9 月 17 日停止。如需遷移說明，請參閱綜合登錄遷移指南。

身為消費者，您可以使用兩個資料平面 APIs 來瀏覽登錄檔中已核准記錄的目錄：ListDiscoverableRegistryRecords用於分頁清單，以及用於依記錄 ID BatchGetDiscoverableRegistryRecord大量擷取完整記錄內容。這兩個 APIs只能在 agent-registry 命名空間下使用，並僅傳回其最新修訂狀態為已核准的記錄。不會傳回草稿、待核准、已拒絕或已棄用狀態的記錄。若要使用自然語言查詢搜尋記錄，請SearchDiscoverableRegistryRecords改用 。請參閱搜尋登錄檔記錄。

注意

ListDiscoverableRegistryRecords 和 BatchGetDiscoverableRegistryRecord 僅適用於 agent-registry 命名空間。在bedrock-agentcore命名空間下建立的註冊不會公開這些 APIs；請使用 SearchDiscoverableRegistryRecords。

列出核准的記錄

使用 ListDiscoverableRegistryRecords傳回登錄檔中每個已核准記錄的分頁摘要。摘要不包含記錄的描述項 — BatchGetDiscoverableRegistryRecord用於在識別您需要的記錄之後擷取完整的描述項內容。

請求參數

  • registryId （必要，路徑）：要從中列出之登錄檔的 ARN 或 ID。

  • maxResults （選用）：每頁結果數量上限。有效範圍為 1–100。

  • nextToken （選用）：來自先前回應的分頁字符。省略第一頁的 。

  • 篩選條件 （選用）：格式為 的篩選條件項目清單{"name": "<field>", "values": ["<value>"]}。支援的篩選條件名稱：

    • recordType — 記錄的語意類型。有效值：AGENT、MCP、SKILL、CUSTOM。

    • descriptorType — 記錄使用的主要描述項索引鍵。有效值：a2aAgentCard、mcpServer、agentSkillsDefinition、custom。

      重複的篩選條件名稱會遭到拒絕。如果您為單一篩選條件指定多個值，則 OR 會聯結這些值。如果您指定多個篩選條件，則篩選條件會由 AND 聯結。

回應中的每個摘要都包含：registryArn、recordArn、recordId、name、displayName、descriptionrecordType、recordVersion、、status、createdAt、。 updatedAt

回應排序和分頁

結果會依記錄名稱字母順序排序。

ListDiscoverableRegistryRecords 不保證密集頁面。即使存在更多相符maxResults記錄，任何個別回應都可以包含少於 筆記錄或零筆記錄。繼續呼叫 API，並在每個後續請求nextToken中傳回 ，直到回應不包含 nextToken（或 nextToken為 null) 擷取每個相符記錄。

主控台

範例
AWS Agent Registry namespace

  1. 開啟 AWS 代理程式登錄檔主控台。

  2. 在導覽窗格中，選擇錄製目錄。

  3. 選擇您要瀏覽的登錄檔。頁面會自動呼叫 ，ListDiscoverableRegistryRecords並在分頁資料表中顯示已核准的記錄。

  4. （選用） 使用搜尋列旁的屬性功能表，依記錄類型進行篩選。

  5. 選擇記錄的名稱以檢視其完整的描述項內容。

Amazon Bedrock AgentCore namespace (to be deprecated)

使用 瀏覽核准的記錄目錄ListDiscoverableRegistryRecords僅適用於 agent-registry 命名空間。較舊的 Bedrock-AgentCore 主控台沒有記錄目錄頁面或瀏覽功能。若要在bedrock-agentcore命名空間下建立的登錄檔中尋找記錄，請使用登錄檔詳細資訊頁面上的搜尋記錄索引標籤 — 請參閱搜尋登錄檔記錄。

注意

記錄目錄頁面需要所選登錄檔上的 IAM 型傳入授權。對於 JWT 授權的登錄檔，請ListDiscoverableRegistryRecords直接呼叫 HTTP 用戶端和有效的 JWT 承載字符。

AWS CLI

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --filters '[{"name": "recordType", "values": ["MCP"]}]' \
  --max-results 50 \
  --region us-east-1

若要分頁結果，請傳遞上一個回應nextToken的值：

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --next-token "<tokenFromPreviousResponse>" \
  --region us-east-1

AWS 開發套件

import boto3

client = boto3.client('agent-registry')

paginator = client.get_paginator('list_discoverable_registry_records')

for page in paginator.paginate(
    registryId='<registryARN>',
    filters=[{'name': 'recordType', 'values': ['MCP']}]
):
    for record in page['registryRecords']:
        print(f"{record['displayName']} ({record['name']}) - {record['recordType']} v{record['recordVersion']}")

HTTP 用戶端

curl -X POST "https://agent-registry.<region>.api.aws/registries/<registryARN>/discoverable-records-list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "filters": [{"name": "recordType", "values": ["MCP"]}],
    "maxResults": 50
  }'

批次擷取核准的記錄

使用 BatchGetDiscoverableRegistryRecord 在單一呼叫中擷取最多 100 IDs 的完整描述項內容。常見使用案例：瀏覽ListDiscoverableRegistryRecords並識別您想要的記錄後，在一次呼叫中擷取其描述項，而不是對每筆記錄進行一次SearchDiscoverableRegistryRecords呼叫。

請求參數

  • 項目 （必要）：登錄範圍的記錄群組清單。在啟動時，只接受一個項目 （每個請求使用單一登錄檔）；這與未來跨登錄檔批次處理相容。

    每個項目都包含：

    • registryId （必要）：登錄檔的 ARN 或 ID。

    • recordIds （必要）：從登錄檔擷取的 1-100 個記錄 ARNs 或 IDs 清單。

回應

  • registryRecords：成功擷取之記錄的完整記錄物件 （含描述項）。

  • 錯誤：每個記錄的錯誤清單。成功傳回每個請求的記錄時為空白。

即使發生部分故障，呼叫仍會傳回 HTTP 200 — 無法擷取的記錄會出現在errors清單中，而不是導致整個呼叫失敗。每個錯誤項目都會回應請求recordId中的 registryId和 ，加上 errorCode：

  • RESOURCE_NOT_FOUND — 記錄不存在、已刪除，或其最新修訂版未核准。未核准的記錄會收合到此程式碼中，因此不會向缺乏可見性的來電者公開其存在。

  • ACCESS_DENIED — 發起人無權讀取此特定記錄。

  • INTERNAL_ERROR — 暫時性擷取失敗。使用指數退避安全地重試失敗的子集。

批次層級失敗 （登錄檔不存在、發起人無法存取登錄檔、無法復原的服務錯誤） 透過標準操作錯誤傳回，而不是每個記錄errors的清單。

AWS CLI

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registryARN>", "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]}]' \
  --region us-east-1

AWS 開發套件

import boto3

client = boto3.client('agent-registry')

response = client.batch_get_discoverable_registry_record(
    entries=[
        {
            'registryId': '<registryARN>',
            'recordIds': ['<recordId1>', '<recordId2>', '<recordId3>']
        }
    ]
)

for record in response['registryRecords']:
    print(f"Retrieved: {record['displayName']} ({record['recordId']})")

for error in response['errors']:
    print(f"Failed: {error['recordId']} ({error['errorCode']}): {error.get('message', '')}")

HTTP 用戶端

curl -X POST "https://agent-registry.<region>.api.aws/discoverable-records-batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "entries": [
      {
        "registryId": "<registryARN>",
        "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]
      }
    ]
  }'