AWS 에이전트 레지스트리 시작하기

이 가이드에서는 첫 번째 레지스트리를 생성하고, 레코드를 추가하고, 승인하고, 검색합니다.

사전 조건

사전 조건의 단계를 완료합니다.

1단계: 레지스트리 생성

IAM 권한 부여 및 수동 승인을 사용하여 레지스트리를 생성합니다.

콘솔

IAM 기반 인증을 사용하여 레지스트리를 생성하려면

JWT 기반 인증 자격 증명 공급자 권한 부여로 레지스트리를 생성하려면 JSON 웹 토큰(JWT)을 사용하여 레지스트리의 검색 API에 대한 액세스를 제어합니다. Amazon Cognito를 사용하여 권한 부여를 빠르게 설정하거나 자체 자격 증명 공급자를 가져와 OAuth 2.0을 활성화할 수 있습니다.

레지스트리를 생성한 후 콘솔은 레지스트리 세부 정보 페이지로 이동합니다. 레지스트리 상태는 처음에 생성입니다. AWS 에이전트 레지스트리는 레지스트리 세부 정보 섹션에서 찾을 수 있는 ARN을 레지스트리에 할당합니다. 프로비저닝이 완료되면 레지스트리 상태가 준비됨으로 변경됩니다. 상태가 준비 중이면 레지스트리에 레코드를 추가할 수 있습니다.

AWS CLI

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

레지스트리 상태는 CREATING으로 시작되고 프로비저닝이 완료되면 READY로 전환됩니다.

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

레코드는 CREATING 상태로 생성되며 처리가 완료되면 DRAFT로 전환됩니다. 다른 유형의 레코드를 생성하는 추가 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(또는 자동 승인이 활성화된 경우 직접 APPROVED)로 이동합니다.

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

빌드한 내용

다음 단계