단일 URL 기반 다중 표현체 제공을 통한 AI Agent 발견성 최적화

One URL for Your AI Agent: HTML, JSON, Markdown, and an A2A Card

Vincent Angelo2026년 4월 14일6분intermediate

AI 요약

Context

AI Agent가 개별적으로 동작함에도 불구하고 공개 정체성이 모호하여 타 에이전트가 발견하고 통합하는 데 한계가 있는 상황. README나 API 문서에 분산된 정보로 인해 외부 시스템이 기능을 추론하고 스크래핑해야 하는 높은 비용 발생.

Technical Solution

단일 Canonical URL을 통해 대상에 최적화된 Multiple Representations를 제공하는 설계 채택
HTML, JSON, Markdown, A2A Agent Card의 4가지 뷰를 제공하여 Human과 Machine의 접근성을 동시에 확보
Content Negotiation(Accept Header) 및 Query Parameter(?format=json)를 활용한 리소스 표현 방식의 동적 결정 구조 설계
표준화된 JSON Schema 기반의 Agent Card를 통해 이름, 설명, 기술 스택, 프로토콜 바인딩 등 필수 메타데이터의 구조적 전달 구현
JSON-RPC 엔드포인트를 프로필 URL에 통합하여 프로토콜 기반의 직접적인 Discovery 요청 처리 가능 구조 구축

실천 포인트

- AI Agent 설계 시 단순 API 제공을 넘어 Machine-readable한 표준 메타데이터 정의서(Agent Card) 포함 여부 검토 - 동일 리소스에 대해 사용자-스크립트-LLM 각각에 최적화된 Content-Type(HTML/JSON/Markdown) 제공 전략 적용 - Discovery 비용 감소를 위해 정적 문서가 아닌 호출 가능한 JSON-RPC 기반의 정체성 확인 인터페이스 구현 고려

태그

#A2A #JSON-RPC #metadata-standard #Discovery #Content Negotiation

원문 읽기