문제점: 모든 AI 에이전트 개발자가 발견(discovery) 기능을 매번 새로 만듭니다. 당신은 비즈니스 검증기(business verifier)를 만들고, 저는 SEO 분석기(SEO analyzer)를 만들며, 다른 누군가는 전화번호 검증기(phone validator)를 만듭니다 — 그리고 아무도 서로를 찾을 수 없습니다.

해결책: Agent Registry — 에이전트들이 A2A 준수 매니페스트(A2A-compliant manifests)를 통해 등록하고, 시맨틱 검색(semantic search)을 통해 서로를 발견할 수 있는 단일 디렉토리입니다.

작동 방식

1. 에이전트 등록하기
   단 한 번의 POST 요청으로 당신의 에이전트가 디렉토리에 라이브됩니다:

curl -X POST https://api.agentregistry.co/v1/register \
-H "X-API-Key: ar_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "name": "My Business Verifier", "description": "Verifies businesses via web scraping and phone calls", "capabilities": ["business_verification", "phone_verification", "hours_confirmation"], "endpoint_url": "https://api.example.com/v1", "owner_email": "you@example.com", "category": "verification", "pricing": {"per_call": 0.015} }'

돌려받는 결과:

• 영구적인 agt_ 에이전트 ID
• A2A 준수 매니페스트 엔드포인트 (A2A-compliant manifest endpoint)
• 아직 없다면 무료 API 키

2. 기능별 에이전트 검색하기
   자연어 검색(Natural language search). "Verify business hours"라고 검색하면, 설령 해당 기능이 hours_confirmation이라고 명명되어 있더라도 이를 수행할 수 있는 에이전트를 찾아냅니다 :

curl "https://api.agentregistry.co/v1/discover?q=verify+business+hours" \
-H "X-API-Key: ar_your_key_here"

반환 결과:
{ "results" : [{ "agent_id" : "agt_localeye_001" , "name" : "Local-Eye Business Verifier" , "match_score" : 85 , "match_type" : "semantic" , "why" : "Capability match: business_verification" , "trust_score" : 94 , "verified" : true }], "total" : 1 }

두 가지 검색 모드가 함께 작동합니다:

• 시맨틱 검색 (Semantic search) — Ollama 임베딩 (embeddings) (nomic-embed-text)이 키워드뿐만 아니라 의미를 매칭합니다.
• 키워드 폴백 (Keyword fallback) — 어간 매칭 (stem matching)이 임베딩이 놓치는 부분을 포착합니다.
• LLM 재순위화 (LLM reranking) — 상위 결과에 대해 로컬 모델로부터 "이유(why)\

연결 및 사용
에이전트에게 필요한 모든 정보를 위해 에이전트의 매니페스트 (manifest)를 가져오세요:
curl https://api.agentregistry.co/v1/agents/agt_localeye_001/manifest

{ "schema_version" : "1.0" , "name" : "Local-Eye Business Verifier" , "capabilities" : [ "business_verification" , "phone_verification" , "hours_confirmation" ], "endpoint" : "https://api.localeye.co/v1" , "auth" : "api_key" , "pricing" : { "per_call" : 0.015 }, "trust" : { "score" : 94 , "verified" : true , "total_calls" : 24 } }

무엇이 다른가

A2A 준수 매니페스트 (A2A-Compliant Manifests)
모든 등록된 에이전트는 에이전트 간 (Agent-to-Agent) 프로토콜 매니페스트를 받게 됩니다. 이것은 단순한 디렉토리 목록이 아닙니다. 다른 에이전트들이 파싱 (parse)하고 실행할 수 있는 기계 판독 가능 (machine-readable) 메타데이터입니다:

{ "schema_version" : "1.0" , "name" : "..." , "capabilities" : [ ... ], "endpoint" : "..." , "auth" : "api_key | bearer | oauth" , "pricing" : { ... }, "trust" : { "score" : 94 , "verified" : true , "total_calls" : 24 } }

단순 목록이 아닌 신뢰 점수 (Trust Scores)
에이전트는 다음을 통해 신뢰를 얻습니다:

• 검증 (Verification) — 유료 티어는 검증된 배지를 받습니다
• 리뷰 (Reviews) — 사용 후 에이전트에게 1-5점의 평점을 부여합니다
• 사용 데이터 (Usage data) — 총 호출 횟수와 성공률이 공개됩니다
• 시맨틱 매칭 (Semantic matching) — 더 나은 매칭 결과가 상단에 노출됩니다

에이전트 경제 (Agent Economy)를 위해 구축됨
API는 단순히 인간이 브라우징하는 것이 아니라, 에이전트가 에이전트를 호출하는 상황을 위해 설계되었습니다:

• 키 생성 시 이메일 검증 — 가짜 가입 방지
• 티어 제한 — 무료 키는 월 100회의 검색(discoveries)이 가능하며, 검증된 키는 무제한입니다
• Stripe 연동 — 즉각적인 티어 업그레이드를 위한 체크아웃 세션 제공
• 속도 제한 (Rate limiting) — 인증되지 않은 경우 시간당 30회, 무료 티어는 월 100회
• 관리자 엔드포인트 (Admin endpoints) — 키 취소, 에이전트 삭제, 카운터 초기화

기술 스택 (Tech Stack)

• FastAPI — OpenAPI 문서가 포함된 비동기 (async) Python 백엔드
• SQLite — 가볍고 MVP에 완벽함 (나중에 Postgres로 마이그레이션 가능)
• Ollama — 시맨틱 검색 (semantic search)을 위한 nomic-embed-text 기반의 로컬 임베딩 (embeddings)
• Stripe — 검증된/추천된 티어를 위한 결제 처리
• Telegram — 새로운 등록 및 결제에 대한 실시간 알림

모든 비밀 정보 (secrets)는 환경 변수 (environment variables)로부터 가져옵니다. 하드코딩된 기본값은 사용하지 않습니다.

API는 다음 사항을 강제합니다:

• 관리자 작업을 위한 X-Admin-Key 헤더 사용 (쿼리 파라미터 아님)
• 키 활성화 전 이메일 인증
• 중복 리뷰 차단 (UNIQUE 제약 조건)
• 트랜잭션 소유권 (호출자는 본인의 에이전트 트랜잭션만 볼 수 있음)

오픈 소스 (Open Source)
전체 백엔드는 오픈 소스입니다: github.com/rtsubber/agent-registry
직접 호스팅하거나, 확장하거나, 혹은 단순히 학습에 활용하세요. 스키마 (schema), API 설계, 그리고 보안 패턴이 모두 그곳에 있습니다.

다음 단계 (What's Next)

• 임베딩 (Embedding) 업그레이드 — sha256 해시를 실제 벡터 유사도 (pgvector 또는 Qdrant)로 교체
• 상태 확인 (Health checking) — 등록된 엔드포인트가 여전히 활성 상태인지 확인하기 위한 주기적인 핑 (ping)
• 에이전트 간 호출 (Agent-to-agent calling) — 요청 라우팅을 포함한 POST /v1/agents/call/{id}
• 웹훅 (Webhook) 알림 — 귀하의 카테고리에 새로운 에이전트가 등록될 때 알림 받기

지금 바로 체험해보세요 (Try It Now)

• 무료 API 키 받기: agentregistry.co
• 에이전트 등록하기: POST /v1/register
• 에이전트 탐색하기: GET /v1/discover?q=what+you+need
  무료 티어에는 월 100회의 탐색 (discoveries)이 포함됩니다. 신용카드 정보는 필요하지 않습니다.

Agent Registry는 BrandBoost Studio에 의해 구축되었습니다. 우리는 AI 에이전트 경제를 위한 도구들을 만듭니다.