Monid – AI 에이전트 도구를 위한 OpenRouter 스타일 카탈로그

정의 – Monid는 AI 에이전트가 단일 통합 API를 통해 모든 외부 도구(검색, 데이터 보강, 미디어 생성 등)를 호출할 수 있게 하는 프레임워크입니다. 70개 이상의 공급자에서 2,000개 이상의 도구 엔드포인트를 집계하여 discover, inspect(둘 다 무료) 및 run(호출당 청구)의 세 가지 동사로 노출합니다.

중요성 – 에이전트는 더 이상 하드코딩된 공급업체 URL이나 사용자 정의 어댑터가 필요하지 않습니다. 커넥터(공급자 엔드포인트의 선언적 설명)는 Monid에 서비스를 호출하는 방법, 인증 방법 및 사용량 가격 책정 방법을 알려줍니다. 런타임에 Monid는:

1. 주어진 작업에 가장 저렴하고 적합한 엔드포인트를 발견합니다.
2. 요청을 실행하고 원시 트래픽을 측정하며 출력 매핑 전에 공급자의 사용 모델을 적용하여 에이전트가 전송된 내용에 대해 정확히 청구되도록 합니다.
3. 커넥터에 정의된 계약과 일치하는 구조화된 응답을 반환합니다.

주요 개념

• 커넥터 – 공급자(defineProvider)와 하나 이상의 엔드포인트(defineEndpoint)를 선언하는 TypeScript 파일입니다. 메타데이터, 인증 주입, 요청 스키마(Zod 통해), 시간 초과 및 사용 모델(무료, 호출당, 문자당 등)을 포함합니다.
• 리소스 – "소유" 서비스(예: 전화번호)의 수명 주기, 스냅샷 및 요금표를 모델링하기 위한 선택 사항입니다.
• 엔진 – 입력 검증, HTTP 요청 구성, 자격 증명 주입, 사용량 결제, 응답 매핑 및 최종 출력 검증을 수행하는 런타임입니다.
• 카탈로그 CLI – 명령(deno task catalog …)을 통해 공급자 목록, 엔드포인트 탐색 및 전체 계약 검사가 가능합니다.

새 도구 추가 방법

1. 저장소를 클론하고 Deno 2.x를 설치합니다.
2. connectors/<provider>/ 아래에 새 폴더를 만들고 provider.ts와 하나 이상의 엔드포인트 정의를 포함합니다.
3. 요청 매개변수에 대한 Zod 스키마를 작성합니다.
4. 픽스처를 기록하여(deno task record) 실제 응답을 캡처합니다. 테스트는 이러한 픽스처를 재생하므로 CI는 네트워크 액세스가 필요하지 않습니다.
5. deno task check && deno task test를 실행하여 타입 안전성과 재생 테스트 통과를 확인합니다.
6. PR을 열고 support@monid.ai로 이메일을 보냅니다. 팀은 게시 전에 커넥터를 수동으로 검토합니다.

엔드포인트 실행

export TINYFISH_CREDENTIALS_API_KEY=…
 deno task engine:run 'tinyfish#search' \
   --query-params '{"query":"solid-state battery suppliers","domain_type":"news"}'

이 명령은 구조화된 결과를 출력하고 공급자의 모델에 따라 사용량을 기록합니다.

대상 – 자율 LLM 에이전트, RAG 파이프라인 또는 각 API를 하드코딩하지 않고 많은 타사 API를 호출해야 하는 시스템을 구축하는 개발자. 선언적 커넥터 형식은 코딩 에이전트가 새 커넥터를 자동으로 생성할 수 있게 합니다(AGENT.md 참조).

라이선스 – MIT.