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

建立和管理記錄

即將進行的命名空間遷移

AWS 客服人員登錄檔目前在 bedrock-agentcore 命名空間下為公開預覽。從 2026 年 8 月 6 日開始，服務會移至代理程式登錄命名空間。如果您使用 AWS 代理程式登錄檔，則必須更新端點、IAM 政策、SDK 用戶端、CLI 指令碼和登錄檔資料。如需從公有預覽遷移的詳細資訊，請參閱綜合登錄遷移指南。

建立登錄檔記錄

主控台

開啟登錄檔詳細資訊頁面。
在登錄檔記錄區段中，選擇建立記錄。
選擇來源類型：
1. 從端點同步 - 提供端點 URL 和選用登入資料來叫用端點，而登錄檔會從來源擷取中繼資料。僅適用於 MCP 和客服人員記錄類型。若要在來源變更後更新記錄，您必須手動觸發同步。如需詳細資訊，請參閱從外部來源同步記錄。
2. 手動 — 手動設定記錄詳細資訊和通訊協定組態。

從端點同步

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

注意
只有 MCP 和客服人員記錄類型才支援同步。客服人員技能和自訂記錄類型不支援同步 - 請改用手動來源類型。
輸入端點 URL。必須是有效的 HTTPS URL。
在登入資料類型下，選擇登錄檔授權端點的方式：
1. IAM — 提供 SigV4 簽署的角色 ARN 和服務名稱（例如，、bedrock-agentcoreexecute-api、lambda)。選擇性地指定要簽署的區域。
2. OAuth — 從 AgentCore Identity 選取或輸入登入資料提供者 ARN。選擇性地在其他組態下設定範圍和自訂參數。
3. 無 — 無授權（適用於公有端點）。
選擇建立記錄。

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

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

手動

在記錄詳細資訊 下，輸入：
1. 名稱 — 必須以字母或數字開頭。有效字元為 a-z、A-Z、0-9、_ （底線）、- （連字號）、. （點）和 / （正斜線）。名稱最多可有 255 個字元。
2. 描述（選用） — 1 到 4，096 個字元。
3. 記錄版本 — 指定此記錄的版本（例如 1.0.0、2.1 版）。
在記錄類型 下，選取下列其中一項：MCP 、客服人員 、客服人員技能 或自訂。
類型特定的編輯器隨即出現。以 JSON 格式輸入您的通訊協定組態。
1. 對於客服人員和 MCP 類型，切換顯示官方結構描述以side-by-side顯示參考結構描述以獲得指導。
2. 主控台會根據官方結構描述驗證您的 JSON，並使用 Amazon Q 診斷按鈕顯示內嵌錯誤（例如「遺失屬性 'name')。
選擇以下一項：
1. 建立為草稿 — 以草稿狀態建立記錄。
2. 建立並提交以供核准 — 建立記錄並立即提交以供核准。

AWS CLI


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 開發套件


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

列出登錄檔記錄

主控台

開啟登錄檔詳細資訊頁面。
登錄檔記錄區段會顯示：
1. 狀態摘要計數器 — 提交總數、待核准、已核准、已棄用、已拒絕。
2. 包含資料欄的記錄資料表：名稱、描述、狀態、記錄類型、記錄 ARN、上次更新。
使用搜尋記錄列依名稱篩選。
使用更新狀態下拉式清單，對選取的記錄執行大量狀態變更。

AWS CLI


aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS 開發套件


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']}")

檢視記錄詳細資訊

主控台

在登錄檔詳細資訊頁面中，從記錄資料表中選擇記錄名稱。
記錄詳細資訊頁面會顯示：
1. 記錄詳細資訊區段 — 名稱、描述、記錄 ARN、狀態（顯示為記錄名稱旁的徽章）、版本、上次更新日期、記錄類型、記錄 ID、建立日期。
2. 同步組態區段（如果已設定） — 同步類型、來源 URL 和憑證提供者詳細資訊 (IAM 角色 ARN、服務、區域或 OAuth 供應商 ARN、授予類型、範圍、自訂參數）。
3. 通訊協定組態區段 — 以格式化 JSON 顯示的描述項內容（例如，A2A 記錄的「代理程式卡」、MCP 記錄的「伺服器」和「工具」)。
可用的動作：
1. 同步按鈕（僅限 MCP 和客服人員記錄） — 從設定的端點觸發新的同步。在繼續之前開啟確認對話方塊。記錄會在同步期間轉換為 UPDATING 狀態。
2. 更新狀態下拉式清單 — 提交以進行核准、核准、拒絕或棄用。
3. 三點式選單 (⋮) — 編輯或刪除。

AWS CLI


aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件


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']}")

更新登錄檔記錄

主控台

在記錄詳細資訊頁面中，選擇三點選單 (⋮)，然後選擇編輯。
在編輯記錄頁面上，更新下列任何項目：
1. 名稱、描述、記錄詳細資訊下的記錄版本。
2. 記錄類型 — 視需要變更通訊協定類型。
（僅限 MCP 和客服人員記錄） 在從端點同步下，選擇性地設定同步：

您可以透過同步更新記錄，無論它們最初是否使用同步建立。在更新期間觸發同步時，記錄會轉換為 UPDATING 狀態。如果成功，則會以 DRAFT 狀態建立新的記錄版本。如果失敗，記錄會轉換為 UPDATE_FAILED 狀態，並在狀態原因欄位中包含錯誤詳細資訊。同步資料會以來源中找到的值覆寫記錄的名稱、描述、版本、工具定義和伺服器定義，但不會修改來源未提供的欄位。管理員或策展者必須檢閱並核准新的草稿，才能在搜尋中顯示。在此之前，先前的核准修訂（如果有的話）仍可供搜尋。如需雙修訂版行為的詳細資訊，請參閱記錄生命週期。
1. 輸入端點 URL 以啟用同步。提供端點時，登入資料類型欄位會出現。如果記錄已設定同步，端點和登入資料提供者欄位會預先填入現有的組態。
2. 選擇登入資料類型 (IAM、OAuth 或無）並填寫必要欄位。如果記錄先前已使用登入資料提供者設定，則會預先填入現有的值。
3. 選取從端點重新同步以在儲存時觸發新的同步。記錄會在同步期間轉換為 UPDATING 狀態。
4. 若要移除同步，請選擇端點欄位旁的清除按鈕。這會重設端點和所有登入資料欄位。
在記錄組態下，更新 JSON 編輯器中的記錄定義。
1. 您可以同時設定端點以進行同步處理，並手動編輯記錄的定義。觸發同步時，登錄檔會從端點擷取最新的中繼資料，並以來源中找到的值更新記錄的名稱、描述、版本、工具定義和伺服器定義，優先於對這些欄位的任何手動編輯。不會修改來源未提供的欄位。
主控台會根據官方結構描述驗證您的 JSON，並顯示使用 Amazon Q 診斷按鈕的內嵌錯誤。
選擇以下一項：
1. 儲存變更 — 將記錄儲存為草稿。
2. 儲存並提交以供核准 — 在一個步驟中儲存並提交。

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

AWS CLI


aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS 開發套件


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. 或者，使用建立並提交以供核准，或在建立或編輯期間儲存並提交以供核准。

注意

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

AWS CLI


aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件


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

刪除登錄檔記錄

主控台

從記錄詳細資訊頁面，選擇三點選單 (⋮)，然後選擇刪除。
出現提示時輸入 'delete' 以確認刪除

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

AWS CLI


aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS 開發套件


import boto3

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

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

結構描述驗證

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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

記錄生命週期

同步來自外部來源的記錄