View a markdown version of this page

建立和管理記錄 - Amazon Bedrock AgentCore
建立登錄檔記錄列出登錄檔記錄檢視記錄詳細資訊更新登錄檔記錄提交記錄以供核准刪除登錄檔記錄結構描述驗證

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

建立和管理記錄

遷移現已開啟

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

建立登錄檔記錄

主控台

範例
AWS Agent Registry namespace

  1. 在AWS 客服人員登錄檔主控台中開啟登錄檔詳細資訊頁面。

  2. 在登錄檔記錄區段中，選擇建立記錄。

  3. 選擇來源類型：

    1. 從端點同步 - 提供端點 URL 和選用登入資料來叫用端點，而登錄檔會從來源擷取中繼資料。僅適用於 MCP 和客服人員記錄類型。若要在來源變更後更新記錄，您必須手動觸發同步。如需詳細資訊，請參閱從外部來源同步記錄。

    2. 手動 — 手動設定記錄詳細資訊和通訊協定組態。

從端點同步

  1. 在記錄詳細資訊下，選取記錄類型：MCP 或客服人員。

    注意

    只有 MCP 和客服人員記錄類型才支援同步。客服人員技能和自訂記錄類型不支援同步 - 請改用手動來源類型。

  2. 輸入端點 URL。必須是有效的 HTTPS URL。

  3. 在登入資料類型下，選擇登錄檔授權端點的方式：

    1. IAM — 提供 SigV4 簽署的角色 ARN agent-registry和服務名稱 （例如，、execute-api、lambda)。選擇性地指定要簽署的區域。

    2. OAuth — 從 AgentCore Identity 選取或輸入登入資料提供者 ARN。選擇性地在其他組態下設定範圍和自訂參數。

    3. 無 — 無授權 （適用於公有端點）。

  4. 選擇建立記錄。

    記錄會以 CREATING 狀態建立。登錄檔會連線至端點、擷取中繼資料，並填入記錄的描述項。同步完成後，記錄會轉換為 DRAFT。如果同步失敗，記錄會轉換為 CREATE_FAILED 狀態，並在記錄詳細資訊頁面上的狀態原因欄位中提供錯誤詳細資訊。如需故障診斷，請參閱記錄同步錯誤。若要在來源變更時更新記錄，請選擇管理，然後在記錄詳細資訊頁面上選擇同步，或選擇管理 → 編輯，然後從端點選取重新同步。

如需使用同步建立記錄的 AWS CLI 和 SDK 範例，請參閱從外部來源同步記錄。

手動

  1. 在記錄詳細資訊區段中，針對名稱輸入記錄的唯一名稱。名稱在登錄檔中必須是唯一的 - Name和 的組合Record version必須是唯一的。名稱必須以英數字元開頭。有效字元為 a–z、A–Z、0–9、_（底線）、-（連字號）、.（句點） 和 /（正斜線）。名稱最多可有 255 個字元。

  2. （選用） 對於顯示名稱，輸入記錄的人類可讀標籤。這會出現在登錄檔記錄資料表中，並將搜尋結果與記錄的技術名稱一起顯示。

  3. （選用） 針對描述，輸入記錄的描述。描述可以是 1 到 4，096 個字元。

  4. 針對記錄版本，輸入記錄的版本識別符 （例如 1.0.0或 v2.1)。

  5. 在記錄類型和描述項區段中：

    1. 在類型下，選取記錄的語意類型。類型會決定哪些主要描述項索引鍵有效。

      • MCP – 專為 AI 工具和代理程式通訊設計的通訊協定。處理內容管理和結構化訊息格式。

      • 代理程式 – 專為安全agent-to-agent程式之間的互動而設計的通訊協定。啟用分散式工作流程和資訊交換。

      • 技能 – 使用 Markdown 文件和選用的結構化定義註冊客服人員技能。

      • 自訂 – 特殊通訊模式的自訂通訊協定實作。定義您自己的界面規格和整合需求。

    2. 在描述項下，選擇記錄描述項資料的形狀。可用的選項取決於您選取的類型：

      • MCP → MCP 伺服器或自訂

      • 客服人員 → A2A 客服人員卡、MCP 伺服器或自訂

      • 技能 → 客服人員技能定義或自訂

      • 自訂 → 自訂

  6. 會根據您的描述項選擇顯示描述項特定的編輯器。以 JSON 格式輸入您的通訊協定組態。對於 MCP 伺服器和 A2A 代理程式卡描述項，切換顯示官方結構描述以side-by-side顯示參考結構描述。主控台會根據官方結構描述驗證您的 JSON，並使用 Amazon Q 診斷按鈕顯示內嵌錯誤 （例如「缺少屬性 'name')。如需每個描述項組態的詳細資訊，請參閱支援的記錄類型。

  7. （選用） 在標籤區段中，選擇新增標籤以將一或多個標籤連接至記錄。每個標籤都有一個索引鍵和一個選用值。

  8. 選擇以下一項：

    1. 建立為草稿 — 以草稿狀態建立記錄。

    2. 建立並提交以供核准 — 建立記錄並立即提交以供核准。

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. 在 Bedrock-AgentCore 主控台中開啟登錄檔詳細資訊頁面。

  2. 在登錄檔記錄區段中，選擇建立記錄。

  3. 選擇來源類型：

    1. 從端點同步 - 提供端點 URL 和選用登入資料來叫用端點，而登錄檔會從來源擷取中繼資料。僅適用於 MCP 和客服人員記錄類型。若要在來源變更後更新記錄，您必須手動觸發同步。如需詳細資訊，請參閱從外部來源同步記錄。

    2. 手動 — 手動設定記錄詳細資訊和通訊協定組態。

從端點同步

  1. 在記錄詳細資訊下，選取記錄類型：MCP 或客服人員。

    注意

    只有 MCP 和客服人員記錄類型才支援同步。客服人員技能和自訂記錄類型不支援同步 - 請改用手動來源類型。

  2. 輸入端點 URL。必須是有效的 HTTPS URL。

  3. 在登入資料類型下，選擇登錄檔授權端點的方式：

    1. IAM — 提供 SigV4 簽署的角色 ARN 和服務名稱 （例如，、bedrock-agentcoreexecute-api、lambda)。選擇性地指定要簽署的區域。

    2. OAuth — 從 AgentCore Identity 選取或輸入登入資料提供者 ARN。選擇性地在其他組態下設定範圍和自訂參數。

    3. 無 — 無授權 （適用於公有端點）。

  4. 選擇建立記錄。

    記錄會以 CREATING 狀態建立。登錄檔會連線至端點、擷取中繼資料，並填入記錄的描述項。同步完成後，記錄會轉換為 DRAFT。如果同步失敗，記錄會轉換為 CREATE_FAILED 狀態，並在記錄詳細資訊頁面上的狀態原因欄位中提供錯誤詳細資訊。如需故障診斷，請參閱記錄同步錯誤。若要在來源變更時更新記錄，請使用記錄詳細資訊頁面上的同步按鈕，或在編輯期間從端點選取重新同步。

如需使用同步建立記錄的 AWS CLI 和 SDK 範例，請參閱從外部來源同步記錄。

手動

  1. 在記錄詳細資訊下，輸入：

    1. 名稱 — 必須以字母或數字開頭。有效字元為 a-z、A-Z、0-9、_ （底線）、- （連字號）、. （點） 和 / （正斜線）。名稱最多可有 255 個字元。

    2. 描述 （選用） — 1 到 4，096 個字元。

    3. 記錄版本 — 指定此記錄的版本 （例如 1.0.0、2.1 版）。

  2. 在記錄類型下，選取下列其中一項：MCP、客服人員、客服人員技能或自訂。

  3. 類型特定的編輯器隨即出現。以 JSON 格式輸入您的通訊協定組態。

    1. 對於客服人員和 MCP 類型，切換顯示官方結構描述以side-by-side顯示參考結構描述以獲得指導。

    2. 主控台會根據官方結構描述驗證您的 JSON，並使用 Amazon Q 診斷按鈕顯示內嵌錯誤 （例如「遺失屬性 'name')。

  4. 選擇以下一項：

    1. 建立為草稿 — 以草稿狀態建立記錄。

    2. 建立並提交以供核准 — 建立記錄並立即提交以供核准。

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "my-mcp-server" \
  --display-name "MyMCPServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3
import json

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

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='MyMCPServer',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11'
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
注意

在 agent-registry 命名空間中， name是登錄檔中的唯一金鑰 (name + recordVersion組合必須是唯一的）。displayName 用於人類可讀標籤。descriptors 結構是平面的，並依主要描述項類型 (mcpServer、a2aAgentCard、agentSkillsDefinition、custom) 鍵控；先前的 inlineContent/schemaVersion 欄位會重新命名為 data/dataSchemaVersion。

列出登錄檔記錄

主控台

範例
AWS Agent Registry namespace

  1. 在AWS 客服人員登錄檔主控台中開啟登錄檔詳細資訊頁面。

  2. 登錄檔記錄區段會顯示：

    1. 狀態摘要計數器 — 提交總數、待核准、已核准、已棄用、已拒絕。

    2. 包含資料欄的記錄資料表：名稱、顯示名稱、描述、狀態、記錄類型、記錄 ARN、上次更新。

  3. 使用搜尋記錄列依名稱篩選。

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. 在 Bedrock-AgentCore 主控台中開啟登錄檔詳細資訊頁面。

  2. 登錄檔記錄區段會顯示：

    1. 狀態摘要計數器 — 提交總數、待核准、已核准、已棄用、已拒絕。

    2. 包含資料欄的記錄資料表：名稱、描述、狀態、記錄類型、記錄 ARN、上次更新。

  3. 使用搜尋記錄列依名稱篩選。

  4. 使用更新狀態下拉式清單，對選取的記錄執行大量狀態變更。

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3

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

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")
注意

在 agent-registry 命名空間中， ListRegistryRecords接受結構化filters參數 ({"name": "<dotted.path>", "values": […​]}項目清單），而不是離散的每欄位查詢參數。支援的篩選條件名稱：name、 status和 recordType。

檢視記錄詳細資訊

主控台

範例
AWS Agent Registry namespace

  1. 在AWS 客服人員登錄檔主控台的登錄檔詳細資訊頁面中，從記錄資料表中選擇記錄名稱。

  2. 記錄詳細資訊頁面會顯示：

    1. 記錄詳細資訊區段 — 名稱、顯示名稱、描述、記錄 ARN、狀態 （顯示為記錄名稱旁的徽章）、版本、上次更新日期、記錄類型、記錄 ID、建立日期。

    2. 同步組態區段 （如果已設定） — 同步類型、來源 URL 和憑證提供者詳細資訊 (IAM 角色 ARN、服務、區域或 OAuth 供應商 ARN、授予類型、範圍、自訂參數）。

    3. 通訊協定組態區段 — 以格式化 JSON 顯示的描述項內容 （例如，A2A 記錄的「代理程式卡」、MCP 記錄的「伺服器」和「工具」)。

    4. 標籤區段 — 將與記錄相關聯的標籤顯示為鍵值資料表。若要新增、移除或修改標籤，請在本節中選擇編輯以開啟編輯標籤頁面。

  3. 可用的動作：

    1. 更新狀態下拉式清單 — 提交以進行核准、核准、拒絕或棄用。

    2. 管理按鈕 — 選擇編輯以修改記錄、選擇刪除以永久移除記錄，或選擇同步以從設定的端點觸發新的同步 （僅限 MCP 和客服人員記錄）。同步會開啟確認對話方塊；記錄會在同步期間轉換為 UPDATING 狀態。

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. 在 Bedrock-AgentCore 主控台的登錄檔詳細資訊頁面中，從記錄資料表中選擇記錄名稱。

  2. 記錄詳細資訊頁面會顯示：

    1. 記錄詳細資訊區段 — 名稱、描述、記錄 ARN、狀態 （顯示為記錄名稱旁的徽章）、版本、上次更新日期、記錄類型、記錄 ID、建立日期。

    2. 同步組態區段 （如果已設定） — 同步類型、來源 URL 和憑證提供者詳細資訊 (IAM 角色 ARN、服務、區域或 OAuth 供應商 ARN、授予類型、範圍、自訂參數）。

    3. 通訊協定組態區段 — 以格式化 JSON 顯示的描述項內容 （例如，A2A 記錄的「代理程式卡」、MCP 記錄的「伺服器」和「工具」)。

  3. 可用的動作：

    1. 同步按鈕 （僅限 MCP 和客服人員記錄） — 從設定的端點觸發新的同步。在繼續之前開啟確認對話方塊。記錄會在同步期間轉換為 UPDATING 狀態。

    2. 更新狀態下拉式清單 — 提交以進行核准、核准、拒絕或棄用。

    3. 三點式選單 (⋮) — 編輯或刪除。

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3

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

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name (dedup key): {response['name']}")
print(f"Display Name: {response['displayName']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Record Type: {response['recordType']}")
print(f"Version: {response['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

更新登錄檔記錄

主控台

範例
AWS Agent Registry namespace

  1. 在AWS 客服人員登錄檔主控台的記錄詳細資訊頁面中，選擇管理，然後選擇編輯。

  2. 在編輯記錄頁面上，更新下列任何項目：

    1. 記錄詳細資訊下的名稱、顯示名稱、描述、記錄版本。

    2. 記錄類型和描述項 — 視需要變更語意類型和/或描述項形狀。變更類型可能需要您選取新的描述項，然後重新輸入描述項內容。

  3. （僅限 MCP 和客服人員記錄） 在從端點同步下，選擇性地設定同步：

    您可以透過同步更新記錄，無論它們最初是否使用同步建立。在更新期間觸發同步時，記錄會轉換為 UPDATING 狀態。如果成功，則會以 DRAFT 狀態建立新的記錄版本。如果失敗，記錄會轉換為 UPDATE_FAILED 狀態，並在狀態原因欄位中包含錯誤詳細資訊。同步資料會以來源中找到的值覆寫記錄的名稱、描述、版本、工具定義和伺服器定義，但不會修改來源未提供的欄位。管理員或策展者必須檢閱並核准新的草稿，才能在搜尋中顯示。在此之前，先前的核准修訂 （如果有的話） 仍可供搜尋。如需雙修訂版行為的詳細資訊，請參閱記錄生命週期。

    1. 輸入端點 URL 以啟用同步。提供端點時，登入資料類型欄位會出現。如果記錄已設定同步，端點和登入資料提供者欄位會預先填入現有的組態。

    2. 選擇登入資料類型 (IAM、OAuth 或無） 並填寫必要欄位。如果記錄先前已使用登入資料提供者設定，則會預先填入現有的值。

    3. 選取從端點重新同步以在儲存時觸發新的同步。記錄會在同步期間轉換為 UPDATING 狀態。

    4. 若要移除同步，請選擇端點欄位旁的清除按鈕。這會重設端點和所有登入資料欄位。

  4. 在記錄組態下，更新 JSON 編輯器中的記錄定義。

    1. 您可以同時設定 端點以進行同步處理，並手動編輯記錄的定義。觸發同步時，登錄檔會從端點擷取最新的中繼資料，並以來源中找到的值更新記錄的名稱、描述、版本、工具定義和伺服器定義，優先於對這些欄位的任何手動編輯。不會修改來源未提供的欄位。

  5. 主控台會根據官方結構描述驗證您的 JSON，並顯示使用 Amazon Q 診斷按鈕的內嵌錯誤。

  6. 選擇以下一項：

    1. 儲存變更 — 將記錄儲存為草稿。

    2. 儲存並提交以供核准 — 在一個步驟中儲存並提交。

成功橫幅確認：「【Name】 已更新並成功提交核准。」

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. 從 Bedrock-AgentCore 主控台的記錄詳細資訊頁面，選擇三點選單 (⋮)，然後選擇編輯。

  2. 在編輯記錄頁面上，更新下列任何項目：

    1. 記錄詳細資訊下的名稱、描述、記錄版本。

    2. 記錄類型 — 視需要變更通訊協定類型。

  3. （僅限 MCP 和客服人員記錄） 在從端點同步下，選擇性地設定同步：

    您可以透過同步更新記錄，無論它們最初是否使用同步建立。在更新期間觸發同步時，記錄會轉換為 UPDATING 狀態。如果成功，則會以 DRAFT 狀態建立新的記錄版本。如果失敗，記錄會轉換為 UPDATE_FAILED 狀態，並在狀態原因欄位中包含錯誤詳細資訊。同步資料會以來源中找到的值覆寫記錄的名稱、描述、版本、工具定義和伺服器定義，但不會修改來源未提供的欄位。管理員或策展者必須檢閱並核准新的草稿，才能在搜尋中顯示。在此之前，先前的核准修訂 （如果有的話） 仍可供搜尋。如需雙修訂版行為的詳細資訊，請參閱記錄生命週期。

    1. 輸入端點 URL 以啟用同步。提供端點時，登入資料類型欄位會出現。如果記錄已設定同步，端點和登入資料提供者欄位會預先填入現有的組態。

    2. 選擇登入資料類型 (IAM、OAuth 或無） 並填寫必要欄位。如果記錄先前已使用登入資料提供者設定，則會預先填入現有的值。

    3. 選取從端點重新同步以在儲存時觸發新的同步。記錄會在同步期間轉換為 UPDATING 狀態。

    4. 若要移除同步，請選擇端點欄位旁的清除按鈕。這會重設端點和所有登入資料欄位。

  4. 在記錄組態下，更新 JSON 編輯器中的記錄定義。

    1. 您可以同時設定 端點以進行同步處理，並手動編輯記錄的定義。觸發同步時，登錄檔會從端點擷取最新的中繼資料，並以來源中找到的值更新記錄的名稱、描述、版本、工具定義和伺服器定義，優先於對這些欄位的任何手動編輯。不會修改來源未提供的欄位。

  5. 主控台會根據官方結構描述驗證您的 JSON，並顯示使用 Amazon Q 診斷按鈕的內嵌錯誤。

  6. 選擇以下一項：

    1. 儲存變更 — 將記錄儲存為草稿。

    2. 儲存並提交以供核准 — 在一個步驟中儲存並提交。

成功橫幅確認：「【Name】 已更新並成功提交核准。」

注意

不會從 AWS Agent Registry 主控台的編輯記錄頁面編輯標籤。若要修改標籤，請前往記錄詳細資訊頁面，在標籤區段中選擇編輯，在編輯標籤頁面上新增或移除標籤，然後選擇儲存變更。（只有在 AWS Agent Registry 主控台中才支援標籤。)

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3

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

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

提交記錄以供核准

主控台

從記錄詳細資訊頁面 -

  1. 選擇更新狀態下拉式清單

  2. 然後，選擇提交以進行核准。

    1. 或者，使用建立並提交以供核准，或在建立或編輯期間儲存並提交以供核准。

注意

如果登錄檔的自動核准組態設為 TRUE，則提交記錄以供核准會自動核准。否則，如果自動核准組態設為 FALSE，則記錄會移至「待核准」狀態，並等待 Curator 核准或拒絕它。此外，會觸發 Amazon EventBridge 通知，指出已請求核准新記錄。

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

刪除登錄檔記錄

主控台

範例
AWS Agent Registry namespace

  1. 在AWS 客服人員登錄檔主控台的記錄詳細資訊頁面中，選擇管理，然後選擇刪除。

  2. 出現提示delete時輸入 以確認刪除。

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. 從 Bedrock-AgentCore 主控台的記錄詳細資訊頁面，選擇三點選單 (⋮)，然後選擇刪除。

  2. 出現提示delete時輸入 以確認刪除。

刪除是永久的，無法復原。

AWS CLI

範例
AWS Agent Registry namespace
aws agent-registry-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件

範例
AWS Agent Registry namespace
import boto3

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

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

結構描述驗證

當您建立或編輯記錄時，主控台和 API 會根據所選記錄類型的官方結構描述來驗證您的通訊協定組態。如需驗證的詳細資訊，請參閱支援的記錄類型。