AI 에이전트가 웹상에서 자유롭게 작업을 수행하는 시대가 빠르게 다가오고 있습니다. OpenAI의 Operator가 출시되면서 AI 에이전트가 웹 서비스와 어떻게 상호작용할 것인지에 대한 논의가 활발해지고 있는 가운데, 이 문제를 효과적으로 해결하려는 새로운 오픈소스 프로젝트가 주목받고 있습니다. Wildcard AI에서 개발한 ‘agents.json’은 AI 에이전트와 API 간의 상호작용을 위한 새로운 규격을 제시하며, 이를 통해 AI 에이전트의 능력을 한층 더 확장시킬 전망입니다.
API와 AI 에이전트의 괴리
현재 대부분의 API는 개발자를 위해 설계되었을 뿐, AI 에이전트와의 원활한 상호작용을 고려하지 않았습니다. 이로 인해 AI 에이전트가 API를 효과적으로 활용하기 위해서는 많은 시행착오와 보일러플레이트 코드 작성이 필요했습니다. 예를 들어, Gmail API를 사용하려면 메일 스레드 검색, 스레드 내 이메일 목록 조회, base64 RFC 822 형식의 콘텐츠로 응답하는 등 여러 단계의 API 호출이 필요합니다. 그러나 AI에게는 이 모든 과정을 단일 도구로 처리할 수 있는 명확한 지시가 필요합니다.
이런 문제를 해결하기 위해 등장한 것이 바로 ‘agents.json’입니다.
agents.json이란?
agents.json은 OpenAPI 표준을 기반으로 구축된 오픈소스 JSON 규격으로, API와 AI 에이전트 간의 상호작용을 위한 공식 계약을 정의합니다. 이 규격은 API 제공자가 이미 보유한 OpenAPI 명세를 활용하여 AI 에이전트가 더 효과적으로 API를 사용할 수 있도록 최적화합니다.
특히 주목할만한 점은 ‘flows’와 ‘links’라는 개념의 도입입니다:
- Flows: 특정 결과를 달성하기 위한 하나 이상의 API 호출 시퀀스를 설명하는 계약입니다.
- Links: 두 가지 동작이 어떻게 연결되는지 설명합니다.
이를 통해 AI 에이전트는 단순히 개별 API 엔드포인트를 호출하는 것이 아니라, 목표 달성을 위한 전체 프로세스를 이해하고 실행할 수 있게 됩니다.
agents.json의 핵심 설계 원칙
Wildcard AI 팀은 agents.json을 설계할 때 다음과 같은 네 가지 핵심 원칙을 세웠습니다:
- OpenAPI 표준 위에 구축: 가능한 한 기존 표준과 인프라를 활용합니다.
- LLM을 위한 스키마 최적화: 인간이 아닌 AI 소비를 염두에 두고 설계합니다.
- 무상태성 강제: 오케스트레이션은 호출 에이전트에 의해 처리됩니다.
- 기존 API에 최소한의 변경 요구: 도입을 최대한 원활하게 만듭니다.
이러한 원칙들은 agents.json이 실용적이면서도 미래 지향적인 솔루션이 될 수 있게 합니다.
실제 활용 사례
agents.json은 이미 여러 API와 통합되어 활용되고 있습니다. Wildcard 팀은 Stripe, Google Sheets, Resend, Rootly 등의 서비스와 연동된 데모를 공개했으며, 다음과 같은 흥미로운 사용 사례를 보여주고 있습니다:
예를 들어, Stripe Agent를 통해 AI 에이전트는 복잡한 결제 처리, 고객 관리, 구독 설정 등의 작업을 자연어 명령만으로 처리할 수 있습니다. 이는 개발자뿐만 아니라 일반 사용자도 쉽게 API의 기능을 활용할 수 있게 해줍니다.
Wildcard Bridge: 구현의 핵심
agents.json 규격을 실제로 사용하기 위한 도구로 ‘Wildcard Bridge’가 제공됩니다. 이 Python 패키지를 통해 LLM은 agents.json 파일을 로드, 파싱하고 실행할 수 있습니다:
- 개발자가 자신의 에이전트를 agents.json 파일과 연결합니다.
- 에이전트가 특정 작업에 맞는 체인을 선택하고 인수를 채웁니다.
- Bridge가 해당 체인을 실행합니다.
Wildcard Bridge는 Basic, ApiKey, Bearer 인증을 지원하며, 개발자가 간단히 agents.json 파일을 워크플로우에 추가하면 통합에 필요한 올바른 작업 세트가 자동으로 실행되도록 합니다.
왜 지금 agents.json인가?
OpenAI의 Operator 출시와 함께 AI가 자동화할 수 있는 영역이 급격히 확장되고 있습니다. AI가 웹에서 자유롭게 활동하기 위해서는 에이전트를 위한 기능과 가드레일이 필요한데, 많은 서비스에서 이미 API를 통해 이런 기능을 제공하고 있습니다.
단순히 웹 에이전트를 위한 UX를 최적화하는 것보다, API를 강화하면 더 확장 가능하고 강력하며 안전한 에이전트를 만들 수 있습니다. API는 규모에 맞게 구축된 백엔드 인프라를 기반으로 하므로, agents.json은 이러한 인프라를 최대한 활용하면서 AI 에이전트의 능력을 확장시키는 방향을 제시합니다.
기존 접근법과의 차이점
agents.json은 다른 표준 및 프로토콜과 어떻게 다를까요?
- Model Context Protocol과의 차이점: MCP가 클라이언트와 서버 간의 지속적인 연결에 의존하는 상태 유지형으로 설계된 반면, agents.json은 무상태입니다. 에이전트가 모든 컨텍스트를 독립적으로 관리하므로 기존 pub/sub 아키텍처, 서버리스 환경, 인프라 API를 그대로 활용할 수 있습니다.
- llms.txt와의 차이점: llms.txt는 웹사이트 콘텐츠를 LLM이 더 쉽게 읽을 수 있게 만드는 표준이지만, 구조화된 작업 수행의 과제를 해결하지는 않습니다. agents.json은 LLM이 여러 단계의 워크플로우를 안정적으로 실행할 수 있게 합니다.
미래 전망
Wildcard AI 팀은 agents.json을 계속 발전시켜 나갈 계획이며, 다음과 같은 기능들이 로드맵에 포함되어 있습니다:
- OAuth 지원
- 링크에서의 메모리 및 컨텍스트 관리
- 런타임에서의 필드 변환
- 속도 제한
- 병렬 태스킹
- 조건부 실행
- 반복 처리
- 오류 처리
- 스트리밍
- 페이지네이션
- agents.json 대화형 빌더
- agents.json 검증기
이러한 기능들이 구현되면 AI 에이전트는 더욱 다양하고 복잡한 작업을 처리할 수 있게 될 것입니다.
커뮤니티 참여
agents.json 규격은 Apache 2.0 라이선스 하에 오픈소스로 제공되며, Wildcard Bridge는 Affero GPL v3 라이선스 하에 소스가 공개되어 있습니다. 이 프로젝트는 커뮤니티의 의견을 적극적으로 수용하고 있으며, GitHub 저장소에서 비공식 리뷰를 호스팅하여 버전 관리와 공개 논의를 가능하게 합니다.
Wildcard AI의 공동 창업자인 Kaushik과 Yagnya는 에이전트가 예측 가능하고 안전하게 작동하도록 만드는 것을 목표로 이 프로젝트를 시작했으며, Discord 커뮤니티를 통해 관심 있는 개발자와 연구자들의 참여를 기다리고 있습니다.
결론: 협력의 새로운 표준
agents.json은 AI 에이전트와 API 간의 원활한 소통을 위한 새로운 표준을 제시함으로써, AI의 능력을 더욱 확장시킬 잠재력을 가지고 있습니다. 이는 단순히 기술적인 문제를 해결하는 것을 넘어, AI와 소프트웨어 서비스 간의 협력 방식을 재정의하는 중요한 시도입니다.
AI 기술이 빠르게 발전하는 현재, agents.json과 같은 표준화된 인터페이스는 개발자와 서비스 제공자, 그리고 최종 사용자 모두에게 혜택을 제공할 것입니다. 이를 통해 우리는 AI 에이전트가 더 자율적이고 효율적으로 작업을 수행하는 미래를 앞당길 수 있을 것입니다.
참고자료:
답글 남기기