本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
创建和管理记录
迁移现已开放
AWS 代理注册表已在新agent-registry命名空间下启动。对公共预览bedrock-agentcore命名空间的支持将于 2026 年 9 月 17 日停止。有关迁移说明,请参阅综合注册表迁移指南。
创建注册表记录
控制台
例
- AWS Agent Registry namespace
-
-
在注册表记录部分,选择创建记录。
-
选择来源类型:
-
从端点同步 -提供端点 URL 和可选凭据以调用端点,注册表将从源中获取元数据。仅适用于 MCP 和代理记录类型。要在源代码更改后更新记录,必须手动触发同步。有关详细信息,请参见同步来自外部来源的记录。
-
手动 -手动配置记录详细信息和协议配置。
-
从端点同步
-
在 “记录详细信息” 下,选择记录类型:MCP 或代理。
注意
只有 MCP 和代理记录类型支持同步。代理技能和自定义记录类型不支持同步,请改用手动源类型。
-
输入终端节点 URL。必须是有效的 HTTPS 网址。
-
在 “凭证类型” 下,选择注册表使用终端节点进行授权的方式:
-
IAM — 提供用于 SigV4 签名的角色 ARN 和服务名称(例如、
agent-registry、execute-api)。lambda(可选)指定签名区域。 -
OAuth -从 “身份” 中选择或输入凭证提供商 ARN。 AgentCore (可选)在 “其他配置” 下配置范围和自定义参数。
-
无 -无授权(适用于公共端点)。
-
-
选择创建记录。
该记录的创建状态为 “正在创建”。注册表连接到端点,提取元数据并填充记录的描述符。同步完成后,记录将转换为 DRAFT。如果同步失败,记录将转换为 CREATE_FAILED 状态,错误详细信息可在记录详细信息页面的 “状态原因” 字段中找到。有关故障排除,请参阅记录同步错误。要在来源更改时更新记录,请选择管理,然后在记录详细信息页面上选择同步,或者选择管理 → 编辑并Re-sync 从端点中选择。
有关通过同步创建记录的 AWS CLI 和 SDK 示例,请参阅同步来自外部来源的记录。
手动
-
在记录详细信息部分中,为名称输入记录的唯一名称。该名称在注册表中必须是唯一的——
Name和的组合Record version必须是唯一的。名称必须以字母数字字符开头。有效字符为 a—z、A—Z、0—9、_(下划线)、(连字符)、-(句点)和.(正斜杠)。/该名称最多可包含 255 个字符。 -
(可选)在 “显示名称” 中,为记录输入一个人类可读的标签。它出现在注册记录表和搜索结果中,旁边是记录的技术名称。
-
(可选)在描述中,输入记录的描述。描述可以是 1 到 4,096 个字符。
-
对于记录版本,输入记录的版本标识符(例如,
1.0.0或v2.1)。 -
在 “记录类型和描述符” 部分:
-
在 “类型” 下,选择记录的语义类型。该类型决定哪些主描述符键有效。
-
MCP — 专为 AI 工具和代理通信设计的协议。处理上下文管理和结构化消息格式。
-
代理 — 专为安全代理与代理交互而设计的协议。支持分布式工作流程和信息交换。
-
技能 — 使用 markdown 文档和可选的结构化定义注册代理技能。
-
自定义 — 针对特殊通信模式的自定义协议实现。定义您自己的接口规范和集成要求。
-
-
在 “描述符” 下,选择记录描述符数据的形状。可用选项取决于您选择的类型:
-
MCP → MCP 服务器或自定义
-
代理 → A2A 代理卡、 MCP 服务器或自定义
-
技能 → 代理技能定义或自定义
-
自定义 → 自定义
-
-
-
根据您选择的描述符,将显示特定描述符的编辑器。以 JSON 格式输入您的协议配置。对于 MCP 服务器和 A2A 代理卡描述符,切换 “显示官方架构” 以并排显示参考架构。控制台会根据官方架构验证您的 JSON,并使用 “使用 Amazon Q 进行诊断” 按钮显示行内错误(例如,“缺少属性'名称'”)。有关每描述符配置的详细信息,请参阅支持的记录类型。
-
(可选)在标签部分中,选择添加新标签以将一个或多个标签附加到记录中。每个标签都有一个密钥和一个可选值。
-
选择如下选项之一:
-
创建为草稿 -创建处于草稿状态的记录。
-
创建并提交以供批准 -创建记录并立即将其提交以供批准。
-
- Amazon Bedrock AgentCore namespace (to be deprecated)
-
-
在注册表记录部分,选择创建记录。
-
选择来源类型:
-
从端点同步 -提供端点 URL 和可选凭据以调用端点,注册表将从源中获取元数据。仅适用于 MCP 和代理记录类型。要在源代码更改后更新记录,必须手动触发同步。有关详细信息,请参见同步来自外部来源的记录。
-
手动 -手动配置记录详细信息和协议配置。
-
从端点同步
-
在 “记录详细信息” 下,选择记录类型:MCP 或代理。
注意
只有 MCP 和代理记录类型支持同步。代理技能和自定义记录类型不支持同步,请改用手动源类型。
-
输入终端节点 URL。必须是有效的 HTTPS 网址。
-
在 “凭证类型” 下,选择注册表使用终端节点进行授权的方式:
-
IAM — 提供用于 SigV4 签名的角色 ARN 和服务名称(例如、、
bedrock-agentcore、execute-api)。lambda(可选)指定签名区域。 -
OAuth -从 “身份” 中选择或输入凭证提供商 ARN。 AgentCore (可选)在 “其他配置” 下配置范围和自定义参数。
-
无 -无授权(适用于公共端点)。
-
-
选择创建记录。
该记录的创建状态为 “正在创建”。注册表连接到端点,提取元数据并填充记录的描述符。同步完成后,记录将转换为 DRAFT。如果同步失败,记录将转换为 CREATE_FAILED 状态,错误详细信息可在记录详细信息页面的 “状态原因” 字段中找到。有关故障排除,请参阅记录同步错误。要在来源更改时更新记录,请在记录详细信息页面上使用同步按钮或在编辑期间Re-sync 从端点中选择。
有关通过同步创建记录的 AWS CLI 和 SDK 示例,请参阅同步来自外部来源的记录。
手动
-
在 “记录详情” 下,输入:
-
名称 — 必须以字母或数字开头。有效字符为 a-z、 A-Z、0-9、_(下划线)、-(连字符)、。(点)和/(正斜杠)。该名称最多可包含 255 个字符。
-
描述(可选)— 1 到 4,096 个字符。
-
录制版本 — 指定此记录的版本(例如,1.0.0、v2.1)。
-
-
在 “记录类型” 下,选择以下选项之一:MCP 、代理、代理技能或自定义。
-
出现特定类型的编辑器。以 JSON 格式输入您的协议配置。
-
对于代理和 MCP 类型,切换 “显示官方架构” 以并排显示参考架构以获取指导。
-
控制台会根据官方架构验证您的 JSON,并使用 “使用 Amazon Q 进行诊断” 按钮显示行内错误(例如,“缺少属性'名称'”)。
-
-
选择如下选项之一:
-
创建为草稿 -创建处于草稿状态的记录。
-
创建并提交以供审批 -创建记录并立即将其提交以供批准。
-
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 SDK
例
- 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、、a2aAgentCardagentSkillsDefinition、custom) 键入;之前的inlineContent/schemaVersion字段重命名为data/。dataSchemaVersion
列出注册记录
控制台
例
- AWS Agent Registry namespace
-
-
注册表记录部分显示:
-
状态摘要计数器 — 总已提交、待批准、已批准、已弃用、已拒绝。
-
包含列的记录表:名称、显示名称、描述、状态、记录类型、记录 ARN、上次更新时间。
-
-
使用搜索记录栏按名称进行筛选。
- Amazon Bedrock AgentCore namespace (to be deprecated)
-
-
注册表记录部分显示:
-
状态摘要计数器 — 总已提交、待批准、已批准、已弃用、已拒绝。
-
包含以下列的记录表:名称、描述、状态、记录类型、记录 ARN、上次更新时间。
-
-
使用搜索记录栏按名称进行筛选。
-
使用更新状态下拉列表对所选记录执行批量状态更改。
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 SDK
例
- 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": […]}条目列表),而不是离散的每个字段的查询参数。支持的过滤器名称:namestatus、和recordType。
查看记录详情
控制台
例
- AWS Agent Registry namespace
-
-
在AWS 代理注册表控制台的注册表详细信息页面上
,从记录表中选择记录名称。 -
记录详细信息页面显示:
-
记录详细信息部分 — 名称、显示名称、描述、记录 ARN、状态(在记录名称旁边显示为徽章)、版本、上次更新日期、记录类型、记录 ID、创建日期。
-
同步配置部分(如果已配置)-同步类型、来源 URL 和凭证提供商详细信息(IAM 角色 ARN、服务、区域或 OAuth 提供商 ARN、授权类型、范围、自定义参数)。
-
协议配置部分 — 描述符内容显示为格式化的 JSON(例如,A2A 记录的 “代理卡”、MCP 记录的 “服务器” 和 “工具”)。
-
标签部分-将与记录关联的标签显示为键值表。要添加、移除或修改标签,请在此部分中选择 “编辑” 以打开 “编辑标记” 页面。
-
-
可用操作:
-
更新状态下拉列表-提交以供批准、批准、拒绝或弃用。
-
管理按钮-选择 “编辑” 修改记录,选择 “删除” 将其永久删除,或选择 “同步” 触发已配置端点的全新同步(仅限 MCP 和代理记录)。同步会打开一个确认对话框;记录在同步期间转换为 UPDATING 状态。
-
-
- Amazon Bedrock AgentCore namespace (to be deprecated)
-
-
在Bedrock-AgentCore 控制台的注册表详细信息页面上
,从记录表中选择记录名称。 -
记录详细信息页面显示:
-
记录详细信息部分 — 名称、描述、记录 ARN、状态(在记录名称旁边显示为徽章)、版本、上次更新日期、记录类型、记录 ID、创建日期。
-
同步配置部分(如果已配置)-同步类型、来源 URL 和凭证提供商详细信息(IAM 角色 ARN、服务、区域或 OAuth 提供商 ARN、授权类型、范围、自定义参数)。
-
协议配置部分 — 描述符内容显示为格式化的 JSON(例如,A2A 记录的 “代理卡”、MCP 记录的 “服务器” 和 “工具”)。
-
-
可用操作:
-
同步按钮(仅限 MCP 和代理记录)-从配置的端点触发新的同步。在继续操作之前打开确认对话框。同步期间,记录将转换为 UPDATING 状态。
-
更新状态下拉列表-提交以供批准、批准、拒绝或弃用。
-
Three-dot 菜单 (⋮) — 编辑或删除。
-
-
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 SDK
例
- 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
-
-
在AWS 代理注册控制台的记录详细信息页面上
,选择管理,然后选择编辑。 -
在 “编辑记录” 页面上,更新以下任意内容:
-
“记录详细信息” 下的 “名称” 、“显示名称” 、“描述” 和 “记录版本”。
-
记录类型和描述符 -根据需要更改语义类型 and/or 描述符的形状。更改类型可能需要您选择新的描述符并重新输入描述符内容。
-
-
(仅限 MCP 和代理记录)在 “从端点同步” 下,可以选择配置同步:
无论记录最初是否是通过同步创建的,您都可以通过同步来更新记录。更新期间触发同步时,记录将转换为 UPDATING 状态。如果成功,则会创建处于草稿状态的新记录版本。如果失败,则记录将转换为 UPDATE_FAILED 状态,并在状态原因字段中显示错误详情。同步的数据会使用在源中找到的值覆盖记录的名称、描述、版本、工具定义和服务器定义,但不会修改源未提供的字段。管理员或策展人必须审阅并批准新草稿才能在搜索中显示。在此之前,先前批准的修订版本(如果有)仍然可以搜索。有关双重修订行为的更多信息,请参阅记录生命周期。
-
输入端点 URL 以启用同步。提供端点时,会显示凭据类型字段。如果记录已经配置了同步,则终端节点和凭据提供者字段将使用现有配置预先填充。
-
选择凭证类型(IAM、OAuth 或 None)并填写必填字段。如果之前使用凭据提供者配置了记录,则会预先填充现有值。
-
保存时Re-sync 从端点中选择以触发新的同步。同步期间,记录将转换为 UPDATING 状态。
-
要删除同步,请选择端点字段旁边的清除按钮。这会重置端点和所有凭证字段。
-
-
在 “记录配置” 下,在 JSON 编辑器中更新记录的定义。
-
您可以配置端点以进行同步,也可以手动编辑记录的定义。触发同步后,注册表会从端点获取最新的元数据,并使用源位置的值更新记录的名称、描述、版本、工具定义和服务器定义,优先于对这些字段的任何手动编辑。来源未提供的字段不会被修改。
-
-
控制台会根据官方架构验证您的 JSON,并使用 “使用 Amazon Q 进行诊断” 按钮显示内联错误。
-
选择如下选项之一:
-
保存更改 -将记录另存为草稿。
-
保存并提交以供审批 -只需一个步骤即可保存和提交。
-
成功横幅确认:“[姓名] 已成功更新并成功提交审批。”
-
- Amazon Bedrock AgentCore namespace (to be deprecated)
-
-
在Bedrock-AgentCore 控制台的记录详情页面上
,选择三点式菜单 (),然后选择编辑。 -
在 “编辑记录” 页面上,更新以下任意内容:
-
“记录详细信息” 下的 “名称” 、“描述” 和 “记录版本”。
-
记录类型 -根据需要更改协议类型。
-
-
(仅限 MCP 和代理记录)在 “从端点同步” 下,可以选择配置同步:
无论记录最初是否是通过同步创建的,您都可以通过同步来更新记录。更新期间触发同步时,记录将转换为 UPDATING 状态。如果成功,则会创建处于草稿状态的新记录版本。如果失败,则记录将转换为 UPDATE_FAILED 状态,并在状态原因字段中显示错误详情。同步的数据会使用在源中找到的值覆盖记录的名称、描述、版本、工具定义和服务器定义,但不会修改源未提供的字段。管理员或策展人必须审阅并批准新草稿才能在搜索中显示。在此之前,先前批准的修订版本(如果有)仍然可以搜索。有关双重修订行为的更多信息,请参阅记录生命周期。
-
输入端点 URL 以启用同步。提供端点时,会显示凭据类型字段。如果记录已经配置了同步,则终端节点和凭据提供者字段将使用现有配置预先填充。
-
选择凭证类型(IAM、OAuth 或 None)并填写必填字段。如果之前使用凭据提供者配置了记录,则会预先填充现有值。
-
保存时Re-sync 从端点中选择以触发新的同步。同步期间,记录将转换为 UPDATING 状态。
-
要删除同步,请选择端点字段旁边的清除按钮。这会重置端点和所有凭证字段。
-
-
在 “记录配置” 下,在 JSON 编辑器中更新记录的定义。
-
您可以配置端点以进行同步,也可以手动编辑记录的定义。触发同步后,注册表将从端点获取最新的元数据,并使用源位置的值更新记录的名称、描述、版本、工具定义和服务器定义,优先于对这些字段的任何手动编辑。来源未提供的字段不会被修改。
-
-
控制台会根据官方架构验证您的 JSON,并使用 “使用 Amazon Q 进行诊断” 按钮显示内联错误。
-
选择如下选项之一:
-
保存更改 -将记录另存为草稿。
-
保存并提交以供审批 -只需一个步骤即可保存和提交。
-
成功横幅确认:“[姓名] 已成功更新并成功提交审批。”
-
注意
在 AWS Agent Registry 控制台的 “编辑记录” 页面上,不能对标签进行编辑。要修改标签,请转到记录详细信息页面,在标签部分选择编辑,在编辑标签页面上添加或移除标签,然后选择保存更改。(仅 AWS 代理注册控制台支持标记。)
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 SDK
例
- 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']}")
提交记录以供批准
控制台
来自记录详情页面-
-
选择 “更新状态” 下拉列表
-
然后,选择 “提交以供批准” 。
-
或者,在创建或编辑期间使用 “创建并提交以供批准” 或 “保存并提交” 以供批准。
-
注意
如果注册表的 Auto-Approval 配置设置为 TRUE,则提交记录以供批准会自动批准该记录。否则,如果将 Auto-Approval 配置设置为 FALSE,则记录将变为 “待批准” 状态,并等待策展人批准或拒绝。此外,还会触发亚马逊 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 SDK
例
- 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
-
-
在AWS 代理注册控制台的记录详细信息页面上
,选择管理,然后选择删除。 -
出现提示
delete时键入内容以确认删除。
-
- Amazon Bedrock AgentCore namespace (to be deprecated)
-
-
在Bedrock-AgentCore 控制台的记录详情页面上
,选择三点式菜单 (),然后选择删除。 -
出现提示
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 SDK
例
- 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 会根据所选记录类型的官方架构验证您的协议配置。有关验证的更多详细信息可以在支持的记录类型中找到。