AgentCard.net APIGratis selama beta

Peralatan Agent Card, dibuat untuk perangkat lunak.

Buat, validasi, dan periksa Agent Card A2A v1.0 dari aplikasi, pipeline CI, alat pengembang, atau Agent otonom Anda.

Mulai dengan cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Mulai cepat

Kirim permintaan pertama Anda.

Kirim JSON melalui HTTPS. Selama beta, Anda tidak memerlukan akun atau API Key. Contoh ini membuat dan memvalidasi Agent Card lengkap dalam satu panggilan.

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 · Endpoint

Tiga operasi terfokus.

Gunakan endpoint REST terpisah dalam aplikasi biasa, atau endpoint skill terpadu saat pemanggilnya adalah Agent lain.

POST

Buat Agent Card

/api/agent-card/generate

Ubah detail layanan menjadi JSON A2A v1.0 yang siap diterbitkan dan terima laporan validasi dalam respons yang sama.

Lihat contoh
POST

Validasi JSON Agent Card

/api/agent-card/validate

Periksa identitas, antarmuka, kemampuan, mode, skill, metadata keamanan, bidang lama, dan rahasia tertanam.

Lihat contoh
POST

Periksa discovery jarak jauh

/api/agent-card/check

Periksa kedua jalur well-known dan validasi setiap Agent Card dari host jarak jauh.

Lihat contoh
POST/generate

Buat Agent Card

Ubah detail layanan menjadi JSON A2A v1.0 yang siap diterbitkan dan terima laporan validasi dalam respons yang sama.

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

Validasi JSON Agent Card

Periksa identitas, antarmuka, kemampuan, mode, skill, metadata keamanan, bidang lama, dan rahasia tertanam.

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

Periksa discovery jarak jauh

Periksa kedua jalur well-known dan validasi setiap Agent Card dari host jarak jauh.

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 · Integrasi Agent

Biarkan Agent menemukan dan memanggil API.

AgentCard.net menerbitkan format discovery yang saling melengkapi. Agent dapat memeriksa kemampuan terlebih dahulu lalu memanggil skill melalui satu endpoint stabil.

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

04 · Respons

Terstruktur untuk keputusan.

Validasi memisahkan error penghalang, peringatan berguna, dan pemeriksaan berhasil agar perangkat lunak dapat memutuskan tanpa mengurai prosa.

errorsmembuat valid menjadi false

warningsmenunjukkan kekurangan kesiapan

passesmengonfirmasi pemeriksaan berhasil

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

05 · Batas

Nilai aman untuk API publik.

Batas payload 256 KB

Berlaku untuk JSON masuk dan setiap respons jarak jauh.

Timeout 8 detik

Permintaan jarak jauh berhenti cepat saat host tidak tersedia.

Pemeriksaan jaringan aman

Alamat privat dan pengalihan tidak aman ditolak.

Tanpa API Key selama beta

API saat ini terbuka dengan pembatasan best-effort per IP.

Pemeriksaan jarak jauh hanya menerima host HTTP atau HTTPS publik.

Rentang IP privat dan cadangan diblokir; setiap pengalihan diperiksa, ukuran respons dibatasi, dan kegagalan dikembalikan per jalur.

06 · Monetisasi

Beta gratis sekarang, akses berbasis penggunaan nanti.

API saat ini tidak memerlukan pembayaran atau API Key. AgentCard.net berencana memakai x402 melalui Cloudflare Monetization Gateway untuk operasi tertentu sambil menjaga dokumentasi discovery tetap publik.

OpenAPI JSONCoba alat web
Skema Agent CardContoh Agent CardPanduan URL well-known