Agent card
Concept
A2A 프로토콜에서 에이전트 카드(agent card)는 잘 알려진 URL에 게시되는 기계가 읽을 수 있는 문서로, 다른 에이전트가 이를 찾아볼 수 있도록 에이전트의 이름, 기능, 스킬, 엔드포인트, 인증 요구 사항, 입력 및 출력 형식을 설명합니다.
함께 다룬 주제
Agent card 관련 에피소드에서는 Microsoft Purview Information Barriers, Context window, Front matter, Agent kill switch, AI red teaming 및 AI Center of Excellence도 다룹니다.
Description
에이전트 카드(agent card)는 Agent2Agent(A2A) 프로토콜에서 에이전트를 설명하는 데 사용되는 기계 판독 가능 문서입니다. 잘 알려진 URL에 게시되며, 에이전트의 이름, 설명, 버전, 기능, 스킬, 엔드포인트, 인증 요구 사항, 지원하는 입력 및 출력 형식과 같은 메타데이터를 담고 있습니다. 핵심 목적은 검색(discovery)입니다. 클라이언트나 다른 에이전트는 해당 에이전트에 요청을 보내기 전에 카드를 읽어 어떤 기능을 제공하는지 확인할 수 있습니다.
A2A 프로토콜은 표준화된 언어를 강조함으로써 에이전트 간의 상호 운용성을 다루며, 이를 통해 에이전트 간 상호작용마다 별도의 맞춤 코드가 필요하지 않게 됩니다. 에이전트 카드는 이러한 접근 방식에서 에이전트가 자신의 정체성과 기능을 알릴 수 있게 해 주는 부분입니다. 원격 에이전트에 대한 가정을 코드에 고정하는 대신, 호출하는 에이전트는 게시된 카드를 읽고 해당 에이전트에 도달하는 방법과 교환할 수 있는 데이터의 종류를 파악합니다.
Microsoft Agent Framework의 A2A 호스팅에 관한 Microsoft Learn 페이지는 실제로 이것이 어떻게 구현되는지를 보여 줍니다. ASP.NET Core 호스팅 예제에서 카드는 agent-card.json으로 끝나는 잘 알려진 경로에서 제공됩니다. 카드를 노출하는 매핑 메서드는 Agent Framework 호스팅 패키지가 아니라 A2A SDK 패키지에서 제공됩니다. 샘플 카드에는 이름, 설명, 버전, 기본 입력 및 출력 모드, 그리고 URL, 프로토콜 바인딩, 프로토콜 버전을 포함하는 지원 인터페이스가 설정되어 있습니다. 이 페이지는 운영 환경에서는 카드를 완전히 채울 것을 권장하며, 그래야 클라이언트가 호출하려는 에이전트에 대한 완전한 정보를 받을 수 있다고 설명합니다.
문서에 설명된 실질적인 제약은 호스팅과 관련됩니다. 단일 호스트는 잘 알려진 경로에 하나의 에이전트 카드만 게시할 수 있으므로, 그 위치에서 검색할 수 있는 에이전트는 하나뿐입니다. 같은 호스트에서 함께 호스팅되는 다른 에이전트들은 자체 URL을 통해 여전히 접근할 수 있지만, 공유된 잘 알려진 위치는 이들을 나열하지 않으므로 클라이언트가 해당 엔드포인트를 미리 알고 있어야 합니다. 여러 에이전트를 배포할 때는 이 점이 검색 설계 방식과 엔드포인트 정보를 소비자와 공유하는 방식에 영향을 줍니다. 문서 페이지는 스킬, 인증 세부 정보 또는 카드 서명은 다루지 않으므로, 이러한 측면은 여기서 일반적인 정의 수준에서만 설명합니다.
"Agent-to-Agent (A2A) Communication - Simply Explained" 에피소드는 상호 운용성에 대한 더 넓은 논의의 일부로서 이 개념을 다룹니다. 이 에피소드는 에이전트 카드를 에이전트가 자신의 정체성과 기능을 알리는 메커니즘으로 소개하며, 이를 통해 검색과 상호작용이 더 쉬워진다고 설명합니다. 또한 같은 에피소드는 이를 에이전트들이 다양한 유형의 데이터를 교환하여 협업과 작업 상태 추적을 지원하는 구조화된 통신과 연결하며, 에이전트 간 통신에서 개인정보 보호와 보안 문제가 핵심이라는 점과 이러한 시스템을 다루는 사람은 데이터 처리와 관련된 위험을 인지해야 한다는 점을 강조합니다. 에이전트 카드는 에이전트와 그 도달 방법에 대한 정보를 공개하므로, 무엇을 포함할지와 접근을 어떻게 제어할지를 결정하는 것도 이러한 더 넓은 보안 고려의 일부입니다.
요약하면, 에이전트 카드는 A2A 에이전트에 대한 공개 설명 역할을 합니다. 작업을 전송하기 전에 클라이언트가 읽으며, 예측 가능한 위치에서 제공되고, 운영 환경에서는 완전하고 정확해야 합니다. ASP.NET Core 호스팅 예제에서 잘 알려진 경로당 카드가 하나만 허용된다는 제약은, 같은 호스트에서 둘 이상의 에이전트를 노출할 때마다 고려해야 할 설계 포인트입니다.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Type | Concept |
|---|---|
| Kind | Format |
Frequently asked questions
Questions marked with AI were written with AI from the facts on this page.
A2A 프로토콜에서 에이전트 카드란 무엇입니까? (AI)
에이전트 카드는 기계 판독 가능한 문서로, 잘 알려진 URL에 게시되며 에이전트의 이름, 기능, 스킬, 엔드포인트, 인증 요구 사항, 입력/출력 형식을 설명하여 다른 에이전트가 검색할 수 있게 합니다.
Microsoft Agent Framework 예제에서 에이전트 카드는 어디에서 제공됩니까? (AI)
ASP.NET Core 호스팅 예제에서는 agent-card.json으로 끝나는 잘 알려진 경로에서 제공되며, Agent Framework 호스팅 패키지가 아니라 A2A SDK 패키지의 매핑 메서드를 사용합니다.
하나의 호스트가 여러 에이전트 카드를 게시할 수 있습니까? (AI)
Microsoft Learn 페이지에 따르면 단일 호스트는 잘 알려진 경로에 하나의 에이전트 카드만 게시할 수 있으므로 그 위치에서 검색할 수 있는 에이전트는 하나뿐입니다. 다른 에이전트는 자체 URL로 접근할 수 있으나, 클라이언트가 해당 URL을 미리 알고 있어야 합니다.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Experts and companies for this topic
Nobody has listed this topic yet. Add it to your profile.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: