AgentCard.net APIBeta boyunca ücretsiz

Agent Card araçları, yazılım için üretildi.

Uygulamanızdan, CI işlem hattınızdan, geliştirici aracınızdan veya otonom Agent’tan A2A v1.0 Agent Card oluşturun, doğrulayın ve inceleyin.

cURL ile başlayınOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · Hızlı başlangıç

İlk isteğinizi gönderin.

JSON’u HTTPS üzerinden gönderin. Beta süresince hesap veya API Key gerekmez. Bu örnek tek çağrıda eksiksiz bir Agent Card oluşturur ve doğrular.

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’ler

Üç odaklanmış işlem.

Normal uygulamalarda ayrı REST endpoint’lerini, çağıran başka bir Agent ise birleşik beceri endpoint’ini kullanın.

POST

Agent Card oluştur

/api/agent-card/generate

Hizmet ayrıntılarını yayımlanabilir A2A v1.0 JSON’a dönüştürür ve aynı yanıtta doğrulama raporu verir.

Örneği gör
POST

Agent Card JSON doğrula

/api/agent-card/validate

Kimlik, arayüzler, yetenekler, modlar, beceriler, güvenlik meta verileri, eski alanlar ve gömülü sırları denetler.

Örneği gör
POST

Uzak keşfi denetle

/api/agent-card/check

Her iki well-known keşif yolunu inceler ve uzak ana makinenin döndürdüğü tüm Agent Card’ları doğrular.

Örneği gör
POST/generate

Agent Card oluştur

Hizmet ayrıntılarını yayımlanabilir A2A v1.0 JSON’a dönüştürür ve aynı yanıtta doğrulama raporu verir.

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 doğrula

Kimlik, arayüzler, yetenekler, modlar, beceriler, güvenlik meta verileri, eski alanlar ve gömülü sırları denetler.

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

Uzak keşfi denetle

Her iki well-known keşif yolunu inceler ve uzak ana makinenin döndürdüğü tüm Agent Card’ları doğrular.

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 entegrasyonu

Bir Agent’ın API’yi keşfedip çağırmasını sağlayın.

AgentCard.net birbirini tamamlayan keşif biçimleri yayımlar. Agent önce yetenekleri inceleyip sonra tek bir kararlı endpoint üzerinden beceri çağırabilir.

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

04 · Yanıtlar

Kararlar için yapılandırıldı.

Doğrulama; engelleyici hataları, yararlı uyarıları ve başarılı kontrolleri ayırır; yazılım metin ayrıştırmadan karar verebilir.

errorsvalid değerini false yapar

warningshazırlık eksiklerini gösterir

passesbaşarılı kontrolleri onaylar

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

05 · Sınırlar

Herkese açık API için güvenli varsayılanlar.

256 KB yük sınırı

Gelen JSON ve her uzak yanıt gövdesine uygulanır.

8 saniye zaman aşımı

Ana makine kullanılamıyorsa uzak istekler hızla durur.

Ağ açısından güvenli kontroller

Özel adresler ve güvenli olmayan yönlendirmeler reddedilir.

Beta sırasında API Key yok

API şu anda IP başına best-effort hız sınırıyla açıktır.

Uzak kontroller yalnızca herkese açık HTTP veya HTTPS ana makinelerini kabul eder.

Özel ve ayrılmış IP aralıkları engellenir; her yönlendirme denetlenir, yanıt boyutu sınırlanır ve hatalar yol bazında döndürülür.

06 · Para kazanma

Şimdi ücretsiz beta, sonra kullanıma dayalı erişim.

API şu anda ödeme veya API Key gerektirmez. AgentCard.net, keşif belgelerini açık tutarken seçili yoğun işlemlerde Cloudflare Monetization Gateway üzerinden x402 kullanmayı planlıyor.

OpenAPI JSONWeb araçlarını deneyin
Agent Card şemasıAgent Card örnekleriWell-known URL kılavuzu