이 문서에서는 API 센터에서 A2A 에이전트를 포함한 AI 에이전트를 등록하고 사용자가 검색할 수 있도록 하고 업데이트 및 관리하는 방법을 보여 줍니다.
필수 조건
- Azure API Center 인스턴스
- JSON 형식의 에이전트 카드 또는 Markdown 형식의 에이전트 정의로 설명된 에이전트
- API 센터에서 API를 편집할 수 있는 적절한 권한
에이전트 등록
Azure 포털 로그인하고 API 센터로 이동합니다.
사이드바 메뉴의 인벤토리에서 자산을 선택합니다.
+ 자산>에이전트 등록을 선택합니다.
에이전트 등록 양식에서 다음 표에 설명된 정보를 입력합니다.
분야 Description Title 상담원의 설명이 포함된 이름(예: 지원 센터 에이전트)을 입력합니다. 신원 확인 API 센터는 지원 센터 에이전트와 같은 제목을 기반으로 식별자를 자동으로 생성합니다. 필요한 경우 이 식별자를 편집할 수 있습니다. 짧은 요약 API 센터 포털 및 기타 위치에 표시되는 에이전트가 수행하는 작업을 간략하게 한 줄로 설명합니다. 설명 필요에 따라 기술의 기능, 사용 사례 및 동작에 대한 자세한 설명을 입력합니다. 버전 버전 제목 원하는 버전 제목을 입력합니다(예: v1). 버전 식별 API Center는 버전 제목에 따라 식별자를 자동으로 생성합니다. 필요한 경우 이 식별자를 편집할 수 있습니다. 버전 수명 주기 드롭다운 메뉴에서 에이전트 버전 수명 주기의 현재 단계를 선택합니다. API 센터의 버전에 대해 자세히 알아봅니다. 에이전트 세부 정보 에이전트 정의 URL을 입력하거나 에이전트 정의를 업로드할 파일을 선택합니다 . 에이전트 정의는 Markdown 형식이어야 하며 에이전트의 기능, 기술 및 기타 관련 정보에 대한 세부 정보를 포함해야 합니다. 프로토콜 해당하는 경우 에이전트가 이를 준수하는 경우 A2A 프로토콜을 선택합니다. 에이전트 카드 필요에 따라 URL을 입력하거나 파일을 선택하여 A2A 에이전트 카드를 JSON 형식으로 업로드합니다. 
만들기를 선택하여 에이전트를 추가합니다.
등록 후에는 인벤토리자산 페이지의 인벤토리 > 에 에이전트가 표시됩니다.
등록된 에이전트 업데이트
언제든지 에이전트 정보를 업데이트할 수 있습니다.
- Azure Portal에서 API 센터로 이동합니다.
- 사이드바 메뉴의 인벤토리에서 자산을 선택합니다.
- 테이블에서 제목 열에서 에이전트 이름을 선택합니다.
- 편집 단추를 선택하여 작업 창에서 편집 페이지를 엽니다.
- 변경하고 저장을 선택합니다.
API 원본에서 에이전트 동기화
에이전트 등록을 자동화하고 인벤토리를 최신 상태로 유지하려면 다음 업스트림 원본을 API 센터와 통합할 수 있습니다.
Azure API Management: Azure API Management A2A 에이전트를 관리하는 경우 자동 동기화를 사용하도록 설정하여 API 센터를 최신 상태로 유지할 수 있습니다. 자세한 내용은 Azure API Management 인스턴스에서 API 동기화 참조하세요.
Git 리포지토리: Git 리포지토리에 저장된 A2A 에이전트 및 기타 AI 자산의 경우 자동 동기화를 사용하도록 설정하여 API 센터를 최신 상태로 유지할 수 있습니다. 자세한 내용은 Git 리포지토리에서 API 자산 동기화를 참조하세요.
API 센터 포털에서 에이전트 검색
개발자와 조직의 다른 이해 관계자가 API 인벤토리에서 에이전트를 검색할 수 있도록 API 센터 포털 을 설정합니다. API 센터 포털에서 사용자는 다음을 수행할 수 있습니다.
- 인벤토리에서 에이전트를 찾아보고 필터링합니다.
- 각 에이전트에 대한 자세한 정보를 봅니다.
AI 자산 평가
API 센터는 API 센터에 등록된 기술 및 에이전트와 같은 AI 자산의 품질을 평가할 수 있습니다. API 센터에는 기본 평가 기준이 기본적으로 제공되며 미리 정의된 차원 간에 자산을 평가합니다. 엔터프라이즈 플랫폼 관리자는 조직의 특정 표준, 규정 준수 요구 사항 및 거버넌스 정책에 맞게 사용자 지정 평가 기준을 정의하여 이러한 기본값을 더욱 확장할 수 있습니다.
인벤토리에서 AI 자산에 대한 자동화된 평가를 사용하도록 설정하려면 다음을 수행합니다.
Azure Portal에서 API 센터로 이동합니다.
사이드바 메뉴에서 거버넌스>AI 평가로 이동합니다.
기술 탭을 선택하여 기술에 대한 평가를 구성하거나 에이전트 탭을 선택하여 에이전트에 대한 평가를 구성합니다.
평가 상태에서[사용]을 선택합니다.
평가에 대한 설명을 입력합니다.
평가 기준에서 다음 중 하나를 수행합니다.
- API 센터에서 제공하는 기본 조건을 적용합니다. 필요에 따라 조직과 관련이 없는 기본 조건을 제거합니다.
다음 스크린샷은 기술에 대한 기본 조건을 보여줍니다.
- 하나 이상의 사용자 지정 조건을 추가합니다.
- +조건 추가를 선택합니다.
- 기준에 대한 이름 및 선택적 평가 지침을 입력합니다.
- 점수의 최소 점수 및 최대 점수 값을 입력합니다(예: 1, 5).
- 기준에 허용되는 최소 점수를 나타내는 Pass 임계값 (예: 3)을 입력합니다.
- 총 평가에 대한 기준의 기여도를 나타내는 가중치 값을 입력합니다(예: 가중치 0.3은 점수의 0.3을 배수하여 총 평가에 30% 기여).
- 필요에 따라 조건을 더 추가하려면 이전 단계를 반복합니다.
저장을 선택합니다.
그런 다음 API 센터 포털에서 평가 결과를 볼 수 있습니다. 예를 들어 기술 세부 정보 페이지에서 각 기술에 대한 평가 결과를 봅니다.
