Agent Card: Visitenkarte eines KI-Agenten im A2A-Protokoll

Eine Agent Card ist ein JSON-Dokument, mit dem ein KI-Agent im Agent2Agent-Protokoll (A2A) beschreibt, wer er ist, was er kann und wie andere Agenten ihn erreichen. Andere Agenten lesen die Karte, bevor sie ihm eine Aufgabe übergeben.

Auf einen Blick

Art: JSON-Dokument (Datei) im Agent2Agent-Protokoll
Genutzt in: A2A; Google Cloud Marketplace für KI-Agenten
Standardpfad: /.well-known/agent-card.json
Sichtbar?: öffentlich abrufbar, erweiterte Karte erst nach Anmeldung
Doku: A2A Protocol Specification

Stand: 8. Oktober 2026

Was steht in einer Agent Card?

Die A2A-Spezifikation nennt die Agent Card ein selbstbeschreibendes Manifest. Pflicht sind unter anderem Name, Beschreibung, Version, die unterstützten Schnittstellen (supportedInterfaces), die Fähigkeiten (capabilities), die Standardformate für Ein- und Ausgabe sowie die Liste der Skills. Optional kommen Anbieter, Dokumentations-URL, Sicherheitsschemata und Signaturen hinzu.

Gefunden wird die Karte meist über einen festen Pfad. Die Spezifikation sieht dafür https://{domain}/.well-known/agent-card.json vor. Daneben nennt sie Verzeichnisse von Agenten und die direkte Konfiguration. Karten lassen sich mit JSON Web Signatures signieren. Wer mehr preisgeben will als öffentlich, kann eine erweiterte Karte anbieten, die erst nach Anmeldung abrufbar ist.

Auch Plattformen nutzen das Format. Im Google Cloud Marketplace beschreibt die Agent Card einen angebotenen Agenten und muss vor der Veröffentlichung validiert werden.

Landkarte der Agenten-Protokolle, Stand 08.10.2026: Welche Verbindung jedes Protokoll regelt, wer es herausgibt und welchen Status es hat. Im Handel überschneiden sich ACP, UCP und AP2, und mehrere Protokolle bauen auf MCP oder A2A auf. Versionen ändern sich schnell. Quellen: Model Context Protocol: Spezifikation 2026-07-28; A2A Protocol: Spezifikation (Agent Card, Beziehung zu MCP); W3C Web Machine Learning CG: WebMCP (Draft Community Group Report); NLWeb (GitHub, Microsoft); Agentic Commerce Protocol (GitHub, OpenAI und Stripe); Universal Commerce Protocol: Specification overview; AP2: Agent Payments Protocol.

Beispiel

JSON

{
  "name": "Rezept-Agent",
  "description": "Findet Rezepte zu vorhandenen Zutaten.",
  "version": "1.0.0",
  "supportedInterfaces": [
    { "url": "https://agent.example.com/a2a", "protocolBinding": "JSONRPC", "protocolVersion": "1.0" }
  ],
  "capabilities": { "streaming": true },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    { "id": "rezept-suche", "name": "Rezeptsuche", "description": "Sucht Rezepte nach Zutaten.", "tags": ["kochen"] }
  ]
}

Häufige Fehler

Den alten Pfad /.well-known/agent.json verwenden. Frühe Anleitungen nutzten ihn. Die Spezifikation 1.0 registriert agent-card.json unter /.well-known/.
Ein einzelnes url-Feld statt supportedInterfaces setzen. Version 1.0 beschreibt die erreichbaren Schnittstellen in supportedInterfaces.
Das Kennzeichen für die erweiterte Karte auf oberster Ebene führen. supportsExtendedAgentCard wurde nach capabilities.extendedAgentCard verschoben.

Häufige Fragen

Ist eine Agent Card dasselbe wie eine llms.txt? Nein. Die llms.txt richtet sich an Sprachmodelle, die eine Website lesen. Die Agent Card beschreibt einen Agenten als Dienst, damit andere Agenten mit ihm arbeiten können.

Braucht jede Website eine Agent Card? Nur wer einen eigenen Agenten über A2A anbietet. Für eine normale Website ohne Agenten ist sie ohne Funktion.

Quellen

A2A Protocol Specification (v1.0), Abschnitte 4.4.1 AgentCard, 8.2 Discovery, 14.3 Well-Known URIa2a-protocol.org
Agent Card für Ihren KI-Agenten hinzufügen – Google Cloud Marketplacedocs.cloud.google.com
The /llms.txt file – llmstxt.orgllmstxt.org

Stand: 8. Oktober 2026