Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Agenten, die mit Agenten sprechen: das A2A-Protokoll

Nach dieser Lektion: Ich kann eine Agent Card lesen und entscheiden, ob ich diesem Agenten eine Aufgabe schicke.

Lektion, 70 Min.13 BefehleLab für KI-Coding-Agenten: mit opencode Code erklären und reparieren lassen und die Arbeit prüfen

Ihr Orchestrator braucht den Agenten eines anderen Teams

Ihr Team aus Agenten plant den Tag der offenen Tür einer Schule. Es braucht freie Räume, und eine andere Abteilung betreibt schon einen Agenten, der den Stundenplan kennt.

Ihr Code kann dessen Code nicht importieren, und Sie sehen nicht hinein. Sie brauchen einen vereinbarten Weg, ihn zu fragen, was er kann, und ihm eine Arbeit zu übergeben.

Am Ende dieser Lektion

Notiz

Ich kann eine Agent Card lesen und entscheiden, ob ich diesem Agenten eine Aufgabe schicke.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
A2Aein offenes Protokoll, mit dem ein Agent einem anderen eine Aufgabe übergibt
Agent Cardeine JSON-Datei, in der ein Agent sich beschreibt
Fähigkeiteine Arbeit, die der Agent laut Karte kann
Aufgabeeine an einen Agenten gesendete Arbeit mit einem Zustand
Artefaktwas eine fertige Aufgabe zurückgibt
JSON-RPCeine Art, eine Methode durch gesendetes JSON aufzurufen"method": "message/send"

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

A2A ist eine gemeinsame Sprache für Agenten

Google hat das Agent2Agent-Protokoll 2025 vorgestellt und dann an die Linux Foundation übergeben. Es ist offen, also kann jedes Team danach bauen.

Es nutzt gewöhnliches HTTP. Ein Client-Agent schickt eine Aufgabe als JSON-RPC 2.0, und der entfernte Agent kann Zwischenstände als Server-Sent Events zurückschicken. Keine Seite sieht Code, Prompts oder Werkzeuge der anderen.

Eine Agent Card sagt, was ein Agent anbietet

Ein A2A-Agent veröffentlicht eine Karte unter einer festen Adresse seines Servers, /.well-known/agent-card.json. Die Karte nennt Name und Version, die Adresse für Aufgaben und die Fähigkeiten, jede mit Tags.

Sie sagt auch, wie ein Aufrufer beweisen muss, wer er ist. Der Client liest die Karte, bevor er etwas sendet.

Den falschen Stundenplan-Agenten schreiben, Teil 1

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const http = require(\"http\");' 'const KARTE = {' '  protocolVersion: \"0.3.0\",' '  name: \"Stundenplan-Agent\",' '  description: \"Beantwortet Fragen zum Stundenplan einer Schule.\",' '  url: \"http://localhost:4100/a2a\",' '  version: \"1.0.0\",' '  capabilities: { streaming: true },' '  defaultInputModes: [\"text/plain\"],' '  defaultOutputModes: [\"text/plain\"],' '  securitySchemes: { klassenSchluessel: { type: \"http\", scheme: \"bearer\" } },' '  security: [{ klassenSchluessel: [] }],' '  skills: [' '    { id: \"freie-raeume\", name: \"Freie Räume\", description: \"Listet die Räume, die zu einer Zeit frei sind.\", tags: [\"raeume\", \"stundenplan\"] },' '    { id: \"doppelbelegung\", name: \"Doppelbelegung\", description: \"Findet zwei Kurse im selben Raum.\", tags: [\"stundenplan\"] },' '  ],' '};' > agent.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den falschen Stundenplan-Agenten schreiben, Teil 2

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const ANTWORT = \"Frei am Montag um 14 Uhr: B12 und C3.\";' 'function aufgabe(id, zustand, text) {' '  const a = { kind: \"task\", id: id, contextId: \"ctx-1\", status: { state: zustand } };' '  if (text) a.artifacts = [{ artifactId: \"a-1\", name: \"antwort\", parts: [{ kind: \"text\", text: text }] }];' '  return a;' '}' 'function gesagt(aufruf) { return aufruf.params.message.parts[0].text; }' 'function senden(aufruf) {' '  if (gesagt(aufruf).includes(\"Doppelbelegung\")) return aufgabe(\"task-9\", \"failed\", \"\");' '  return aufgabe(\"task-7\", \"completed\", ANTWORT);' '}' >> agent.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den falschen Stundenplan-Agenten schreiben, Teil 3

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function strom(aufruf, res) {' '  res.setHeader(\"content-type\", \"text/event-stream\");' '  const ereignisse = [' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"submitted\" }, final: false },' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"working\" }, final: false },' '    { kind: \"artifact-update\", taskId: \"task-8\", artifact: { artifactId: \"a-1\", parts: [{ kind: \"text\", text: ANTWORT }] } },' '    { kind: \"status-update\", taskId: \"task-8\", status: { state: \"completed\" }, final: true },' '  ];' '  ereignisse.forEach(function (e) {' '    res.write(\"data: \" + JSON.stringify({ jsonrpc: \"2.0\", id: aufruf.id, result: e }) + \"\n\n\");' '  });' '  res.end();' '}' >> agent.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den falschen Stundenplan-Agenten schreiben, Teil 4

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function rpc(res, inhalt) {' '  const aufruf = JSON.parse(inhalt);' '  if (aufruf.method === \"message/stream\") return strom(aufruf, res);' '  res.setHeader(\"content-type\", \"application/json\");' '  const aus = { jsonrpc: \"2.0\", id: aufruf.id };' '  if (aufruf.method === \"message/send\") aus.result = senden(aufruf);' '  else aus.error = { code: -32601, message: \"Method not found\" };' '  res.end(JSON.stringify(aus));' '}' >> agent.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den falschen Stundenplan-Agenten schreiben, Teil 5

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'function starten(port) {' '  const server = http.createServer(function (req, res) {' '    if (req.method === \"GET\" && req.url === \"/.well-known/agent-card.json\") {' '      res.setHeader(\"content-type\", \"application/json\");' '      return res.end(JSON.stringify(KARTE));' '    }' '    if ((req.headers.authorization === \"Bearer geheim-1\") === false) {' '      res.statusCode = 401;' '      return res.end();' '    }' '    let inhalt = \"\";' '    req.on(\"data\", function (c) { inhalt += c; });' '    req.on(\"end\", function () { rpc(res, inhalt); });' '  });' '  return new Promise(function (ok) { server.listen(port, function () { ok(server); }); });' '}' 'module.exports = { starten };' >> agent.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den Kartenleser schreiben

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { starten } = require(\"./agent\");' 'async function main() {' '  const server = await starten(4100);' '  const res = await fetch(\"http://localhost:4100/.well-known/agent-card.json\");' '  const karte = await res.json();' '  console.log(\"Name: \" + karte.name + \", Version \" + karte.version);' '  console.log(\"Aufgaben an: \" + karte.url);' '  console.log(\"Sendet Zwischenstände: \" + karte.capabilities.streaming);' '  karte.skills.forEach(function (s) {' '    console.log(\"Fähigkeit \" + s.id + \": \" + s.description + \" Tags: \" + s.tags.join(\", \"));' '  });' '  const schemata = Object.values(karte.securitySchemes).map(function (s) { return s.scheme; });' '  console.log(\"Verlangt von Aufrufern: \" + schemata.join(\", \"));' '  server.close();' '}' 'main();' > karte.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Agent Card abrufen und lesen

Befehl
docker exec -w /home/node/project agent node karte.js

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Eine Aufgabe durchläuft Zustände

Der Client sendet eine Nachricht mit message/send. Der Agent antwortet mit einer Aufgabe: einer id, einem Zustand und, wenn sie fertig ist, Artefakten.

Eine Aufgabe beginnt als submitted, wird working und kann bei input-required anhalten, um nachzufragen. Sie endet als completed, failed, canceled oder rejected. Mit message/stream kommt jede Änderung als Ereignis, und das letzte ist als final markiert.

Den Aufgabensender schreiben, Teil 1

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { starten } = require(\"./agent\");' 'function aufrufen(methode, text, schluessel) {' '  const kopf = { \"content-type\": \"application/json\" };' '  if (schluessel) kopf.authorization = \"Bearer \" + schluessel;' '  const message = { role: \"user\", messageId: \"m-1\", parts: [{ kind: \"text\", text: text }] };' '  const inhalt = { jsonrpc: \"2.0\", id: 1, method: methode, params: { message: message } };' '  return fetch(\"http://localhost:4100/a2a\", { method: \"POST\", headers: kopf, body: JSON.stringify(inhalt) });' '}' 'function zeile(e) {' '  const was = e.status ? e.status.state : \"Artefakt \" + e.artifact.parts[0].text;' '  return \"Ereignis \" + e.kind + \": \" + was + (e.final ? \" (final)\" : \"\");' '}' > aufgabe.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Den Aufgabensender schreiben, Teil 2

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'async function main() {' '  const server = await starten(4100);' '  const gesendet = await (await aufrufen(\"message/send\", \"Welche Räume sind am Montag um 14 Uhr frei?\", \"geheim-1\")).json();' '  console.log(\"Aufgabe \" + gesendet.result.id + \": \" + gesendet.result.status.state);' '  console.log(\"Artefakt: \" + gesendet.result.artifacts[0].parts[0].text);' '  const text = await (await aufrufen(\"message/stream\", \"Dasselbe als Strom.\", \"geheim-1\")).text();' '  text.split(\"\n\n\").filter(Boolean).forEach(function (stueck) {' '    console.log(zeile(JSON.parse(stueck.slice(6)).result));' '  });' '  const seltsam = await (await aufrufen(\"tasks/singen\", \"Hallo\", \"geheim-1\")).json();' '  console.log(\"Unbekannte Methode: Fehler \" + seltsam.error.code);' '  console.log(\"Ohne Schlüssel: HTTP \" + (await aufrufen(\"message/send\", \"Hallo\", \"\")).status);' '  server.close();' '}' 'main();' >> aufgabe.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Eine Aufgabe senden, dann eine als Strom

Befehl
docker exec -w /home/node/project agent node aufgabe.js

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Was der Run ausgibt

ZeileWas geschah
Aufgabe task-7: completedmessage/send hat bis zum Ende gewartet
Artefakt: Frei am Montag um 14 Uhr: B12 und C3.Die Antwort, die die Aufgabe zurückgab
Ereignis status-update: submitted, dann workingDer Strom meldet jeden Zustand
Ereignis artifact-update: Artefakt Frei am Montag…Die Antwort kommt im Strom
Ereignis status-update: completed (final)Danach kommt nichts mehr
Unbekannte Methode: Fehler -32601Der JSON-RPC-Code für eine Methode, die es nicht gibt
Ohne Schlüssel: HTTP 401Der Agent lehnt einen Aufrufer ohne Token ab

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

A2A und MCP erledigen verschiedene Aufgaben

MCPA2A
VerbindetEinen Agenten mit Werkzeugen und DatenEinen Agenten mit einem anderen Agenten
Die andere SeiteTut, was man ihr sagt, Schritt für SchrittPlant die eigene Arbeit und braucht mitunter länger
Sie sehenJeden Werkzeugaufruf und sein ErgebnisNur die Aufgabe, ihre Zustände und Artefakte
ZusammenDer entfernte Agent kann intern MCP nutzenIhr Agent gibt die ganze Arbeit ab

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Eine Karte ist eine Behauptung, kein Beweis

Jeder kann eine Karte veröffentlichen, die jede beliebige Fähigkeit behauptet. Führen Sie darum eine Liste vertrauenswürdiger Hosts und rufen Sie nie einen Host auf, der nicht darauf steht.

Testen Sie dann eine behauptete Fähigkeit mit einer Aufgabe, deren Antwort Sie kennen. Das Sicherheitsschema der Karte sagt, was zu senden ist. Der entfernte Agent muss trotzdem bei jeder Aufgabe prüfen, ob dieser Aufrufer fragen darf.

Die Vertrauensprüfung schreiben, Teil 1

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'const { starten } = require(\"./agent\");' 'const ERLAUBT = [\"localhost:4100\"];' 'const ANDERER = { name: \"Hilfsbereiter Agent\", url: \"https://agents.example.net/a2a\", skills: [{ id: \"alles\" }] };' 'function hostVon(url) { return url.split(\"/\")[2]; }' 'async function testen(karte, text) {' '  const message = { role: \"user\", messageId: \"m-2\", parts: [{ kind: \"text\", text: text }] };' '  const inhalt = { jsonrpc: \"2.0\", id: 2, method: \"message/send\", params: { message: message } };' '  const kopf = { \"content-type\": \"application/json\", authorization: \"Bearer geheim-1\" };' '  const res = await fetch(karte.url, { method: \"POST\", headers: kopf, body: JSON.stringify(inhalt) });' '  return (await res.json()).result.status.state;' '}' > vertrauen.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Vertrauensprüfung schreiben, Teil 2

Befehl
docker exec -w /home/node/project agent sh -c "printf '%s\n' 'async function main() {' '  const server = await starten(4100);' '  const unsere = await (await fetch(\"http://localhost:4100/.well-known/agent-card.json\")).json();' '  [unsere, ANDERER].forEach(function (k) {' '    const bekannt = ERLAUBT.includes(hostVon(k.url));' '    console.log(k.name + \" auf \" + hostVon(k.url) + \": \" + (bekannt ? \"auf der Erlaubnisliste\" : \"nicht auf der Liste, nie aufgerufen\"));' '  });' '  console.log(\"Die Karte behauptet: \" + unsere.skills.map(function (s) { return s.id; }).join(\", \"));' '  console.log(\"Test freie-raeume: \" + await testen(unsere, \"Welche Räume sind am Montag um 14 Uhr frei?\"));' '  console.log(\"Test doppelbelegung: \" + await testen(unsere, \"Finden Sie eine Doppelbelegung in Raum B12.\"));' '  server.close();' '}' 'main();' >> vertrauen.js"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die behaupteten Fähigkeiten einer Karte testen

Befehl
docker exec -w /home/node/project agent node vertrauen.js

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein häufiger Fehler

Warnung

Viele halten eine Agent Card für einen Beweis dessen, was ein Agent kann. Eine Karte ist der Agent, der sich selbst beschreibt. Hier behauptet sie Doppelbelegungen, und doch kommt eine Aufgabe zu einer Doppelbelegung als failed zurück. Vertrauen Sie einer Fähigkeit erst, wenn ein bekannter Test besteht, und nur von einem Host, den Sie gewählt haben.

Über dieses Lab und seinen Quellcode: Lab für KI-Coding-Agenten: mit opencode Code erklären und reparieren lassen und die Arbeit prüfen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.