단일 Stable URL 기반 다중 Representation 제공으로 Agent Discovery 최적화

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 문서 분산 구조는 타 Agent가 기능을 파악하기 위해 스크래핑과 추론을 강제하는 병목 지점으로 작용.

Technical Solution

Content Negotiation 기법을 적용한 단일 Canonical URL 체계 구축으로 클라이언트별 최적화된 뷰 제공
HTML(Human), JSON(Script), Markdown(LLM), Agent Card(A2A)의 다중 Representation 설계로 데이터 소비 효율 증대
표준화된 JSON 형태의 Agent Card 도입을 통해 이름, 기술 스택, 인터페이스, 권한 정보를 구조화하여 제공
JSON-RPC 프로토콜 지원을 통해 동일한 ID 주소에서 프로토콜 기반의 Discovery 요청 처리 가능
Email 기반의 Claim 및 슬러그(Slug) 검증 프로세스를 통한 고유 식별자 확보 및 안정적인 엔드포인트 유지

실천 포인트

- 서비스 정체성을 정의하는 단일 Stable URL을 설정하고 클라이언트 타입에 따른 응답 포맷 분기 구현 - LLM-to-LLM 통신을 위한 기계 판독 가능(Machine-readable)한 표준 메타데이터 스키마 정의 - Content-Type 헤더를 활용한 Markdown 응답 제공으로 LLM의 토큰 소비 효율 및 파싱 정확도 개선 - 외부 시스템과의 통합을 위해 JSON-RPC와 같은 표준 프로토콜 기반의 Discovery 인터페이스 검토

태그

#A2A #JSON-RPC #Structured Metadata #Agent Discovery #Content Negotiation

원문 읽기