AI 에이전트가 API 문서를 이해하기 위해 단순히 OpenAPI, AsyncAPI 같은 API 명세만으로는 충분하지 않으며, API를 제대로 이해하고 활용하려면 전체 API 운영 정보를 기계가 읽을 수 있는 형태로 제공해야 한다고 강조합니다. 이런 정보를 제공할 수 있는 적절한 방법이 APIs.json이라고 합니다.
APIs.json은 문서, 인증, 버전, 가이드 뿐 아니라 가격 정보까지 API 전반에 걸친 정보를 구조화해서 담을 수 있으며 확장할 수 있기 때문에 AI 에이전트가 적절하게 정보를 탐색할 수 있는 안내를 제공할 수 있다고 합니다.
웹사이트에서 sitemap.xml 파일을 SEO를 위해 활용한 것과 비슷한 개념이라고 할 수 있습니다.
https://apisjson.org/
https://github.com/apis-json/api-json
APIs.json은 API가 좀 더 잘 검색될 수 있게 만드는 용도로 만들어졌으며, AI와 연결되어 다시 주목받고 있다고 합니다(물론 발표자의 주장입니다. 아직은 구체화된 제품이나 솔루션이 나와있는 것은 아니라서).
아래 링크는 발표 영상과 비슷한 내용입니다.
https://pronovix.com/articles/unleash-power-ai-make-your-apis-future-proof-apisjson
https://youtu.be/PQow32f3pS0?si=hL7tBcMUWfaSp2qp
* API와 AI Agent 관련해서 다양한 시도가 진행되고 있습니다. 기존 OpenAPI 명세를 활용하는 방안이 좀 더 현실적이구요. 다만 발표자의 주장은 명세서에 담지 못하는 다양한 정보까지 접근할 수 있는 안내가 필요하다 뭐 이런 것이겠죠.
