AgentCard.net APIGratis durante la beta

Herramientas Agent Card, creadas para software.

Genera, valida e inspecciona Agent Cards A2A v1.0 desde tu aplicación, canalización CI, herramienta de desarrollo o agente autónomo.

Empezar 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 · Inicio rápido

Haz tu primera solicitud.

Envía JSON por HTTPS. Durante la beta no necesitas cuenta ni API Key. Este ejemplo genera una Agent Card completa y la valida en una sola llamada.

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

Tres operaciones específicas.

Usa los endpoints REST individuales en aplicaciones normales o el endpoint unificado de habilidades cuando quien llama es otro agente.

POST

Generar una Agent Card

/api/agent-card/generate

Convierte los datos del servicio en JSON A2A v1.0 publicable y recibe un informe de validación en la misma respuesta.

Ver ejemplo
POST

Validar JSON de Agent Card

/api/agent-card/validate

Comprueba identidad, interfaces, capacidades, modos, habilidades, metadatos de seguridad, campos antiguos y secretos incrustados.

Ver ejemplo
POST

Comprobar el descubrimiento remoto

/api/agent-card/check

Inspecciona ambas rutas well-known y valida cada Agent Card devuelta por el host remoto.

Ver ejemplo
POST/generate

Generar una Agent Card

Convierte los datos del servicio en JSON A2A v1.0 publicable y recibe un informe de validación en la misma respuesta.

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

Validar JSON de Agent Card

Comprueba identidad, interfaces, capacidades, modos, habilidades, metadatos de seguridad, campos antiguos y secretos incrustados.

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

Comprobar el descubrimiento remoto

Inspecciona ambas rutas well-known y valida cada Agent Card devuelta por el 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 · Integración de agentes

Permite que un agente descubra y llame a la API.

AgentCard.net publica formatos de descubrimiento complementarios. Un agente puede inspeccionar primero las capacidades e invocar después una habilidad mediante un endpoint estable.

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

04 · Respuestas

Estructurado para tomar decisiones.

La validación separa errores bloqueantes, advertencias útiles y comprobaciones correctas para que el software decida sin analizar prosa.

errorshace que valid sea false

warningsseñala carencias de preparación

passesconfirma comprobaciones superadas

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

05 · Límites

Valores seguros para una API pública.

Límite de carga de 256 KB

Se aplica al JSON entrante y a cada cuerpo de respuesta remoto.

Tiempo límite de 8 segundos

Las solicitudes remotas se detienen pronto si el host no está disponible.

Comprobaciones de red seguras

Se rechazan direcciones privadas y redirecciones inseguras.

Sin API Key durante la beta

La API está abierta con un límite aproximado por IP.

Las comprobaciones remotas solo aceptan hosts HTTP o HTTPS públicos.

Se bloquean rangos IP privados y reservados; se revisa cada redirección, se limita el tamaño de respuesta y los fallos se devuelven por ruta.

06 · Monetización

Beta gratuita ahora; acceso por uso después.

La API no requiere pago ni API Key actualmente. AgentCard.net planea usar x402 mediante Cloudflare Monetization Gateway para operaciones seleccionadas, manteniendo pública la documentación de descubrimiento.

OpenAPI JSONProbar herramientas web
Esquema Agent CardEjemplos de Agent CardGuía de URL well-known