AgentCard.net APIWährend der Beta kostenlos

Agent-Card-Werkzeuge, für Software gebaut.

Erstellen, validieren und prüfen Sie A2A-v1.0-Agent-Cards aus Ihrer Anwendung, CI-Pipeline, Ihrem Entwicklertool oder autonomen Agenten.

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

01 · Schnellstart

Senden Sie Ihre erste Anfrage.

Senden Sie JSON über HTTPS. Während der Beta sind weder Konto noch API Key nötig. Dieses Beispiel erstellt und validiert eine vollständige Agent Card in einem Aufruf.

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

Drei gezielte Operationen.

Nutzen Sie einzelne REST-Endpunkte in normalen Anwendungen oder den einheitlichen Skill-Endpunkt, wenn ein anderer Agent aufruft.

POST

Agent Card erstellen

/api/agent-card/generate

Wandeln Sie Servicedaten in veröffentlichbares A2A-v1.0-JSON um und erhalten Sie den Validierungsbericht in derselben Antwort.

Beispiel ansehen
POST

Agent-Card-JSON validieren

/api/agent-card/validate

Prüft Identität, Schnittstellen, Fähigkeiten, Modi, Skills, Sicherheitsmetadaten, alte Felder und eingebettete Geheimnisse.

Beispiel ansehen
POST

Remote Discovery prüfen

/api/agent-card/check

Prüft beide well-known-Pfade und validiert jede vom entfernten Host gelieferte Agent Card.

Beispiel ansehen
POST/generate

Agent Card erstellen

Wandeln Sie Servicedaten in veröffentlichbares A2A-v1.0-JSON um und erhalten Sie den Validierungsbericht in derselben Antwort.

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 validieren

Prüft Identität, Schnittstellen, Fähigkeiten, Modi, Skills, Sicherheitsmetadaten, alte Felder und eingebettete Geheimnisse.

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

Remote Discovery prüfen

Prüft beide well-known-Pfade und validiert jede vom entfernten Host gelieferte Agent Card.

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-Integration

Lassen Sie einen Agenten die API finden und aufrufen.

AgentCard.net veröffentlicht ergänzende Discovery-Formate. Ein Agent kann zuerst Fähigkeiten prüfen und dann einen Skill über einen stabilen Endpunkt aufrufen.

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

04 · Antworten

Für Entscheidungen strukturiert.

Die Validierung trennt blockierende Fehler, hilfreiche Warnungen und erfolgreiche Prüfungen, damit Software ohne Textanalyse entscheiden kann.

errorssetzt valid auf false

warningszeigt Bereitschaftslücken

passesbestätigt erfolgreiche Prüfungen

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

05 · Limits

Sichere Vorgaben für eine öffentliche API.

256-KB-Payload-Limit

Gilt für eingehendes JSON und jede Remote-Antwort.

8 Sekunden Timeout

Remote-Anfragen enden schnell, wenn ein Host nicht verfügbar ist.

Netzwerksichere Prüfungen

Private Adressen und unsichere Weiterleitungen werden abgelehnt.

Kein API Key in der Beta

Die API ist derzeit offen und begrenzt Anfragen bestmöglich pro IP.

Remote-Prüfungen akzeptieren nur öffentliche HTTP- oder HTTPS-Hosts.

Private und reservierte IP-Bereiche werden blockiert; jedes Weiterleitungsziel wird geprüft, Antwortgrößen sind begrenzt und Fehler werden je Pfad zurückgegeben.

06 · Monetarisierung

Jetzt kostenlose Beta, später nutzungsbasierter Zugang.

Derzeit sind weder Zahlung noch API Key erforderlich. AgentCard.net plant x402 über Cloudflare Monetization Gateway für ausgewählte rechenintensive Operationen, während Discovery-Dokumentation öffentlich bleibt.

OpenAPI JSONWebtools testen
Agent-Card-SchemaAgent-Card-BeispieleWell-known-URL-Leitfaden