开始使用 AWS 代理注册表

在本指南中，您将创建第一个注册表、添加记录、批准并进行搜索。

先决条件

完成先决条件中的步骤。

步骤 1：创建注册表

使用 IAM 授权和手动批准创建注册表。

控制台

使用基于 IAM 的身份验证创建注册表

要使用基于 JWT 的身份验证身份提供者创建注册表，请使用 JSON Web 令牌 (JWT) 来控制对注册表搜索 API 的访问。您可以使用 Amazon Cognito 快速设置授权，也可以使用自己的身份提供商来启用 OAuth 2.0。

创建注册表后，控制台将导航到注册表详细信息页面。注册表初始状态为 “正在创建”。 AWS Agent Registry 会为注册表分配 ARN，您可以在注册表详情部分找到该 ARN。置备完成后，注册表状态更改为 “就绪”。当注册表的状态为 “就绪” 时，您可以向其添加记录。

AWS CLI

aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

注册表状态开始为 “正在创建”，置备完成后会转换为 “就绪”。

AWS SDK

import boto3

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

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

步骤 2：添加注册表记录

在注册表中为 MCP 服务器创建记录。

控制台

注册记录代表代理、工具、技能或自定义资源。

选择 “创建记录” 后， AWS 代理注册表将开始配置记录。记录状态最初为 “正在创建”。置备完成后，状态将更改为 “草稿”。要将记录提供给其他人查找，请将其提交以供批准。有关更多信息，请参阅步骤 3：提交记录以供审批。

AWS CLI

aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "WeatherServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

该记录以 “创建” 状态创建，并在处理完成后转换为 “草稿”。有关创建其他类型记录的更多 AWS CLI 示例，请参阅创建和管理记录部分。

AWS SDK

import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

第 3 步：提交记录以供审批

控制台

提交记录以供批准将启动审查流程，使该记录可供查阅。您可以从注册记录表或记录详细信息页面提交记录。

从注册记录表中提交记录以供审批

从记录详细信息页面提交记录以供审批

提交记录以供批准后，记录状态会根据注册机构的批准设置而变化：

AWS CLI

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

记录将移至 PENDING_Approval（如果启用了自动批准，则直接移至 “已批准”）。

AWS SDK

import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

步骤 4：批准记录

控制台

批准注册表记录表中的记录

从记录详细信息页面批准记录

AWS CLI

aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS SDK

import boto3

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

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

步骤 5：搜索注册表

控制台

您可以使用语义或关键字搜索在注册表中搜索已批准的记录，以查找代理、MCP 服务器、技能和其他资源。您可以按名称、协议或版本筛选结果，以缩小搜索范围。

搜索注册表记录

搜索仅返回处于 “已批准” 状态的记录。处于草稿、待批准、已拒绝或已弃用状态等其他状态的记录不会出现在搜索结果中。

AWS CLI

aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

您批准的记录应出现在搜索结果中。

AWS SDK

import boto3

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

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

你建造了什么

后续步骤