View a markdown version of this page

레코드 생성 및 관리 - Amazon Bedrock AgentCore

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

레코드 생성 및 관리

지금 마이그레이션 열기

AWS 에이전트 레지스트리가 새 agent-registry 네임스페이스에서 시작되었습니다. 퍼블릭 미리 보기 bedrock-agentcore 네임스페이스에 대한 지원은 2026년 9월 17일에 중단됩니다. 마이그레이션 지침은 포괄적인 레지스트리 마이그레이션 가이드를 참조하세요.

레지스트리 레코드 생성

콘솔

예
AWS Agent Registry namespace
  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 소스 유형을 선택합니다.

    1. 엔드포인트에서 동기화 - 엔드포인트 URL과 선택적 자격 증명을 제공하여 엔드포인트를 호출하면 레지스트리가 소스에서 메타데이터를 가져옵니다. MCP 및 에이전트 레코드 유형에만 사용할 수 있습니다. 소스 변경 후 레코드를 업데이트하려면 동기화를 수동으로 트리거해야 합니다. 자세한 내용은 외부 소스의 레코드 동기화를 참조하세요.

    2. 수동 - 레코드 세부 정보 및 프로토콜 구성을 수동으로 구성합니다.

엔드포인트에서 동기화

  1. 레코드 세부 정보에서 레코드 유형인 MCP 또는 에이전트를 선택합니다.

    참고

    동기화는 MCP 및 에이전트 레코드 유형에 대해서만 지원됩니다. 에이전트 스킬 및 사용자 지정 레코드 유형은 동기화를 지원하지 않습니다. 대신 수동 소스 유형을 사용합니다.

  2. 엔드포인트 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  3. 자격 증명 유형에서 레지스트리가 엔드포인트로 권한을 부여하는 방법을 선택합니다.

    1. IAM - SigV4 서명을 위한 역할 ARN과 서비스 이름(예: , agent-registry, execute-apilambda)을 제공합니다. 선택적으로 서명할 리전을 지정합니다.

    2. OAuth - AgentCore 자격 증명에서 자격 증명 공급자 ARN을 선택하거나 입력합니다. 선택적으로 추가 구성에서 범위 및 사용자 지정 파라미터를 구성합니다.

    3. 없음 - 권한 부여 없음(퍼블릭 엔드포인트의 경우).

  4. 레코드 세트 생성을 선택합니다.

    레코드는 CREATING 상태로 생성됩니다. 레지스트리는 엔드포인트에 연결하고 메타데이터를 추출하며 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드가 레코드 세부 정보 페이지의 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요. 소스가 변경될 때 레코드를 업데이트하려면 관리를 선택한 다음 레코드 세부 정보 페이지에서 동기화를 선택하거나 관리 → 편집을 선택하고 엔드포인트에서 다시 동기화를 선택합니다.

동기화를 사용하여 레코드를 생성하는 AWS CLI 및 SDK 예제는 외부 소스의 레코드 동기화를 참조하세요.

수동

  1. 레코드 세부 정보 섹션의 이름에 레코드의 고유한 이름을 입력합니다. 이름은 레지스트리 내에서 고유해야 합니다. Name 및의 조합은 고유해야 Record version 합니다. 이름은 영숫자로 시작해야 합니다. 유효한 문자는 a~z, A~Z, 0~9, _ (밑줄), - (하이픈), . (마침표) 및 / (슬래시)입니다. 이름은 최대 255자까지 가능합니다.

  2. (선택 사항) 표시 이름에 레코드의 사람이 읽을 수 있는 레이블을 입력합니다. 이는 레지스트리 레코드 테이블 및 검색 결과에 레코드의 기술 이름과 함께 표시됩니다.

  3. (선택 사항) 설명에 레코드에 대한 설명을 입력합니다. 설명은 1~4,096자일 수 있습니다.

  4. 레코드 버전에 레코드의 버전 식별자(예: 1.0.0 또는 v2.1)를 입력합니다.

  5. 레코드 유형 및 설명자 섹션에서 다음을 수행합니다.

    1. 유형에서 레코드의 의미 체계 유형을 선택합니다. 유형에 따라 유효한 기본 설명자 키가 결정됩니다.

      • MCP - AI 도구 및 에이전트 통신을 위해 설계된 프로토콜입니다. 컨텍스트 관리 및 구조화된 메시지 형식을 처리합니다.

      • 에이전트 - 안전한 agent-to-agent 상호 작용을 위해 설계된 프로토콜입니다. 분산 워크플로 및 정보 교환을 활성화합니다.

      • 기술 - 마크다운 설명서와 선택적 구조화된 정의를 사용하여 에이전트 기술을 등록합니다.

      • 사용자 지정 - 특수 통신 패턴을 위한 사용자 지정 프로토콜 구현입니다. 자체 인터페이스 사양 및 통합 요구 사항을 정의합니다.

    2. 설명자에서 레코드의 설명자 데이터의 모양을 선택합니다. 사용 가능한 옵션은 선택한 유형에 따라 다릅니다.

      • MCP → MCP 서버 또는 사용자 지정

      • 에이전트 → A2A 에이전트 카드, MCP 서버 또는 사용자 지정

      • 기술 → 에이전트 기술 정의 또는 사용자 지정

      • 사용자 지정 → 사용자 지정

  6. 설명자별 편집기는 설명자 선택에 따라 나타납니다. 프로토콜 구성을 JSON 형식으로 입력합니다. MCP 서버 및 A2A 에이전트 카드 설명자의 경우 공식 스키마 표시를 전환하여 참조 스키마를 side-by-side 표시합니다. 콘솔은 공식 스키마에 대해 JSON을 검증하고 Amazon Q로 진단 버튼을 사용하여 인라인 오류(예: "Missing property 'name'")를 표시합니다. 설명자별 구성 세부 정보는 지원되는 레코드 유형을 참조하세요.

  7. (선택 사항) 태그 섹션에서 새 태그 추가를 선택하여 레코드에 하나 이상의 태그를 연결합니다. 각 태그에는 키와 선택적 값이 있습니다.

  8. 다음 중 하나를 선택합니다.

    1. 초안으로 생성 - 초안 상태에서 레코드를 생성합니다.

    2. 승인을 위해 생성 및 제출 - 레코드를 생성하고 승인을 위해 즉시 제출합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에서 레코드 생성을 선택합니다.

  3. 소스 유형을 선택합니다.

    1. 엔드포인트에서 동기화 - 엔드포인트 URL과 선택적 자격 증명을 제공하여 엔드포인트를 호출하면 레지스트리가 소스에서 메타데이터를 가져옵니다. MCP 및 에이전트 레코드 유형에만 사용할 수 있습니다. 소스 변경 후 레코드를 업데이트하려면 동기화를 수동으로 트리거해야 합니다. 자세한 내용은 외부 소스의 레코드 동기화를 참조하세요.

    2. 수동 - 레코드 세부 정보 및 프로토콜 구성을 수동으로 구성합니다.

엔드포인트에서 동기화

  1. 레코드 세부 정보에서 레코드 유형인 MCP 또는 에이전트를 선택합니다.

    참고

    동기화는 MCP 및 에이전트 레코드 유형에 대해서만 지원됩니다. 에이전트 스킬 및 사용자 지정 레코드 유형은 동기화를 지원하지 않습니다. 대신 수동 소스 유형을 사용합니다.

  2. 엔드포인트 URL을 입력합니다. 유효한 HTTPS URL이어야 합니다.

  3. 자격 증명 유형에서 레지스트리가 엔드포인트로 권한을 부여하는 방법을 선택합니다.

    1. IAM - SigV4 서명을 위한 역할 ARN과 서비스 이름(예: , bedrock-agentcoreexecute-api, lambda)을 제공합니다. 선택적으로 서명할 리전을 지정합니다.

    2. OAuth - AgentCore 자격 증명에서 자격 증명 공급자 ARN을 선택하거나 입력합니다. 선택적으로 추가 구성에서 범위 및 사용자 지정 파라미터를 구성합니다.

    3. 없음 - 권한 부여 없음(퍼블릭 엔드포인트의 경우).

  4. 레코드 세트 생성을 선택합니다.

    레코드는 CREATING 상태로 생성됩니다. 레지스트리는 엔드포인트에 연결하고 메타데이터를 추출하며 레코드의 설명자를 채웁니다. 동기화가 완료되면 레코드가 초안으로 전환됩니다. 동기화에 실패하면 레코드가 레코드 세부 정보 페이지의 상태 이유 필드에서 사용 가능한 오류 세부 정보와 함께 CREATE_FAILED 상태로 전환됩니다. 문제 해결은 동기화 오류 기록을 참조하세요. 소스가 변경될 때 레코드를 업데이트하려면 레코드 세부 정보 페이지의 동기화 버튼을 사용하거나 편집 중에 엔드포인트에서 다시 동기화를 선택합니다.

동기화를 사용하여 레코드를 생성하는 AWS CLI 및 SDK 예제는 외부 소스의 레코드 동기화를 참조하세요.

수동

  1. 레코드 세부 정보에서 다음을 입력합니다.

    1. 이름 - 문자 또는 숫자로 시작해야 합니다. 유효한 문자는 a-z, A-Z, 0-9, _(밑줄), -(하이픈), .(점) 및 /(슬래시)입니다. 이름은 최대 255자까지 가능합니다.

    2. 설명(선택 사항) - 1~4,096자.

    3. 레코드 버전 -이 레코드의 버전을 지정합니다(예: 1.0.0, v2.1).

  2. 레코드 유형에서 MCP, 에이전트, 에이전트 스킬 또는 사용자 지정 중 하나를 선택합니다.

  3. 유형별 편집기가 나타납니다. 프로토콜 구성을 JSON 형식으로 입력합니다.

    1. 에이전트 및 MCP 유형의 경우 공식 스키마 표시를 전환하여 참조 스키마를 side-by-side 표시하여 지침을 확인합니다.

    2. 콘솔은 공식 스키마에 대해 JSON을 검증하고 Amazon Q로 진단 버튼을 사용하여 인라인 오류(예: "Missing property 'name'")를 표시합니다.

  4. 다음 중 하나를 선택합니다.

    1. 초안으로 생성 - 초안 상태에서 레코드를 생성합니다.

    2. 승인을 위해 생성 및 제출 - 레코드를 생성하고 승인을 위해 즉시 제출합니다.

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, a2aAgentCard, agentSkillsDefinition, custom)으로 입력됩니다. 이전 inlineContent/schemaVersion 필드의 이름이 data/로 변경됩니다dataSchemaVersion.

레지스트리 레코드 나열

콘솔

예
AWS Agent Registry namespace
  1. AWS 에이전트 레지스트리 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에 다음이 표시됩니다.

    1. 상태 요약 카운터 - 총 제출됨, 승인 보류 중, 승인됨, 사용 중단됨, 거부됨.

    2. 열이 있는 레코드 테이블: 이름, 표시 이름, 설명, 상태, 레코드 유형, 레코드 ARN, 최종 업데이트됨.

  3. 레코드 검색 막대를 사용하여 이름을 기준으로 필터링합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore 콘솔에서 레지스트리 세부 정보 페이지를 엽니다.

  2. 레지스트리 레코드 섹션에 다음이 표시됩니다.

    1. 상태 요약 카운터 - 총 제출됨, 승인 보류 중, 승인됨, 사용 중단됨, 거부됨.

    2. 열이 있는 레코드 테이블: 이름, 설명, 상태, 레코드 유형, 레코드 ARN, 최종 업데이트됨.

  3. 레코드 검색 막대를 사용하여 이름을 기준으로 필터링합니다.

  4. 상태 업데이트 드롭다운을 사용하여 선택한 레코드에 대해 대량 상태 변경을 수행합니다.

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 네임스페이스에서는 개별 필드별 쿼리 filters 파라미터 대신 구조화된 파라미터({"name": "<dotted.path>", "values": […​]}항목 목록)를 ListRegistryRecords 허용합니다. 지원되는 필터 이름: name, status및 recordType.

레코드 세부 정보 보기

콘솔

예
AWS Agent Registry namespace
  1. AWS 에이전트 레지스트리 콘솔의 레지스트리 세부 정보 페이지에서 레코드 테이블에서 레코드 이름을 선택합니다.

  2. 레코드 세부 정보 페이지에 다음이 표시됩니다.

    1. 레코드 세부 정보 섹션 - 이름, 표시 이름, 설명, 레코드 ARN, 상태(레코드 이름 옆에 배지로 표시됨), 버전, 마지막 업데이트 날짜, 레코드 유형, 레코드 ID, 생성 날짜.

    2. 동기화 구성 섹션(구성된 경우) - 동기화 유형, 소스 URL 및 자격 증명 공급자 세부 정보(IAM 역할 ARN, 서비스, 리전 또는 OAuth 공급자 ARN, 권한 부여 유형, 범위, 사용자 지정 파라미터).

    3. 프로토콜 구성 섹션 - 형식이 지정된 JSON으로 표시되는 설명자 콘텐츠(예: A2A 레코드의 경우 "에이전트 카드", MCP 레코드의 경우 "서버" 및 "도구").

    4. 태그 섹션 - 레코드와 연결된 태그를 키-값 테이블로 표시합니다. 태그를 추가, 제거 또는 수정하려면이 섹션에서 편집을 선택하여 태그 편집 페이지를 엽니다.

  3. 사용 가능한 작업:

    1. 상태 업데이트 드롭다운 - 승인을 위해 제출, 승인, 거부 또는 사용 중단.

    2. 관리 버튼 - 편집을 선택하여 레코드를 수정하거나, 삭제를 선택하여 레코드를 영구적으로 제거하거나, 동기화를 선택하여 구성된 엔드포인트에서 새 동기화를 트리거합니다(MCP 및 에이전트 레코드만 해당). 동기화는 확인 대화 상자를 엽니다. 동기화 중에 레코드가 업데이트 중 상태로 전환됩니다.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore 콘솔의 레지스트리 세부 정보 페이지에서 레코드 테이블에서 레코드 이름을 선택합니다.

  2. 레코드 세부 정보 페이지에 다음이 표시됩니다.

    1. 레코드 세부 정보 섹션 - 이름, 설명, 레코드 ARN, 상태(레코드 이름 옆에 배지로 표시됨), 버전, 마지막 업데이트 날짜, 레코드 유형, 레코드 ID, 생성 날짜.

    2. 동기화 구성 섹션(구성된 경우) - 동기화 유형, 소스 URL 및 자격 증명 공급자 세부 정보(IAM 역할 ARN, 서비스, 리전 또는 OAuth 공급자 ARN, 권한 부여 유형, 범위, 사용자 지정 파라미터).

    3. 프로토콜 구성 섹션 - 형식이 지정된 JSON으로 표시되는 설명자 콘텐츠(예: A2A 레코드의 경우 "에이전트 카드", MCP 레코드의 경우 "서버" 및 "도구").

  3. 사용 가능한 작업:

    1. 동기화 버튼(MCP 및 에이전트 레코드만 해당) - 구성된 엔드포인트에서 새 동기화를 트리거합니다. 계속하기 전에 확인 대화 상자를 엽니다. 레코드는 동기화 중에 업데이트 중 상태로 전환됩니다.

    2. 상태 업데이트 드롭다운 - 승인을 위해 제출, 승인, 거부 또는 사용 중단.

    3. 점 3개 메뉴(") - 편집 또는 삭제.

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
  1. AWS 에이전트 레지스트리 콘솔의 레코드 세부 정보 페이지에서 관리를 선택한 다음 편집을 선택합니다.

  2. 레코드 편집 페이지에서 다음 중 하나를 업데이트합니다.

    1. 레코드 세부 정보 아래의 이름, 표시 이름, 설명, 레코드 버전.

    2. 레코드 유형 및 설명자 - 필요한 경우 의미 체계 유형 및/또는 설명자 셰이프를 변경합니다. 유형을 변경하려면 새 설명자를 선택하고 설명자 콘텐츠를 다시 입력해야 할 수 있습니다.

  3. (MCP 및 에이전트 레코드만 해당) 엔드포인트에서 동기화에서 선택적으로 동기화를 구성합니다.

    원래 동기화로 생성되었는지 여부에 관계없이 동기화를 통해 레코드를 업데이트할 수 있습니다. 업데이트 중에 동기화가 트리거되면 레코드가 업데이트 중 상태로 전환됩니다. 성공하면 새 레코드 버전이 초안 상태로 생성됩니다. 실패하면 레코드가 UPDATE_FAILED 상태로 전환되고 상태 이유 필드에 오류 세부 정보가 표시됩니다. 동기화된 데이터는 레코드의 이름, 설명, 버전, 도구 정의 및 서버 정의를 소스에 있는 값으로 덮어쓰지만 소스에서 제공하지 않는 필드는 수정하지 않습니다. 검색에 표시되려면 관리자 또는 큐레이터가 새 초안을 검토하고 승인해야 합니다. 그때까지는 이전에 승인된 개정(있는 경우)을 검색할 수 있습니다. 이중 수정 동작에 대한 자세한 내용은 레코드 수명 주기를 참조하세요.

    1. 엔드포인트 URL을 입력하여 동기화를 활성화합니다. 엔드포인트가 제공되면 자격 증명 유형 필드가 나타납니다. 레코드에 이미 동기화가 구성되어 있는 경우 엔드포인트 및 자격 증명 공급자 필드가 기존 구성으로 미리 채워집니다.

    2. 자격 증명 유형(IAM, OAuth 또는 None)을 선택하고 필수 필드를 입력합니다. 레코드가 이전에 자격 증명 공급자로 구성된 경우 기존 값이 미리 채워집니다.

    3. 엔드포인트에서 재동기화를 선택하여 저장할 때 새 동기화를 트리거합니다. 레코드는 동기화 중에 업데이트 중 상태로 전환됩니다.

    4. 동기화를 제거하려면 엔드포인트 필드 옆의 지우기 버튼을 선택합니다. 이렇게 하면 엔드포인트와 모든 자격 증명 필드가 재설정됩니다.

  4. 레코드 구성에서 JSON 편집기에서 레코드의 정의를 업데이트합니다.

    1. 동기화를 위해 엔드포인트를 구성하고 레코드의 정의를 수동으로 편집할 수 있습니다. 동기화가 트리거되면 레지스트리는 엔드포인트에서 최신 메타데이터를 가져오고 레코드의 이름, 설명, 버전, 도구 정의 및 서버 정의를 소스에 있는 값으로 업데이트하여 해당 필드에 대한 수동 편집보다 우선합니다. 소스가 제공하지 않는 필드는 수정되지 않습니다.

  5. 콘솔은 공식 스키마에 대해 JSON을 검증하고 Amazon Q로 진단 버튼을 사용하여 인라인 오류를 표시합니다.

  6. 다음 중 하나를 선택합니다.

    1. 변경 사항 저장 - 레코드를 초안으로 저장합니다.

    2. 승인을 위해 저장 및 제출 - 한 번에 저장 및 제출합니다.

성공 배너는 "[이름]이 업데이트되고 승인을 위해 성공적으로 제출되었습니다."를 확인합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore 콘솔의 레코드 세부 정보 페이지에서 점 3개 메뉴(")를 선택한 다음 편집을 선택합니다.

  2. 레코드 편집 페이지에서 다음 중 하나를 업데이트합니다.

    1. 레코드 세부 정보 아래의 이름, 설명, 레코드 버전.

    2. 레코드 유형 - 필요한 경우 프로토콜 유형을 변경합니다.

  3. (MCP 및 에이전트 레코드만 해당) 엔드포인트에서 동기화에서 선택적으로 동기화를 구성합니다.

    원래 동기화로 생성되었는지 여부에 관계없이 동기화를 통해 레코드를 업데이트할 수 있습니다. 업데이트 중에 동기화가 트리거되면 레코드가 업데이트 중 상태로 전환됩니다. 성공하면 새 레코드 버전이 초안 상태로 생성됩니다. 실패하면 레코드가 UPDATE_FAILED 상태로 전환되고 상태 이유 필드에 오류 세부 정보가 표시됩니다. 동기화된 데이터는 레코드의 이름, 설명, 버전, 도구 정의 및 서버 정의를 소스에 있는 값으로 덮어쓰지만 소스에서 제공하지 않는 필드는 수정하지 않습니다. 검색에 표시되려면 관리자 또는 큐레이터가 새 초안을 검토하고 승인해야 합니다. 그때까지는 이전에 승인된 개정(있는 경우)을 검색할 수 있습니다. 이중 수정 동작에 대한 자세한 내용은 레코드 수명 주기를 참조하세요.

    1. 엔드포인트 URL을 입력하여 동기화를 활성화합니다. 엔드포인트가 제공되면 자격 증명 유형 필드가 나타납니다. 레코드에 이미 동기화가 구성되어 있는 경우 엔드포인트 및 자격 증명 공급자 필드가 기존 구성으로 미리 채워집니다.

    2. 자격 증명 유형(IAM, OAuth 또는 None)을 선택하고 필수 필드를 입력합니다. 레코드가 이전에 자격 증명 공급자로 구성된 경우 기존 값이 미리 채워집니다.

    3. 엔드포인트에서 재동기화를 선택하여 저장할 때 새 동기화를 트리거합니다. 레코드는 동기화 중에 업데이트 중 상태로 전환됩니다.

    4. 동기화를 제거하려면 엔드포인트 필드 옆의 지우기 버튼을 선택합니다. 이렇게 하면 엔드포인트와 모든 자격 증명 필드가 재설정됩니다.

  4. 레코드 구성에서 JSON 편집기에서 레코드의 정의를 업데이트합니다.

    1. 동기화를 위해 엔드포인트를 구성하고 레코드의 정의를 수동으로 편집할 수 있습니다. 동기화가 트리거되면 레지스트리는 엔드포인트에서 최신 메타데이터를 가져오고 레코드의 이름, 설명, 버전, 도구 정의 및 서버 정의를 소스에 있는 값으로 업데이트하여 해당 필드에 대한 수동 편집보다 우선합니다. 소스가 제공하지 않는 필드는 수정되지 않습니다.

  5. 콘솔은 공식 스키마에 대해 JSON을 검증하고 Amazon Q로 진단 버튼을 사용하여 인라인 오류를 표시합니다.

  6. 다음 중 하나를 선택합니다.

    1. 변경 사항 저장 - 레코드를 초안으로 저장합니다.

    2. 승인을 위해 저장 및 제출 - 한 번에 저장 및 제출합니다.

성공 배너는 "[이름]이 업데이트되고 승인을 위해 성공적으로 제출되었습니다."를 확인합니다.

참고

태그는 AWS 에이전트 레지스트리 콘솔의 레코드 편집 페이지에서 편집되지 않습니다. 태그를 수정하려면 레코드 세부 정보 페이지로 이동하여 태그 섹션에서 편집을 선택하고 태그 편집 페이지에서 태그를 추가 또는 제거한 다음 변경 사항 저장을 선택합니다. (태그는 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']}")

승인을 위해 레코드 제출

콘솔

레코드 세부 정보 페이지에서 -

  1. 상태 업데이트 드롭다운을 선택합니다.

  2. 그런 다음 승인을 위해 제출을 선택합니다.

    1. 또는 생성 및 제출을 사용하여 승인을 받거나 생성 또는 편집 중에 저장 및 제출을 사용하여 승인을 받을 수 있습니다.

참고

레지스트리의 자동 승인 구성이 TRUE로 설정된 경우 승인을 위한 레코드를 제출하면 자동으로 승인됩니다. 그렇지 않으면 자동 승인 구성이 FALSE로 설정된 경우 레코드는 '승인 보류 중' 상태로 이동하고 큐레이터가 승인 또는 거부할 때까지 기다립니다. 또한 새 레코드가 승인을 요청했음을 나타내는 Amazon 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
  1. AWS 에이전트 레지스트리 콘솔의 레코드 세부 정보 페이지에서 관리를 선택한 다음 삭제를 선택합니다.

  2. 메시지가 delete 표시되면를 입력하여 삭제를 확인합니다.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Bedrock-AgentCore 콘솔의 레코드 세부 정보 페이지에서 점 3개 메뉴(")를 선택한 다음 삭제를 선택합니다.

  2. 메시지가 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는 선택한 레코드 유형에 대한 공식 스키마와 비교하여 프로토콜 구성을 검증합니다. 검증에 대한 자세한 내용은 지원되는 레코드 유형에서 확인할 수 있습니다.