AgentCard.net APIGratuit pendant la bêta

Les outils Agent Card, conçus pour le logiciel.

Générez, validez et inspectez des Agent Cards A2A v1.0 depuis votre application, pipeline CI, outil de développement ou agent autonome.

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

01 · Démarrage rapide

Effectuez votre première requête.

Envoyez du JSON via HTTPS. Pendant la bêta, aucun compte ni API Key n’est requis. Cet exemple génère et valide une Agent Card complète en un seul appel.

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

Trois opérations ciblées.

Utilisez les endpoints REST individuels dans les applications classiques, ou l’endpoint de compétence unifié lorsque l’appelant est un autre agent.

POST

Générer une Agent Card

/api/agent-card/generate

Transformez les informations du service en JSON A2A v1.0 publiable et recevez un rapport de validation dans la même réponse.

Voir l’exemple
POST

Valider le JSON Agent Card

/api/agent-card/validate

Vérifiez l’identité, les interfaces, capacités, modes, compétences, métadonnées de sécurité, anciens champs et secrets intégrés.

Voir l’exemple
POST

Vérifier la découverte distante

/api/agent-card/check

Inspectez les deux chemins well-known et validez chaque Agent Card renvoyée par l’hôte distant.

Voir l’exemple
POST/generate

Générer une Agent Card

Transformez les informations du service en JSON A2A v1.0 publiable et recevez un rapport de validation dans la même réponse.

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

Valider le JSON Agent Card

Vérifiez l’identité, les interfaces, capacités, modes, compétences, métadonnées de sécurité, anciens champs et secrets intégrés.

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

Vérifier la découverte distante

Inspectez les deux chemins well-known et validez chaque Agent Card renvoyée par l’hôte distant.

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 · Intégration agent

Permettez à un agent de découvrir et d’appeler l’API.

AgentCard.net publie des formats de découverte complémentaires. Un agent peut d’abord examiner les capacités, puis invoquer une compétence via un endpoint stable.

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

04 · Réponses

Structuré pour décider.

La validation sépare erreurs bloquantes, avertissements utiles et contrôles réussis afin que le logiciel décide sans analyser de prose.

errorsrend valid égal à false

warningssignale les lacunes de préparation

passesconfirme les contrôles réussis

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

05 · Limites

Des valeurs sûres pour une API publique.

Limite de charge de 256 Ko

Appliquée au JSON entrant et à chaque réponse distante.

Délai de 8 secondes

Les requêtes distantes s’arrêtent rapidement si l’hôte est indisponible.

Contrôles réseau sécurisés

Les adresses privées et redirections dangereuses sont rejetées.

Pas d’API Key pendant la bêta

L’API est ouverte avec une limitation approximative par IP.

Les contrôles distants n’acceptent que les hôtes HTTP ou HTTPS publics.

Les plages IP privées et réservées sont bloquées ; chaque redirection est contrôlée, la taille des réponses est limitée et les erreurs sont renvoyées par chemin.

06 · Monétisation

Bêta gratuite maintenant, accès à l’usage ensuite.

L’API ne nécessite actuellement ni paiement ni API Key. AgentCard.net prévoit d’utiliser x402 via Cloudflare Monetization Gateway pour certaines opérations tout en gardant la documentation de découverte publique.

OpenAPI JSONEssayer les outils web
Schéma Agent CardExemples Agent CardGuide des URL well-known