AgentCard.net APIGratis durante la beta

Strumenti Agent Card, creati per il software.

Genera, convalida e ispeziona Agent Card A2A v1.0 dalla tua applicazione, pipeline CI, strumento di sviluppo o agente autonomo.

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

01 · Avvio rapido

Effettua la prima richiesta.

Invia JSON tramite HTTPS. Durante la beta non servono account o API Key. Questo esempio genera e convalida una Agent Card completa in una sola chiamata.

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

Tre operazioni mirate.

Usa i singoli endpoint REST nelle normali applicazioni oppure l’endpoint unificato delle skill quando il chiamante è un altro agente.

POST

Genera una Agent Card

/api/agent-card/generate

Trasforma i dettagli del servizio in JSON A2A v1.0 pubblicabile e ricevi un rapporto di convalida nella stessa risposta.

Vedi esempio
POST

Convalida il JSON Agent Card

/api/agent-card/validate

Controlla identità, interfacce, capacità, modalità, skill, metadati di sicurezza, campi obsoleti e segreti incorporati.

Vedi esempio
POST

Controlla il discovery remoto

/api/agent-card/check

Ispeziona entrambi i percorsi well-known e convalida ogni Agent Card restituita dall’host remoto.

Vedi esempio
POST/generate

Genera una Agent Card

Trasforma i dettagli del servizio in JSON A2A v1.0 pubblicabile e ricevi un rapporto di convalida nella stessa risposta.

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

Convalida il JSON Agent Card

Controlla identità, interfacce, capacità, modalità, skill, metadati di sicurezza, campi obsoleti e segreti incorporati.

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

Controlla il discovery remoto

Ispeziona entrambi i percorsi well-known e convalida ogni Agent Card restituita dall’host remoto.

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 · Integrazione agenti

Consenti a un agente di scoprire e chiamare l’API.

AgentCard.net pubblica formati di discovery complementari. Un agente può prima ispezionare le capacità e poi invocare una skill tramite un endpoint stabile.

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

04 · Risposte

Strutturato per le decisioni.

La convalida separa errori bloccanti, avvisi utili e controlli riusciti, così il software decide senza analizzare testo libero.

errorsimposta valid su false

warningssegnala lacune di preparazione

passesconferma i controlli superati

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

05 · Limiti

Impostazioni sicure per un’API pubblica.

Limite payload di 256 KB

Applicato al JSON in ingresso e a ogni risposta remota.

Timeout di 8 secondi

Le richieste remote terminano rapidamente se un host non è disponibile.

Controlli di rete sicuri

Indirizzi privati e redirect non sicuri vengono rifiutati.

Nessuna API Key in beta

L’API è aperta con un limite per IP applicato al meglio.

I controlli remoti accettano solo host HTTP o HTTPS pubblici.

Gli intervalli IP privati e riservati sono bloccati; ogni redirect viene controllato, le risposte sono limitate e gli errori vengono restituiti per percorso.

06 · Monetizzazione

Beta gratuita ora, accesso a consumo in seguito.

Attualmente l’API non richiede pagamento né API Key. AgentCard.net prevede di usare x402 tramite Cloudflare Monetization Gateway per operazioni selezionate, mantenendo pubblica la documentazione di discovery.

OpenAPI JSONProva gli strumenti web
Schema Agent CardEsempi Agent CardGuida URL well-known