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
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| A2A | ein offenes Protokoll, mit dem ein Agent einem anderen eine Aufgabe übergibt | |
| Agent Card | eine JSON-Datei, in der ein Agent sich beschreibt | |
| Fähigkeit | eine Arbeit, die der Agent laut Karte kann | |
| Aufgabe | eine an einen Agenten gesendete Arbeit mit einem Zustand | |
| Artefakt | was eine fertige Aufgabe zurückgibt | |
| JSON-RPC | eine 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
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
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
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
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
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
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
docker exec -w /home/node/project agent node karte.jsHier 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
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
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
docker exec -w /home/node/project agent node aufgabe.jsHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Was der Run ausgibt
| Zeile | Was geschah |
|---|---|
| Aufgabe task-7: completed | message/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 working | Der 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 -32601 | Der JSON-RPC-Code für eine Methode, die es nicht gibt |
| Ohne Schlüssel: HTTP 401 | Der Agent lehnt einen Aufrufer ohne Token ab |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
A2A und MCP erledigen verschiedene Aufgaben
| MCP | A2A | |
|---|---|---|
| Verbindet | Einen Agenten mit Werkzeugen und Daten | Einen Agenten mit einem anderen Agenten |
| Die andere Seite | Tut, was man ihr sagt, Schritt für Schritt | Plant die eigene Arbeit und braucht mitunter länger |
| Sie sehen | Jeden Werkzeugaufruf und sein Ergebnis | Nur die Aufgabe, ihre Zustände und Artefakte |
| Zusammen | Der entfernte Agent kann intern MCP nutzen | Ihr 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
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
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
docker exec -w /home/node/project agent node vertrauen.jsHier 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.