기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
개념 및 용어
지금 마이그레이션 열기
AWS 에이전트 레지스트리가 새 agent-registry 네임스페이스에서 시작되었습니다. 퍼블릭 미리 보기 bedrock-agentcore 네임스페이스에 대한 지원은 2026년 9월 17일에 중단됩니다. 마이그레이션 지침은 포괄적인 레지스트리 마이그레이션 가이드를 참조하세요.
레지스트리
레지스트리는 리소스를 구성하고 관리하기 위해 AWS 계정에서 생성하는 중앙 집중식 카탈로그입니다. 각 레지스트리에는 이름, 설명, 소비자가 검색 가능한 데이터 영역 APIs 및 MCP 엔드포인트에 액세스하는 방법을 제어하는 권한 부여 구성, 레코드를 검색하기 전에 수동 검토가 필요한지 여부를 결정하는 승인 구성이 있습니다.
레지스트리를 구성하는 방법은 다양한 리소스 유형에 대한 전용 레지스트리(에이전트 레지스트리, MCP 서버 레지스트리, 스킬 레지스트리), 다양한 개발 단계에 대한 레지스트리(프로덕션, QA, 개발), 다양한 팀 또는 사업부에 대한 독립 레지스트리, 전체 조직에 대한 단일 레지스트리 등 필요에 따라 달라집니다.
레지스트리 레코드
레지스트리 레코드는 레지스트리에 게시된 개별 리소스의 메타데이터를 나타냅니다. 각 레코드는 기본 리소스를 설명하는 주요 메타데이터를 캡처하여 해당 리소스가 무엇인지, 무엇을 하는지, 어떻게 찾을 수 있는지에 대한 정보를 제공합니다. 레코드에는 name, 사람이 읽을 수 있는 선택적 displayName, 선택적 설명, recordVersion, recordType (AGENT, MCPSKILL, 또는 CUSTOM) 및 실제 콘텐츠를 포함하는 resource-type-specific 설명자가 있습니다. name 및의 조합은 레지스트리 내에서 고유recordVersion해야 하므로(더 이상 사용되지 않는 키로 사용됨) 동일한 리소스의 여러 버전에서 동일한를 재사용할 name 수 있습니다.
조건 키
MCP 서버 - 모델 컨텍스트 프로토콜(MCP) 서버는 AI 에이전트가 검색하고 호출할 수 있는 도구를 제공합니다. MCP 서버 레코드에는 입력 파라미터 및 출력 형식을 포함하여 서버가 제공하는 모든 도구에 대한 서버의 구성 및 도구 정의를 설명하는 서버 정의가 포함되어 있습니다. AWS 에이전트 레지스트리는 MCP 서버 레코드를 MCP 프로토콜 스키마
에이전트 - 에이전트는 작업을 수행하기 위해 추론, 계획 및 조치를 취할 수 있는 자율 프로그램입니다. 에이전트 레코드에는 A2A(Agent-to-Agent)
기술 - 기술은 에이전트 간에 공유할 수 있는 재사용 가능한 기능입니다. 스킬 레코드에는 이름, 설명, 패키지 또는 리포지토리 세부 정보와 같은 선택적 액세스 정보, 스킬의 기능과 사용 방법을 설명하는 선택적 마크다운 설명서와 같은 기본 설명자 메타데이터가 포함되어 있습니다.
사용자 지정 리소스 - 위의 표준 유형에 맞지 않는 리소스의 경우 유효한 JSON 구조를 사용하여 자체 메타데이터 스키마를 정의할 수 있습니다.
보안 인증 제공업체
외부 소스의 메타데이터를 동기화하도록 레지스트리 레코드를 구성하는 경우(아웃바운드 권한 부여) AWS 에이전트 레지스트리는 해당 소스에 액세스하기 위해 자격 증명이 필요합니다. 자격 증명 공급자는 AWS Agent Registry가 동기화 중에 외부 리소스의 엔드포인트를 호출하는 데 사용하는 OAuth 자격 증명 또는 IAM 역할 등 권한 부여 세부 정보를 저장합니다. 레코드에서 동기화를 구성할 때 자격 증명 공급자를 ARN으로 참조합니다. 자세한 내용은 자격 증명 공급자 관리를 참조하세요.
레지스트리 권한 부여에는 두 가지 유형이 있습니다.
-
인바운드 권한 부여:이 구성을 사용하여 소비자가 레지스트리에서 검색 가능한 데이터 영역 APIs기 및 호출하는 방법을 제어합니다. AWS AWS 레지스트리는 IAM 기반 및 JWT 기반 인바운드 권한 부여를 지원합니다. 레지스트리를 생성하기 위한 워크플로의 일부로 인바운드 권한 부여를 지정합니다.
-
아웃바운드 권한 부여: 원격 MCP 또는 A2A 엔드포인트와의 동기화를 위해 레코드를 구성할 때 레지스트리는 지정된 엔드포인트에서 원격 리소스를 호출하고 메타데이터를 검색하기 위해 아웃바운드 자격 증명이 필요합니다. 특정 레지스트리 레코드에 대한 동기화 작업을 설정하는 과정에서 이러한 자격 증명을 제공합니다.
Tags
비용 할당, 액세스 제어 및 조직 추적을 위해 레지스트리 및 레지스트리 레코드에 태그를 연결할 수 있습니다. 각 태그는 키-값 페어이며 키와 값 모두 사용자가 정의하는 문자열입니다. 태그는 레지스트리 또는 레코드의 런타임 동작에 영향을 주지 않습니다. 태그는 사용자와 조직이 AWS 계정 전체에서 리소스를 분류하는 데 사용할 수 있는 메타데이터로 존재합니다.
주요 페르소나
레지스트리를 사용하는 페르소나는 조직마다 다를 수 있습니다. 그러나 조직 전체에서 일반적으로 발견되는 레지스트리와 상호 작용하는 다음과 같은 일반 페르소나를 확인했습니다.
- 관리자
-
관리자는 레지스트리 인프라를 소유합니다. AWS 계정 내에서 레지스트리를 생성 및 구성하고, 각 레지스트리가 구성되는 방법(팀, 환경 또는 리소스 유형별)을 결정하고, 소비자가 레지스트리에 액세스하는 방법을 결정하는 권한 부여 방법(IAM 또는 JWT)을 선택합니다. 레코드에 수동 검토가 필요한지 자동 승인되는지 여부를 결정하는 승인 워크플로를 설정하고 레지스트리를 조직의 기존 알림 및 검토 시스템에 연결하도록 Amazon EventBridge 통합을 구성합니다. IAM 권한을 관리하여 각 레지스트리에 액세스할 수 있는 게시자, 큐레이터 및 소비자를 제어합니다. 관리자는 레코드를 생성, 업데이트 및 삭제할 수 있는 모든 액세스 권한을 가지며 필요한 경우 레코드를 승인, 거부 또는 사용 중지할 수 있습니다.
- 게시자
-
게시자는 조직 내에서 MCP 서버, 에이전트, 스킬 또는 기타 도구 등 리소스를 생성하고 다른 사람이 검색할 수 있도록 하려는 빌더입니다. 리소스를 설명하는 레지스트리 레코드를 생성하여 다른 사용자가 리소스의 기능을 찾고 이해하는 데 도움이 되는 메타데이터, 정의 및 버전 정보를 제공합니다. 초안 상태의 레코드를 반복하여 레코드가 준비될 때까지 설명과 스키마를 구체화한 다음 승인을 위해 제출합니다. 레코드가 거부되면 큐레이터의 피드백을 검토하고 필요한 사항을 변경한 다음 다시 제출합니다. 레코드가 수동 업데이트 없이 라이브 MCP 서버와 동기화되도록 URL 기반 동기화를 구성할 수도 있습니다.
- 큐레이터/승인자
-
큐레이터는 레지스트리의 품질 게이트키퍼이며 레지스트리의 관리자일 수도 있습니다. 게시자가 승인을 위해 제출한 레코드를 검토하여 보안, 규정 준수, 메타데이터 완전성 및 조직에서 정의하는 기타 기준에 대한 조직의 표준을 기준으로 각 레코드를 평가합니다. 검색 가능한 데이터 영역 APIs(검색, 목록, 배치-대상) 및 MCP 엔드포인트를 통해 볼 수 있도록 이러한 표준을 충족하는 레코드를 승인하고, 그렇지 않은 레코드를 거부하여 수정해야 할 사항에 대한 명확한 피드백을 제공합니다. 리소스가 폐기되거나 알려진 문제가 있거나 최신 버전으로 대체되면 레코드를 사용 중지하여 검색에서 제거합니다. 큐레이터는 레지스트리를 조직 전체의 빌더가 신뢰할 수 있는 고품질 카탈로그로 유지하는 데 도움이 됩니다.
- 소비자
-
소비자는 리소스를 찾고 사용해야 하는 사람 또는 에이전트입니다. 승인된 레코드는 다음 세 가지 방법으로 검색할 수 있습니다.
-
자연어 쿼리 또는 키워드 조회로 검색하여 주제, 기능 또는 사용 사례()와 일치하는 레코드를 찾습니다
SearchDiscoverableRegistryRecords. -
페이지가 지정된 목록을 사용하여 승인된 레코드의 카탈로그를 검색하고, 선택적으로 레코드 유형별로 필터링하고, 한 번에 하나 이상의 레코드에 대한 세부 정보를 검색합니다(
ListDiscoverableRegistryRecords및GetDiscoverableRegistryRecord/BatchGetDiscoverableRegistryRecord). -
MCP 호환 클라이언트에서 레지스트리의 MCP 엔드포인트에 연결하여 프로그래밍 방식으로 사용 가능한 도구를 검색합니다(
InvokeRegistryMcp).소비자는 승인된 레코드만 볼 수 있으므로 레지스트리에서 찾은 모든 것이 검토되었고 조직의 품질 표준을 충족한다고 신뢰할 수 있습니다. 레지스트리 구성 방식에 따라 기업 자격 증명 공급자의 IAM 자격 증명 또는 JWT 토큰을 통해 권한을 부여할 수 있습니다.
-
