Articleaws.amazon.com·2026년 11월 17일·0

Govern and discover records with common metadata in AWS Agent Registry

Quick Summary

AWS Agent Registry는 조직이 정의한 스키마로 레코드의 메타데이터를 검증하고, 같은 필드 값을 승인 심사와 승인된 리소스 검색에 활용할 수 있게 했다.

Govern and discover records with common metadata in AWS Agent Registry 관련 대표 이미지

🖼️ 인포그래픽

Govern and discover records with common metadata in AWS Agent Registry 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

Govern and discover records with common metadata in AWS Agent Registry의 핵심 내용을 4단계로 요약한 인포그래픽
Govern and discover records with common metadata in AWS Agent Registry 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 요약

AWS Agent Registry는 조직이 정의한 스키마로 레코드의 메타데이터를 검증하고, 같은 필드 값을 승인 심사와 승인된 리소스 검색에 활용할 수 있게 했다.

📌 핵심 요약

  • 관리자는 에이전트, Model Context Protocol(MCP) 서버, 스킬, 사용자 정의 레코드에 공통으로 적용할 필드와 특정 레코드 유형에만 적용할 필드를 정의할 수 있다. 각 필드에는 자료형, 허용값, 필수 여부를 지정한다.
  • 사용자 정의 메타데이터를 전혀 입력하지 않으면 레코드는 NON_COMPLIANT 초안으로 저장되며 승인 요청은 보류된다. 메타데이터를 입력했지만 미정의 필드, 필수 필드 누락 또는 잘못된 값이 있으면 레지스트리가 ValidationException으로 요청을 거부한다.
  • AnyCompany 사례에서 결제팀은 읽기 전용 원장 조회 서버 payments-ledger-mcp의 environment 값을 production에서 허용값인 prod로 바꿔 초안을 등록했다. 이후 자동화가 보안 검사 결과, CMDB 자산 ID, 데이터 분류를 추가했다. 업데이트는 메타데이터 전체를 교체하므로 기존 값과 새 값을 함께 기록했다.
  • AnyCompany의 AWS Lambda 함수는 COMPLIANT 여부, 보안 검사 PASSED 여부, cmdbId 존재 여부, 데이터 분류가 public 또는 internal인지 확인한다. payments-ledger-mcp는 네 조건을 모두 충족해 승인됐으며, 운영 환경에서는 confidential 또는 restricted 데이터를 수동 검토로 보낼 수도 있다.
  • 소비자와 에이전트는 자연어 검색에 environment=prod, businessUnit=payments, securityScanStatus=PASSED 같은 필터를 결합할 수 있다. 검색 결과에는 필터에 맞는 레코드 중 승인을 마친 것만 나타난다.

🧩 주요 포인트

  1. 공통 필드와 유형별 필드를 함께 정의하면 모든 팀이 environment의 허용값을 공유하면서도 MCP 서버에만 필요한 속성을 기록할 수 있다.
  2. COMPLIANT는 입력값이 스키마에 맞는다는 뜻이다. 승인자는 보안 검사 결과와 데이터 분류 등 별도의 근거로 공개 여부를 판단한다.
  3. 게시자가 기록한 업무 맥락과 기존 시스템이 추가한 검사 결과를 같은 레코드에 모으면, 승인에 사용한 값을 검색 조건으로도 쓸 수 있다.

🧠 상세 정리

1. 조직마다 다른 속성을 레지스트리에 담는 방법

AWS Agent Registry는 에이전트, MCP 서버, 스킬, 사용자 정의 레코드를 등록하고 승인하며 검색하는 카탈로그다. 각 레코드에는 이름, 설명, 프로토콜 설명자, 승인 상태가 있지만, 조직에는 어느 사업부가 리소스를 사용하는지, 누가 운영을 책임지는지, 어떤 환경에서 실행되는지 같은 정보도 필요하다. 기존에는 조직이 이런 속성을 레지스트리에서 한 번 정의해 각 레코드에 저장할 방법이 없었다. 새 사용자 정의 메타데이터 스키마를 적용하면 관리자가 속성의 의미와 입력 기준을 정하고 게시자는 리소스에 해당하는 값을 입력한다. 그러면 보안팀과 승인자는 심사할 때, 소비자와 에이전트는 리소스를 찾을 때 같은 정보를 참조할 수 있다.

2. 입력 검증과 승인 상태의 차이

관리자는 모든 레코드에 쓰는 공통 필드와 특정 레코드 유형에만 쓰는 필드를 정의하고, 각 필드에 Text, Enum, URL, Boolean 중 하나의 자료형을 지정한다. 레지스트리는 레코드를 생성하거나 수정할 때 필드 이름과 값이 스키마에 맞는지 검사한다. 사용자 정의 메타데이터 없이 새 레코드를 만들면 작업 중인 내용을 NON_COMPLIANT 초안으로 저장할 수 있지만, 필요한 필드와 값을 채워야 승인을 요청할 수 있다. 반면 메타데이터를 입력한 요청에 정의되지 않은 필드가 있거나 필수 필드가 빠졌거나 허용되지 않은 값이 있으면 ValidationException이 발생한다. GetRegistryRecord로 조회하는 COMPLIANT 상태는 입력값이 스키마를 충족한다는 뜻이며, 레코드 승인은 별도 심사에서 결정된다.

3. 운영 책임과 보안 심사 근거를 표현하는 필드

운영 측면에서는 environment와 businessUnit으로 실행 환경과 소속 사업부를 표시하고, ownerTeam과 supportContact로 운영 담당 팀과 지원 연락처를 명시할 수 있다. costCenter는 비용을 부담하는 곳을 나타내며, 구성 관리 데이터베이스(CMDB)의 자산 ID는 레지스트리 레코드를 기존 자산 목록과 연결한다. 보안 심사에는 데이터 분류, PCI 또는 HIPAA 적용 범위, 위험 등급, 보안 검사 상태와 검사 보고서 URL 같은 속성을 활용할 수 있다. 기존 보안 검사 도구나 자산 동기화 작업이 승인 요청 전에 API로 해당 값을 기록하면, 승인자는 게시자의 설명과 함께 어떤 자산이 어떤 검사를 거쳤는지 확인할 수 있다.

4. AnyCompany가 정한 공통 스키마와 MCP 전용 필드

AWS는 AnyCompany의 결제팀이 읽기 전용 원장 조회 서버 payments-ledger-mcp를 게시하는 예시로 스키마 정의부터 검색까지의 흐름을 설명한다. 관리자는 anycompany-governed-registry의 모든 레코드에 environment, businessUnit, securityScanStatus를 필수로 지정하고, ownerTeam, cmdbId, dataClassification, securityScanReportUrl은 선택 항목으로 둔다. MCP 서버에는 네트워크 외부 통신 범위를 나타내는 선택 필드 networkEgress를 추가하며, 허용값은 none, vpc-only, allowlisted-internet이다. 이 레지스트리의 autoApprovalRules 목록은 비어 있어 제출된 레코드는 승인 대기 상태에 머물고, 조직이 구성한 자동 심사나 사람의 심사를 거쳐야 승인된다.

5. 게시 단계에서 드러난 environment 값의 불일치

결제팀의 파이프라인은 첫 등록 요청에서 businessUnit을 payments로, securityScanStatus를 PENDING으로 입력하고 environment에는 production을 사용했다. 레지스트리가 environment에 허용한 값은 prod, staging, dev 세 가지였기 때문에, 필수 필드를 모두 입력했어도 요청은 거부됐다. ValidationException은 문제가 발생한 필드와 허용값을 알려 주었고, 파이프라인이 production을 prod로 고쳐 다시 제출하자 스키마를 준수하는 초안이 생성됐다. 이때 보안 검사 상태는 여전히 PENDING이었다. PENDING 자체는 스키마가 허용하는 값이므로 초안을 등록할 수 있고, 검사 통과 여부는 뒤의 승인 단계에서 판단한다.

6. 기존 값을 보존하면서 검사 결과와 자산 정보 추가

등록을 마친 뒤 AnyCompany의 자동화는 레코드를 읽고 보안 검사 상태와 보고서 URL, CMDB 자산 ID, 조직이 정한 데이터 분류를 기존 메타데이터에 더한다. 이 과정에서 중요한 API 동작은 업데이트할 때 메타데이터 전체가 교체된다는 점이다. 따라서 자동화는 결제팀이 입력한 environment와 businessUnit 등의 기존 값을 먼저 읽은 뒤, 보강한 값과 합쳐 한 번에 기록한다. 예제 코드에서 보안 검사와 CMDB 조회는 실제 도구를 연결할 자리를 표시한 모의 호출이며, 조직은 그 부분에 자체 시스템을 연결한다. 업데이트가 끝나 레코드가 다시 초안 상태가 되면 자동화가 승인을 요청하고, 레지스트리는 Amazon EventBridge로 승인 대기 이벤트를 보낸다.

7. 승인 함수가 확인하는 네 가지 조건

AnyCompany가 구성한 Amazon EventBridge 규칙은 승인 대기 이벤트를 받으면 사용자 정의 AWS Lambda 함수를 호출한다. 이 함수는 레코드가 COMPLIANT인지, 보안 검사 결과가 PASSED인지, cmdbId가 있는지, 데이터 분류가 public 또는 internal인지 확인한다. 예시의 payments-ledger-mcp는 네 가지 조건을 모두 충족해 함수가 승인하고, 조건을 충족하지 못한 레코드는 어떤 검사에서 실패했는지 이유를 명시해 거부한다. 이 네 조건은 AnyCompany 예시가 채택한 승인 기준으로, 조직은 자체 운영 환경에 맞게 심사 방식을 정할 수 있다. 가령 confidential 또는 restricted로 분류된 데이터는 담당자가 직접 검토할 수 있도록 수동 심사로 보낼 수 있다.

8. 승인된 레코드에 자연어 검색과 필터 적용

AWS Agent Registry는 사용자 정의 메타데이터 값을 검색용으로 색인하므로 개발자나 에이전트는 원하는 기능을 자연어로 표현하고 조직의 필드로 검색 범위를 좁힐 수 있다. 원장 도구를 찾는 개발자의 예시에서 자연어 검색어는 ‘ledger lookup’이며, environment 필터의 값은 prod다. 글에서 제시한 복합 필터처럼 businessUnit=payments와 securityScanStatus=PASSED까지 결합하면 운영 환경, 담당 사업부, 보안 검사 결과를 동시에 조건으로 삼을 수 있다. 이때 사용하는 값은 관리자가 정의하고 게시자와 기존 도구가 채워 넣은 값이다. 검색은 승인된 레코드만 반환하므로, 필터의 모든 값이 일치하더라도 아직 승인 대기 중인 레코드는 소비자의 검색 결과에 나타나지 않는다.

🧾 핵심 주장 / 시사점

  • securityScanStatus=PENDING도 스키마가 허용하는 값이다. 따라서 COMPLIANT인 초안이 보안 검사를 기다릴 수 있고, 승인 함수는 이후 PASSED 여부를 따로 판단할 수 있다.
  • 게시자와 자동화가 서로 다른 시점에 필드를 채우는 구조에서는 메타데이터 전체 교체 동작이 중요하다. 검사 결과만 써 넣으면 게시자가 먼저 입력한 업무 맥락을 보존할 수 없다.
  • 검색의 승인 제한은 필드 필터와 독립적으로 작동한다. 원하는 기능과 운영 조건이 모두 일치해도 심사가 끝나야 소비자가 해당 리소스를 발견할 수 있다.

✅ 액션 아이템

  • 공통 필드와 MCP 전용 필드를 구분하고, environment의 허용값을 게시 파이프라인에도 적용한다.
  • CMDB 자산 ID와 보안 검사 결과를 추가할 때 기존 메타데이터를 읽어 새 값과 함께 기록한다.
  • 승인 심사에서 COMPLIANT 여부와 보안 검사 PASSED 여부를 각각 확인하고, confidential 또는 restricted 데이터의 수동 검토 여부를 정한다.

❓ 열린 질문

  • 모든 팀이 함께 써야 할 공통 필드는 무엇이고, MCP 서버에만 필요한 속성은 무엇인가?
  • 데이터 분류가 confidential 또는 restricted인 레코드는 어떤 경우에 수동 검토로 보낼 것인가?
  • 운영 중인 결제 리소스를 찾을 때 자연어 검색에 environment=prod, businessUnit=payments, securityScanStatus=PASSED 중 어떤 조건을 함께 적용할 것인가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.