A2A: KI-Agenten Ihre Website aufrufen lassen
Veröffentlicht:
Ein KI-Agent hat diese Website validiert, ohne einen Browser zu öffnen, eine Schaltfläche zu klicken oder eine Seite zu scrapen — er las eine kleine JSON-Datei, sendete eine typisierte Anfrage und erhielt ein strukturiertes Ergebnis zurück. Dieser Austausch ist A2A, und jede Website kann ihn anbieten.
Was A2A ist
A2A (Agent2Agent) ist ein offenes Protokoll — heute unter der Linux Foundation — das KI-Agenten ermöglicht, einander zu entdecken und aufzurufen über einfaches HTTP. Stellen Sie es sich als das Agent-zu-Agent-Gegenstück zu einer öffentlichen API vor: Statt dass ein Mensch Ihre Dokumentation liest und eine Integration schreibt, liest ein anderer Agent eine maschinenlesbare Beschreibung Ihres Dienstes und ruft ihn direkt auf.
Es besteht aus zwei Teilen: einem Discovery-Dokument (der Agent Card) und einem aufrufbaren Endpunkt (dem Skill).
1. Die Agent Card — Entdeckung
Sie veröffentlichen eine JSON-Datei unter /.well-known/agent-card.json, die beschreibt, wer Sie sind und was Sie tun können. Die Pflichtfelder sind name, description, version, url (Ihr A2A-Endpunkt) und mindestens ein skill:
{
"protocolVersion": "0.3.0",
"name": "llms.txt Validator",
"description": "Validate a website's llms.txt and return a score with findings.",
"url": "https://llms-txt-validator.dev/a2a",
"skills": [{ "id": "validate_llms_txt", "name": "Validate llms.txt",
"description": "Given a domain or URL, fetch and validate its llms.txt." }]
}
2. Der Endpunkt — ein aufrufbarer Skill
Die url der Card verweist auf einen JSON-RPC 2.0-Endpunkt. Ein Agent ruft die Methode message/send mit einer Nachricht auf; Sie führen die Arbeit aus und geben einen Task zurück. Hier ist ein echter Aufruf an unseren Agenten:
POST /a2a
{ "jsonrpc": "2.0", "id": "1", "method": "message/send",
"params": { "message": { "role": "user",
"parts": [{ "kind": "text", "text": "validate llmstxt.org" }] } } }
… und die Antwort — ein abgeschlossener Task mit einer für Menschen lesbaren Zusammenfassung und strukturierten Daten:
{ "result": { "kind": "task", "status": { "state": "completed" },
"artifacts": [{ "parts": [
{ "kind": "text", "text": "Validated llmstxt.org: score 100/100..." },
{ "kind": "data", "data": { "ok": true, "report": { "scores": { "overall": 100 } } } }
] }] } }
Kein Browser, kein HTML-Parsing — der Agent erhält genau die Daten, nach denen er gefragt hat.
A2A vs WebMCP vs MCP
- A2A — vernetzte Agenten, die Ihren Dienst über HTTP aufrufen (Orchestratoren, andere Agenten). Diese Seite.
- WebMCP — ein Agent, der im Browser läuft und Tools auf Ihrer geöffneten Seite aufruft.
- MCP — Tools mit einem einzelnen Modell oder einer App verbinden, meist lokal.
Sie ergänzen sich: A2A erreicht vernetzte Agenten, WebMCP erreicht In-Browser-Agenten. Erfahren Sie mehr darüber, wie die drei zusammenpassen.
Wie jede Website einen hinzufügen kann
Sie brauchen nicht das gesamte Protokoll, um zu beginnen — wählen Sie eine echte Funktion, die Ihr Dienst bietet:
- Veröffentlichen Sie eine gültige Agent Card unter
/.well-known/agent-card.jsonmit einem Skill. - Implementieren Sie die synchrone Methode
message/send, die diese Fähigkeit kapselt, und geben Sie einen abgeschlossenenTaskmit dem Ergebnis als Artefakt zurück. - Streaming, Aufgabenverlauf und Push-Benachrichtigungen sind optional — setzen Sie
capabilities.streamingauf false und fügen Sie sie nur hinzu, wenn Sie sie benötigen.
Die eine Regel: Die Card mit einem echten Endpunkt untermauern
Die Card ist ein Vertrag, kein Meta-Tag. Wenn Sie eine Card veröffentlichen, deren url tatsächlich nicht auf message/send antwortet, läuft jeder Agent, der ihr vertraut, ins Leere. Stellen Sie A2A nur für Fähigkeiten bereit, die Sie wirklich erfüllen können — so haben wir unsere gebaut, und deshalb markiert unser eigener Bericht das Signal nur dann als vorhanden, wenn ein funktionierender Endpunkt dahintersteht. Möchten Sie es live sehen? Laden Sie unsere Agent Card.