Zum Inhalt springen
Zurück zu Agentensysteme und Standards

Agentensysteme und Standards · Kapitel 2 von 8

A2A: Agenten, die an Agenten delegieren

Wie ein Agent einen anderen über dessen Agent Card findet und ihm einen Task übergibt, den er bis zum Ende verfolgen kann.

25 Minuten0 von 4 Zielen erreicht

Ziele

  • Lies die Agent Card des Payments-Agenten.Offen
  • Verfolge einen Task von WORKING über INPUT_REQUIRED bis COMPLETED.Offen
  • Antworte auf eine Task-ID, die nicht dir gehört, und sieh, wie sie abgelehnt wird.Offen
  • Bring den Austausch in die richtige Reihenfolge.Offen

Schritt 1 von 4: Der Text

Ein Gegenüber, kein Tool

A2A (Agent2Agent, Protokoll 1.0) verbindet Agenten, die verschiedene Parteien betreiben. Im vorigen Kapitel hat der Support-Agent Tools auf einem MCP-Server aufgerufen: Funktionen mit einem Schema, die genau so laufen, wie sie aufgerufen werden. Über A2A übergibt er Arbeit an einen anderen Agenten, der mit seinem eigenen Modell, seinen Tools und seinem Gedächtnis entscheidet, wie er sie erledigt. Der Aufrufer sieht nur den Task und seine Ergebnisse.

Die Agent Card

Jeder A2A-Server hat eine Agent Card. Ein öffentlicher Agent stellt sie unter /.well-known/agent-card.json bereit, wo jeder sie ohne Zugangsdaten lesen kann. Sie nennt den Agenten und seine Skills, listet seine Schnittstellen (URL, Binding wie JSONRPC, Protokollversion), sagt, ob er streamen kann, und legt fest, wie man sich authentifiziert, hier mit einem Bearer-Token pro Händler. Jede Anfrage trägt einen A2A-Version-Header; ein Server lehnt eine Version ab, die seine Card nicht listet (Fehler -32009).

Nachrichten, Tasks und Artefakte

Der Client ruft SendMessage mit einer Nachricht aus Teilen auf: Text für das Modell des anderen Agenten und Datenteile mit einem Medientyp für Werte, auf die er sich verlassen kann, etwa die Bestell-ID und den Betrag. Die Antwort ist eine Nachricht oder, bei Arbeit, die Zeit braucht, ein Task: eine ID, eine contextId, die eine Unterhaltung zusammenfasst, und ein Status wie TASK_STATE_WORKING, INPUT_REQUIRED oder COMPLETED. Ergebnisse kommen als Artefakte am Task an, getrennt vom Chat.

INPUT_REQUIRED pausiert den Task, bis der Client antwortet. Die Antwort ist eine neue Nachricht, die dieselbe taskId und contextId nennt. Der Server hält die Tasks jedes Händlers getrennt: Eine Antwort, die einen Task nennt, der nicht diesem Händler gehört, bekommt -32001, task not found, und nichts läuft.

Streaming oder Polling

Mit SendStreamingMessage schickt der Server Server-Sent Events: zuerst den Task, dann Status- und Artefakt-Updates, bis der Task pausiert oder endet. Ohne Streaming antwortet SendMessage, wenn der Task pausiert oder endet; mit returnImmediately antwortet es sofort, und der Client fragt GetTask per Polling ab.

Was du hier tust

Haldens Support-Agent und der Payments-Agent nutzen beide das offizielle A2A JavaScript SDK (@a2a-js/sdk 1.3.0) auf dieser Seite, jeder gesteuert von einem geskripteten LangChain-Modell. Lies die Card, verfolge den Erstattungs-Task durch seine Status und beantworte seine Frage selbst. Schalte dann Abfangen ein und richte deine Antwort auf den Task eines anderen Händlers. Ein optionaler Schritt zeigt, wie der Payments-Agent sein Ledger über MCP erreicht, wobei aus MCPs input_required das INPUT_REQUIRED des A2A-Tasks wird.

Schritt 2 von 4: Probier es aus: Ein Task über eine Grenze

Ein Task über eine Grenze

Drei Schritte mit je einer Aktion, dann zwei optionale. Das Diagramm unter den Schritten hat eine Spalte pro Beteiligtem und eine Zeile pro Nachricht, von oben nach unten. Die dicke gestrichelte Linie ist die Organisationsgrenze.

Modus:EchtSimuliertEcht: Das A2A JavaScript SDK (@a2a-js/sdk 1.3.0, A2A 1.0), Client und Server, und das MCP SDK im optionalen Schritt A2A mit MCP laufen auf dieser Seite. Simuliert: Die Entscheidungen der Agenten sind geskriptet, außer du verbindest ein Modell, die Zahlungen sind simuliert, und die Daten sind erfunden.

Schritt 3 von 4: Check

Check

Bring den A2A-Austausch für die Erstattung in die richtige Reihenfolge.

Zieh die Einträge oder nutze die Pfeiltasten, um sie zu ordnen.

  1. Position 1: SendMessage mit der Erstattungsanfrage.
  2. Position 2: GET der Agent Card.
  3. Position 3: Task in TASK_STATE_COMPLETED, mit dem Erstattungsbeleg als Artefakt.
  4. Position 4: SendMessage mit der Antwort, am selben Task.
  5. Position 5: Task in TASK_STATE_INPUT_REQUIRED.
  6. Position 6: Task in TASK_STATE_WORKING.

Schritt 4 von 4: Was du jetzt kannst

Was du jetzt kannst

  • Eine Agent Card lesen und einen Skill und eine Schnittstelle wählen.
  • Eine Nachricht senden und die Status eines Tasks bis zu seinen Artefakten verfolgen, per Stream oder per Polling.
  • Einen Task in INPUT_REQUIRED mit einer Antwort auf dieselbe taskId und contextId beantworten.
  • Erklären, wann A2A statt MCP passt.