View a markdown version of this page

创建和管理记录 - Amazon Bedrock AgentCore
创建注册表记录列出注册表记录查看记录详情更新注册表记录提交记录以供审批删除注册表记录架构验证

创建和管理记录

即将进行的命名空间迁移

AWS Agent Registry 目前在 bedrock-agentcore 命名空间下处于公开预览状态。从 2026 年 8 月 6 日起，该服务将移至代理注册表命名空间。如果您使用 AWS 代理注册表，则必须更新您的终端节点、IAM 策略、SDK 客户端、CLI 脚本和注册表数据。有关从公共预览版迁移的更多信息，请参阅注册表迁移综合指南。

创建注册表记录

控制台

  1. 打开注册表详情页面。

  2. 在 “注册记录” 部分，选择 “创建记录”。

  3. 选择来源类型：

    1. 从端点同步-提供终端节点 URL 和可选凭据以调用端点，注册表会从源获取元数据。仅适用于 MCP 和代理记录类型。要在源更改后更新记录，必须手动触发同步。有关详细信息，请参阅同步来自外部来源的记录。

    2. 手动-手动配置记录详细信息和协议配置。

从端点同步

  1. 在 “记录详细信息” 下，选择记录类型：MCP 或代理。

    注意

    只有 MCP 和代理记录类型支持同步。Agent Skills 和 “自定义” 记录类型不支持同步，请改用 “手动” 源类型。

  2. 输入终端节点 URL。必须是有效的 HTTPS 网址。

  3. 在 “凭据类型” 下，选择注册表如何对端点进行授权：

    1. IAM — 提供用于 Sigv4 签名的角色 ARN 和服务名称（例如、、bedrock-agentcore）。execute-api lambda（可选）指定签名区域。

    2. OAuth — 从 “身份” 中选择或输入凭证提供者 ARN。 AgentCore （可选）在 “其他配置” 下配置范围和自定义参数。

    3. 无 — 无授权（适用于公共端点）。

  4. 选择创建记录。

    该记录的创建状态为 “正在创建”。注册表连接到端点，提取元数据并填充记录的描述符。同步完成后，记录将转换为 “草稿”。如果同步失败，则记录将转换为 CREATE_FAILED 状态，记录详细信息页面的 “状态原因” 字段中会显示错误详细信息。有关疑难解答，请参阅记录同步错误。要在来源更改时更新记录，请使用记录详细信息页面上的 “同步” 按钮或在编辑期间Re-sync 从端点中选择。

有关通过同步创建记录的 AWS CLI 和 SDK 示例，请参阅同步来自外部来源的记录。

手动

  1. 在 “记录详情” 下，输入：

    1. 名称-必须以字母或数字开头。有效字符为 a-z、 A-Z、0-9、_（下划线）、-（连字符）、。 （点）和/（正斜杠）。该名称最多可包含 255 个字符。

    2. 描述（可选）-1 到 4,096 个字符。

    3. 记录版本-指定此记录的版本（例如 1.0.0、v2.1）。

  2. 在 “记录类型” 下，选择以下任一选项：MCP、Agent、Agent 技能或自定义。

  3. 将出现一个特定于类型的编辑器。以 JSON 格式输入您的协议配置。

    1. 对于 Agent 和 MCP 类型，切换显示官方架构以并排显示参考架构以获取指导。

    2. 控制台会根据官方架构验证您的 JSON，并使用 “使用 Amazon Q 进行诊断” 按钮显示内联错误（例如，“缺少属性'名称'”）。

  4. 选择如下选项之一：

    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 SDK

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. 注册表记录部分显示：

    1. 状态摘要计数器-已提交总数、待批准、已批准、已弃用、已拒绝。

    2. 包含以下列的@@ 记录表：名称、描述、状态、记录类型、记录 ARN、上次更新时间。

  3. 使用搜索记录栏按名称进行筛选。

  4. 使用更新状态下拉列表对所选记录执行批量状态更改。

AWS CLI

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

AWS SDK

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. 在注册表详细信息页面中，从记录表中选择记录名称。

  2. 记录详情页面显示：

    1. 记录详细信息部分-名称、描述、记录 ARN、状态（显示为记录名称旁边的徽章）、版本、上次更新日期、记录类型、记录 ID、创建日期。

    2. 同步配置部分（如果已配置）-同步类型、源 URL 和凭证提供者详细信息（IAM 角色 ARN、服务、区域或 OAuth 提供商 ARN、授权类型、范围、自定义参数）。

    3. 协议配置部分 — 描述符内容显示为格式化的 JSON（例如，A2A 记录的 “代理卡”、MCP 记录的 “服务器” 和 “工具”）。

  3. 可用操作：

    1. 同步按钮（仅限 MCP 和代理记录）-触发来自已配置端点的全新同步。在继续操作之前打开确认对话框。同步期间，记录将变为 “正在更新” 状态。

    2. 更新状态下拉列表-提交审批、批准、拒绝或弃用。

    3. Three-dot 菜单 (‹)-编辑或删除。

AWS CLI

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

AWS SDK

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. 在编辑记录页面上，更新以下任意内容：

    1. “记录详情” 下的 “名称”、“描述”、“记录版本”。

    2. 记录类型-根据需要更改协议类型。

  3. （仅限 MCP 和代理记录）在 “从端点同步” 下，可以选择配置同步：

    无论记录最初是否是通过同步创建的，您都可以通过同步更新这些记录。更新期间触发同步时，记录将变为 UPDATING 状态。如果成功，则会创建一个处于 “草稿” 状态的新记录版本。如果失败，则记录将转换为 UPDATE_FAILED 状态，“状态原因” 字段中会显示错误详细信息。同步的数据会使用在源中找到的值覆盖记录的名称、描述、版本、工具定义和服务器定义，但不会修改源未提供的字段。管理员或策展人必须审阅并批准新草稿才能在搜索中显示。在此之前，先前已批准的修订版（如果有）仍可搜索。有关双版本行为的更多信息，请参阅记录生命周期。

    1. 输入终端节点 URL 以启用同步。提供终端节点时会显示凭证类型字段。如果记录已经配置了同步，则会使用现有配置预填充端点和凭据提供程序字段。

    2. 选择凭证类型（IAM、OAuth 或无），然后填写必填字段。如果之前使用凭据提供程序配置记录，则会预先填充现有值。

    3. Re-sync 从端点中选择以在保存时触发全新同步。同步期间，记录将变为 “正在更新” 状态。

    4. 要移除同步，请选择端点字段旁边的清除按钮。这将重置端点和所有凭据字段。

  4. 在 “记录配置” 下，在 JSON 编辑器中更新记录的定义。

    1. 您可以为同步配置端点，也可以手动编辑记录的定义。触发同步后，注册表会从端点获取最新的元数据，并使用在源端找到的值更新记录的名称、描述、版本、工具定义和服务器定义，优先于对这些字段进行的任何手动编辑。源未提供的字段不会被修改。

  5. 控制台会根据官方架构验证您的 JSON，并使用 “使用 Amazon Q 诊断” 按钮显示内联错误。

  6. 选择如下选项之一：

    1. 保存更改-将记录另存为草稿。

    2. 保存并提交以供审批-只需一个步骤即可保存和提交。

成功横幅确认：“[姓名] 已成功更新并已成功提交审批。”

AWS CLI

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

AWS SDK

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. 或者，在创建或编辑期间使用 “创建并提交以供审批” 或 “保存并提交以供审批”。

注意

如果注册表的 Auto-Approval 配置设置为 TRUE，则提交记录以供批准会自动批准该记录。否则，如果将 Auto-Approval 配置设置为 FALSE，则记录将变为 “待批准” 状态，并等待策展人批准或拒绝。此外，还会触发 Amazon EventBridge 通知，表示已请求批准新记录。

AWS CLI

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

AWS SDK

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

删除注册表记录

控制台

  1. 在记录详情页面中，选择三点菜单 (‹)，然后选择删除。

  2. 出现提示时，键入 “删除” 以确认删除

删除是永久性的，无法撤消。

AWS CLI

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

AWS SDK

import boto3

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

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

架构验证

创建或编辑记录时，控制台和 API 会根据所选记录类型的官方架构验证您的协议配置。有关验证的更多详细信息可以在支持的记录类型中找到。