에이전트 메타데이터는 Microsoft Entra Agent Registry 내에서 에이전트 검색을 위한 기초 역할을 합니다. 제공하는 메타데이터는 다른 에이전트, 애플리케이션 및 사용자가 에이전트를 찾고 상호 작용하는 방법을 결정합니다. 메타데이터 스키마와 컬렉션 모델과의 관계를 이해하면 적절한 보안 경계를 유지하면서 의도한 대상 그룹이 에이전트를 검색할 수 있습니다.
에이전트 메타데이터 스키마
에이전트 메타데이터 스키마는 에이전트 검색 및 상호 작용에 필요한 정보 구조를 정의합니다. 이 스키마를 사용하면 보안 강화를 위해 Microsoft Entra 관련 기능으로 확장하면서 표준 프로토콜을 통해 에이전트 협업을 수행할 수 있습니다.
기본 에이전트 정보
기본 메타데이터에는 에이전트에 대한 필수 식별 및 연락처 정보가 포함됩니다.
| 분야 | Description |
|---|---|
id |
에이전트 매니페스트의 고유 식별자입니다. 모든 에이전트 등록에 필요합니다. |
displayName |
검색 결과에 나타나는 사람이 읽을 수 있는 식별자입니다. "고객 지원 도우미" 또는 "송장 처리 에이전트"와 같은 에이전트의 용도를 명확하게 나타내야 합니다. |
description |
에이전트의 용도 및 기능에 대한 포괄적인 세부 정보입니다. 이러한 유형의 에이전트를 검색할 때 대상 대상이 자연스럽게 사용하는 관련 키워드를 포함하면 검색 가능성에 직접적인 영향을 줍니다. |
iconUrl |
검색 결과 및 사용자 인터페이스에서 시각적 식별을 제공하는 에이전트의 아이콘 이미지에 대한 URL입니다. |
version |
에이전트 구현의 버전으로, 통합 시나리오에 대한 에이전트 업데이트 및 호환성 고려 사항을 추적할 수 있습니다. |
documentationUrl |
에이전트 설명서의 URL입니다. 성공적인 에이전트 채택을 지원하기 위해 자세한 API 설명서, 사용 예제 및 문제 해결 가이드에 대한 링크를 포함합니다. |
protocolVersion |
에이전트에서 지원하는 프로토콜 버전으로, 통신 중에 클라이언트 및 기타 에이전트와의 호환성을 보장합니다. |
provider |
조직 이름 및 연락처 URL을 포함하여 에이전트를 제공하는 조직에 대한 정보입니다. 검색 중에 에이전트의 원본을 식별하고 에이전트 인증을 위한 확인 지점을 제공합니다. |
managedBy |
이 매니페스트를 관리하는 애플리케이션 식별자이며, 에이전트의 수명 주기 및 구성에 대한 명확한 소유권과 책임을 설정합니다. |
originatingStore |
에이전트가 시작된 저장소 또는 시스템의 이름으로, 레지스트리 내에서 에이전트 원본 및 계보를 추적할 수 있습니다. |
기술 및 기능 메타데이터
에이전트가 제공하는 핵심 기능 및 상호 작용 기능입니다.
| 분야 | Description |
|---|---|
skills |
에이전트에서 제공하는 핵심 기능입니다. 각 기술에는 고유 식별자, 설명이 포함된 이름 및 기술이 수행하는 작업을 설명하는 자세한 설명이 필요합니다. 기능 기반 검색에서 검색 가능성을 직접 결정합니다. |
defaultInputModes |
에이전트에서 지원하는 기본 입력 모드입니다. "text/plain", "application/json" 또는 "image/png"와 같은 일관된 MIME 형식 사양을 사용하여 클라이언트 애플리케이션과 적절한 일치를 보장합니다. |
defaultOutputModes |
에이전트에서 지원하는 기본 출력 모드입니다. 에이전트가 생성하는 데이터 형식을 지정하여 에이전트 검색 중에 자동 호환성 검사를 사용하도록 설정합니다. |
capabilities |
에이전트가 통합 프로토콜을 지원하는 기술 기능입니다. |
capabilities.extensions |
URI, 설명, 필수 상태 및 매개 변수를 포함한 속성을 포함하는 확장 기능입니다. 페더레이션 시나리오 중에 다른 에이전트 및 애플리케이션이 에이전트와 상호 작용하는 방식에 영향을 줍니다. |
보안 및 공급자 정보
검색 가능성, 신뢰 및 액세스 정책에 영향을 주는 보안 및 인증 요구 사항입니다. 보안 및 공급자 정보는 Microsoft Entra Agent Registry가 수집 할당 및 검색 정책을 에이전트에 적용하는 방식에 직접적인 영향을 미치므로 이러한 필드는 적절한 관리 및 규정 준수에 매우 중요합니다.
| 분야 | Description |
|---|---|
securitySchemes |
에이전트가 지원하는 인증 방법을 지정하는 스키마 이름으로 키 지정되는 보안 체계 정의의 사전입니다. 인증 요구 사항을 충족할 수 있는 클라이언트에 대해서만 에이전트가 검색 결과에 표시되는지 확인합니다. |
security |
다른 작업에 적용되는 보안 체계 참조의 배열입니다. 검색 중에 호환되지 않는 일치 항목을 필터링하여 실패한 통합 시도를 방지하고 사용자 환경을 개선하는 보안 요구 사항을 정의합니다. |
signatures |
매니페스트 무결성 및 신뢰성을 확인하기 위한 보호된 콘텐츠, 서명 값 및 헤더 정보를 포함하여 매니페스트에 대한 디지털 서명입니다. |
supportsAuthenticatedExtendedCard |
에이전트가 인증된 호출자에게 더 많은 메타데이터를 제공하는지 여부를 나타냅니다. 자세한 운영 정보에는 인증이 필요한 동안 기본 기능을 공개적으로 검색할 수 있는 정보를 점진적으로 공개할 수 있습니다. |
ownerIds |
에이전트 매니페스트에 대한 권한이 있는 소유자 식별자 목록입니다. |
컬렉션 및 검색 가능성
컬렉션은 서로를 검색하고 통신 채널을 설정할 수 있는 에이전트를 결정합니다. 에이전트는 관리자 또는 정의된 조직 정책을 통해 컬렉션에 명시적으로 할당되어야 합니다. 메타데이터 태그 또는 에이전트 특성을 기반으로 하는 자동 할당은 없습니다. 이 명시적 할당 모델은 에이전트 검색 가능성 및 상호 작용 패턴에 대한 적절한 거버넌스 및 보안 제어를 보장합니다.
컬렉션 유형, 할당 규칙 및 검색 정책에 대한 포괄적인 내용은 에이전트 레지스트리 컬렉션을 참조하세요.