# Agent Card

Kategorie: [Agenten & Protokolle](https://seo-geo-glossary.com/de/glossar/kategorie/agenten-protokolle/) › [Agenten-Protokolle](https://seo-geo-glossary.com/de/glossar/kategorie/agenten-protokolle/agenten-protokolle/) · Auch genannt: AgentCard, A2A Agent Card

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.

## 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.

## 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.

## 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](https://a2a-protocol.org/latest/specification/)

Stand: 8. Oktober 2026

*Grafik: Welches Protokoll regelt was?.* 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.

## Verwandte Begriffe

- [Agent2Agent-Protokoll (A2A)](https://seo-geo-glossary.com/de/glossar/agent2agent-protokoll/index.md)
- [KI-Agent](https://seo-geo-glossary.com/de/glossar/ki-agent/index.md)
- [MCP (Model Context Protocol)](https://seo-geo-glossary.com/de/glossar/mcp/index.md)
- [Agent Readiness](https://seo-geo-glossary.com/de/glossar/agent-readiness/index.md)
- [llms.txt](https://seo-geo-glossary.com/de/glossar/llms-txt/index.md)

## Quellen

- [A2A Protocol Specification (v1.0), Abschnitte 4.4.1 AgentCard, 8.2 Discovery, 14.3 Well-Known URI](https://a2a-protocol.org/latest/specification/)
- [Agent Card für Ihren KI-Agenten hinzufügen – Google Cloud Marketplace](https://docs.cloud.google.com/marketplace/docs/partners/ai-agents/agent-card?hl=de)
- [The /llms.txt file – llmstxt.org](https://llmstxt.org/)

---

Stand: 8. Oktober 2026
URL: https://seo-geo-glossary.com/de/glossar/agent-card/