A2A 프로토콜 완벽 해설: Wellknown의 에이전트 카드와 인덱싱
A2A 프로토콜과 에이전트 카드 작동 방식, Wellknown의 A2A 에이전트 인덱싱 방법을 알아봅니다.
A2A 프로토콜과 에이전트 카드 작동 방식, Wellknown의 A2A 에이전트 인덱싱 방법을 알아봅니다.
A2A 프로토콜, 또는 Agent2Agent 프로토콜은 AI 에이전트들이 서로를 발견하고 JSON-RPC를 통해 작업을 교환할 수 있도록 하는 오픈 표준입니다. 이 프로토콜의 핵심은 A2A 에이전트가 /.well-known/agent-card.json 경로에 게시하는 JSON 문서인 에이전트 카드입니다. 이 카드는 에이전트의 이름, 기능, 엔드포인트 URL, 보안 체계를 설명하여 다른 에이전트와 인덱스가 이를 이해하고 상호작용할 수 있게 합니다.
/.well-known/agent-card.json에 위치합니다.A2A 프로토콜은 Agent2Agent 프로토콜의 약자로, AI 에이전트들이 서로를 발견하고 작업을 교환할 수 있도록 설계된 오픈 프로토콜입니다. 에이전트는 도메인의 잘 알려진 위치에 표준화된 JSON 문서인 에이전트 카드를 게시합니다. 에이전트 간 통신은 JSON으로 인코딩된 원격 프로시저 호출 프로토콜인 JSON-RPC를 통해 이루어집니다.
이 프로토콜은 에이전트들이 동적으로 동료를 찾고 구조화된 방식으로 작업과 응답을 주고받으며 협력할 수 있게 합니다. MCP(모델 컨텍스트 프로토콜)처럼 AI 애플리케이션을 도구와 데이터에 연결하는 프로토콜과는 구별됩니다.
에이전트 카드는 A2A 에이전트가 자신의 도메인 내 /.well-known/agent-card.json 경로에 게시하는 JSON 문서입니다. 이 위치는 표준화되어 있어 다른 에이전트와 인덱스가 어디서 찾아야 할지 알 수 있습니다.
에이전트 카드는 다음을 설명합니다:
이 정보를 제공함으로써 에이전트 카드는 에이전트 발견과 상호작용을 가능하게 합니다. Wellknown 같은 인덱스가 읽어 에이전트를 목록화하고 분류하는 자기 설명서 역할을 합니다.
Wellknown은 AI 에이전트, MCP 서버, 도구들의 라이브 인덱스로, 이들의 엔드포인트를 적극적으로 검사합니다. 에이전트 도메인에서 /.well-known/agent-card.json JSON 문서를 가져와 에이전트 이름, 기능, 엔드포인트 등 선언된 메타데이터를 추출합니다.
Wellknown은 출판자가 명시한 선언된 메타데이터와 엔드포인트 점검을 통해 측정한 관찰된 데이터(상태, 응답 시간 등)를 구분하여 투명하게 에이전트의 현재 가용성과 신뢰도를 제공합니다.
2026-10-31 최신 데이터 기준으로 Wellknown은 A2A 프로토콜 관련 기록 2,749개를 보유하고 있습니다. 이 중 2,153개가 최근 24시간 내 점검에 성공해 현재 활성(라이브) 상태입니다. 이는 네트워크에서 접근 가능한 활발한 A2A 에이전트가 많음을 의미합니다.
참고로 Wellknown 전체 인덱스 크기는 79,658개 기록이며, 이 중 24,496개가 활성 상태입니다. A2A 프로토콜은 이 생태계에서 중요한 부분을 차지합니다.
에이전트는 다음 두 가지 방식으로 Wellknown 인덱스에 등록됩니다:
자체 제출: 출판자는 도메인이나 저장소 제어권을 증명하여 에이전트를 제출할 수 있습니다. 증명 방법으로는 _wellknown.YOUR-DOMAIN에 DNS TXT 레코드 추가, https://YOUR-DOMAIN/.well-known/wellknown-verify.txt에 검증 파일 호스팅, 저장소 루트에 .wellknown-verify 파일 배치 등이 있습니다.
발견: Wellknown은 MCP 레지스트리, npm, PyPI, GitHub 등 알려진 소스를 스캔하고, 특히 /.well-known/agent-card.json에서 에이전트 카드를 가져와 자동으로 에이전트를 발견합니다(소스 라벨 a2a_card).
인덱스에 등록된 에이전트는 Wellknown의 HTTP API 엔드포인트와 MCP 서버 도구를 통해 검색, 확인, 상태 점검이 가능합니다.
A2A 프로토콜은 AI 에이전트들이 표준화된 위치에 에이전트 카드를 게시해 서로를 발견하고 소통할 수 있게 합니다. Wellknown은 이 에이전트 카드를 읽어 인덱싱하며, 현재 2,749개의 A2A 기록 중 2,153개가 활성 상태입니다. 에이전트는 자체 제출 또는 발견을 통해 인덱스에 등록되며, 도메인 제어 증명을 통해 신뢰성을 확보합니다. 이는 개발자들이 활성 A2A 에이전트와 그 기능을 찾는 데 매우 유용한 자원입니다.
이 데이터는 2026-10-31 기준 스냅샷입니다.
Google 페이지에서 Wellknown에 체크하면 주요 뉴스에서 저희 글을 더 많이 볼 수 있습니다.
Google에서 Wellknown을 선호 출처로 추가위 시점에 실시간 인덱스에서 팩트 시트를 계산했습니다. 언어 모델이 그 시트만으로 글을 작성했으며, 글의 모든 수치가 시트에 있고 모든 레코드 링크가 유효함을 확인한 뒤 게시했습니다.
이 글은 영어 원문의 번역이며, 수치와 링크를 원문과 다시 대조했습니다.