AgentCard.net API베타 기간 무료

Agent Card 도구, 소프트웨어를 위해 설계했습니다.

애플리케이션, CI 파이프라인, 개발 도구 또는 자율 Agent에서 A2A v1.0 Agent Card를 생성하고 검증하며 점검하세요.

cURL로 시작OpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · 빠른 시작

첫 요청을 보내세요.

HTTPS로 JSON을 전송합니다. 베타 기간에는 계정이나 API Key가 필요 없습니다. 이 예제는 한 번의 호출로 완전한 Agent Card를 생성하고 검증합니다.

Base URLhttps://www.agentcard.net
cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'

02 · 엔드포인트

세 가지 핵심 작업.

일반 애플리케이션에서는 개별 REST 엔드포인트를, 다른 Agent가 호출할 때는 통합 스킬 엔드포인트를 사용하세요.

POST

Agent Card 생성

/api/agent-card/generate

서비스 정보를 게시 가능한 A2A v1.0 JSON으로 변환하고 같은 응답에서 검증 보고서를 받습니다.

예제 보기
POST

Agent Card JSON 검증

/api/agent-card/validate

ID, 인터페이스, 기능, 모드, 스킬, 보안 메타데이터, 레거시 필드 및 포함된 비밀을 확인합니다.

예제 보기
POST

원격 검색 확인

/api/agent-card/check

두 well-known 검색 경로를 확인하고 원격 호스트가 반환하는 모든 Agent Card를 검증합니다.

예제 보기
POST/generate

Agent Card 생성

서비스 정보를 게시 가능한 A2A v1.0 JSON으로 변환하고 같은 응답에서 검증 보고서를 받습니다.

cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'
POST/validate

Agent Card JSON 검증

ID, 인터페이스, 기능, 모드, 스킬, 보안 메타데이터, 레거시 필드 및 포함된 비밀을 확인합니다.

cURL · validate
curl -X POST https://www.agentcard.net/api/agent-card/validate \
  -H "Content-Type: application/json" \
  -d '{
    "card": {
      "name": "Research Agent",
      "description": "Finds and summarizes public research.",
      "version": "1.0.0",
      "supportedInterfaces": [{
        "url": "https://api.example.com/a2a/research",
        "protocolBinding": "HTTP+JSON",
        "protocolVersion": "1.0"
      }],
      "capabilities": {},
      "defaultInputModes": ["text/plain"],
      "defaultOutputModes": ["application/json"],
      "skills": [{
        "id": "research",
        "name": "Research",
        "description": "Finds relevant sources and returns a cited summary.",
        "tags": ["research"]
      }]
    }
  }'
POST/check

원격 검색 확인

두 well-known 검색 경로를 확인하고 원격 호스트가 반환하는 모든 Agent Card를 검증합니다.

cURL · remote check
curl -X POST https://www.agentcard.net/api/agent-card/check \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

03 · Agent 통합

Agent가 API를 검색하고 호출하게 하세요.

AgentCard.net은 상호 보완적인 검색 형식을 제공합니다. Agent는 기능을 먼저 확인한 뒤 안정적인 단일 엔드포인트로 스킬을 호출할 수 있습니다.

POST /api/agent-card
{
  "skillId": "validate-agent-card",
  "input": {
    "card": {
      "name": "Example Agent",
      "description": "..."
    }
  }
}

04 · 응답

의사결정에 적합한 구조.

검증은 차단 오류, 유용한 경고, 성공한 검사를 분리하므로 소프트웨어가 문장을 분석하지 않고 결정할 수 있습니다.

errorsvalid를 false로 설정

warnings준비 상태의 부족함 표시

passes완료된 검사 확인

JSON response
{
  "validation": {
    "valid": false,
    "errors": [
      {
        "severity": "error",
        "message": "Missing required field: version."
      }
    ],
    "warnings": [],
    "passes": [
      {
        "severity": "pass",
        "message": "Agent name is present."
      }
    ]
  }
}

05 · 제한

공개 API를 위한 안전한 기본값.

256 KB 페이로드 제한

수신 JSON과 각 원격 응답 본문에 적용됩니다.

8초 타임아웃

호스트를 사용할 수 없으면 원격 요청을 빠르게 중단합니다.

안전한 네트워크 검사

사설 주소와 안전하지 않은 리디렉션을 거부합니다.

베타 중 API Key 불필요

현재 API는 공개되어 있으며 IP별 최선형 속도 제한이 적용됩니다.

원격 검사는 공개 HTTP 또는 HTTPS 호스트만 허용합니다.

사설 및 예약 IP 범위를 차단하고 모든 리디렉션 목적지를 검사하며 응답 크기를 제한하고 경로별로 오류를 반환합니다.

06 · 수익화

지금은 무료 베타, 이후 사용량 기반 접근.

현재 결제나 API Key가 필요 없습니다. AgentCard.net은 검색 문서를 공개로 유지하면서 일부 리소스 집약적 작업에 Cloudflare Monetization Gateway의 x402를 사용할 예정입니다.

OpenAPI JSON웹 도구 사용해 보기
Agent Card 스키마Agent Card 예제well-known URL 가이드