AgentCard.net APIPercuma semasa beta

Peralatan Agent Card, dibina untuk perisian.

Jana, sahkan dan periksa Agent Card A2A v1.0 daripada aplikasi, saluran CI, alat pembangun atau Agent autonomi anda.

Mulakan 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 · Mula pantas

Hantar permintaan pertama anda.

Hantar JSON melalui HTTPS. Semasa beta, akaun atau API Key tidak diperlukan. Contoh ini menjana dan mengesahkan 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 berfokus.

Gunakan endpoint REST berasingan dalam aplikasi biasa atau endpoint kemahiran bersepadu apabila pemanggil ialah Agent lain.

POST

Jana Agent Card

/api/agent-card/generate

Tukar butiran perkhidmatan kepada JSON A2A v1.0 yang boleh diterbitkan dan terima laporan pengesahan dalam respons yang sama.

Lihat contoh
POST

Sahkan JSON Agent Card

/api/agent-card/validate

Semak identiti, antara muka, keupayaan, mod, kemahiran, metadata keselamatan, medan lama dan rahsia terbenam.

Lihat contoh
POST

Semak penemuan jauh

/api/agent-card/check

Periksa kedua-dua laluan well-known dan sahkan setiap Agent Card daripada hos jauh.

Lihat contoh
POST/generate

Jana Agent Card

Tukar butiran perkhidmatan kepada JSON A2A v1.0 yang boleh diterbitkan dan terima laporan pengesahan 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

Sahkan JSON Agent Card

Semak identiti, antara muka, keupayaan, mod, kemahiran, metadata keselamatan, medan lama dan rahsia terbenam.

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

Semak penemuan jauh

Periksa kedua-dua laluan well-known dan sahkan setiap Agent Card daripada hos 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

Benarkan Agent menemui dan memanggil API.

AgentCard.net menerbitkan format penemuan yang saling melengkapi. Agent boleh memeriksa keupayaan dahulu lalu memanggil kemahiran melalui satu endpoint stabil.

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

04 · Respons

Berstruktur untuk keputusan.

Pengesahan memisahkan ralat penghalang, amaran berguna dan semakan berjaya agar perisian boleh membuat keputusan tanpa menghuraikan prosa.

errorsmenjadikan valid sebagai false

warningsmenunjukkan jurang kesediaan

passesmengesahkan semakan berjaya

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

05 · Had

Tetapan selamat untuk API awam.

Had payload 256 KB

Digunakan pada JSON masuk dan setiap respons jauh.

Tamat masa 8 saat

Permintaan jauh berhenti cepat apabila hos tidak tersedia.

Semakan rangkaian selamat

Alamat peribadi dan ubah hala tidak selamat ditolak.

Tiada API Key semasa beta

API kini terbuka dengan had best-effort bagi setiap IP.

Semakan jauh hanya menerima hos HTTP atau HTTPS awam.

Julat IP peribadi dan dikhaskan disekat; setiap ubah hala diperiksa, saiz respons dihadkan dan kegagalan dikembalikan mengikut laluan.

06 · Pengewangan

Beta percuma sekarang, akses berasaskan penggunaan kemudian.

API kini tidak memerlukan bayaran atau API Key. AgentCard.net merancang menggunakan x402 melalui Cloudflare Monetization Gateway untuk operasi terpilih sambil mengekalkan dokumentasi penemuan terbuka.

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