M365Con 2027 – 무료 온라인 컨퍼런스 · 11–22 Jan 2027 · 120 sessions m365con.net

Agent card

Concept

A2A 프로토콜에서 에이전트 카드(agent card)는 잘 알려진 URL에 게시되는 기계가 읽을 수 있는 문서로, 다른 에이전트가 이를 찾아볼 수 있도록 에이전트의 이름, 기능, 스킬, 엔드포인트, 인증 요구 사항, 입력 및 출력 형식을 설명합니다.

✦ CONCEPTAgent cardM365.FM
Title graphic: Agent card (Concept)

함께 다룬 주제

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.

TypeConcept
KindFormat

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을 미리 알고 있어야 합니다.

Glossary

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: