agent.json 기반 URL-first 온보딩으로 AI 에이전트 진입 장벽 제거

Agent Onboarding by URLs: Integrate AgentShare Without Reading Docs

anhmtk2026년 5월 8일6분intermediate

AI 요약

Context

기존 AI 에이전트의 서비스 통합 방식은 사람이 읽는 문서(Human-readable Docs)에 의존하여 수동 설정이 필요함. 이로 인해 에이전트가 스스로 API 기능을 탐색하고 자율적으로 부트스트랩하는 과정에서 병목 현상 발생.

Technical Solution

agent.json을 Single Source of Truth로 정의하여 에이전트 전용 머신 리더블 엔트리포인트 구축
Discovery URLs, Auth Method, MCP Endpoint, Tools, Scope를 하나의 JSON 스키마에 통합하여 자동 온보딩 구조 설계
JSON REST API와 MCP(Model Context Protocol) Streamable HTTP를 병행 지원하여 에이전트 인터페이스 다변화
/.well-known/agentshare.json 경로를 통한 표준화된 Discovery 메커니즘 적용
API Key 기반의 인증 체계를 도입하되, Meta 및 Health 체크 등 기본 탐색 엔드포인트는 무인증으로 개방
커뮤니티 기반의 submit_product_url 엔드포인트를 구축하여 실제 수요에 따른 데이터 커버리지 확장 구조 채택

실천 포인트

- AI 에이전트 대응을 위해 `/.well-known/` 경로에 서비스 명세 JSON 제공 검토 - LLM이 이해하기 쉬운 `llms.txt` 및 `openapi.json` 파일의 공개 엔드포인트 배치 - 문서 의존도를 낮추기 위해 기능 탐색(Discovery) -> 인증(Auth) -> 실행(Execute)의 자율적 체인 구성

태그

#MCP #JSON Schema #Agent-Native #Discovery API #Onboarding

원문 읽기