Agentensysteme und Standards · Kapitel 4 von 8
Agenten, die bezahlen: UCP und AP2
Wie ein Agent bei einem Händler über UCP zur Kasse geht und wie AP2-Mandate die Zahlung an das binden, was der Mensch signiert hat.
Ziele
- Erstelle eine Checkout-Session und schließ sie ab.Offen
- Signiere die Mandate auf dem Handy.Offen
- Ändere den Betrag nach dem Signieren und sieh, wie die Prüfung scheitert.Offen
- Besteh den Check.Offen
Schritt 1 von 4: Der Text
UCP: der Checkout
Mit UCP (Universal Commerce Protocol, Version 2026-08-25) kauft ein Shopping-Agent, die Plattform, bei einem Händler, dem Business. Das Business veröffentlicht ein Profil unter /.well-known/ucp: seine Version, seine Fähigkeiten wie checkout, seine Payment-Handler und seinen REST-Endpoint. Der Agent liest es, erstellt dann mit POST /checkout-sessions eine Checkout-Session, aktualisiert sie mit PUT, bis der Status ready_for_complete ist, und schließt mit POST …/complete ab.
Jeder Aufruf trägt einen UCP-Agent-Header, der auf das eigene Profil der Plattform zeigt, damit das Business prüfen kann, was die Plattform unterstützt. Jeder Schreibvorgang trägt einen Idempotency-Key: Schickt der Agent nach einem Timeout dieselbe Anfrage erneut, antwortet das Business mit dem ersten Ergebnis, statt zweimal zu handeln. Eine doppelte Abbuchung wie bei Haldens Bestellung 48213 ist genau das, was er verhindert.
AP2: die Signatur des Menschen
UCP allein vertraut jedem, der die Session hält. AP2 (Agent Payments Protocol) fügt einen Nachweis der Zustimmung hinzu. Der Anbieter des Agenten stellt zwei Mandate als SD-JWT Verifiable Credentials aus: ein Checkout-Mandat mit einem Hash genau des Checkouts, den Halden signiert hat, und ein Payment-Mandat mit dem Betrag, dem Empfänger und der Karte. Der Mensch prüft sie auf einem Bildschirm, auf den der Agent nicht zeichnen kann, der Wallet seines Handys, und der Schlüssel des Handys signiert auf jedem ein Key-Binding-JWT.
Halden prüft das Checkout-Mandat gegen den Checkout, den es signiert hat. Das Karten-Wallet prüft das Payment-Mandat, bevor es einen Payment-Token für diesen Betrag ausstellt, und der Processor prüft den Token, bevor er abbucht. Ändere den Warenkorb oder den Betrag, nachdem der Mensch signiert hat, und ein Hash oder eine Signatur passt nicht mehr, egal was der Agent sagt.
Hier ist der Mensch dabei. Im autonomen Modus von AP2 ist er es nicht: Er gibt vorab offene Mandate frei, mit Grenzen wie einem Höchstpreis, und der Agent signiert die endgültigen Mandate innerhalb dieser Grenzen.
ANP, in zwei Sätzen
ANP (Agent Network Protocol) ist für Agenten, die sich im offenen Web treffen: Jeder Agent hat einen did:wba-Identifier, dessen DID-Dokument, von seiner eigenen Domain ausgeliefert, seine öffentlichen Schlüssel listet. Jede Anfrage ist mit HTTP Message Signatures signiert, also weiß die Gegenseite ohne Konto, welcher Agent sie gesendet hat. Die ANP-Labs im Schritt Weiterführend führen es aus.
Was du hier machst
Ein Shopping-Agent kauft Haldens Zelt Ridge 2. Verfolge den Checkout, gib auf dem Handy frei, führ ihn dann mit eingeschaltetem Abfangen erneut aus und erhöh den Betrag nach dem Signieren.
Schritt 2 von 4: Probier es aus: Eine Kette von Signaturen
Eine Kette von Signaturen
Fünf Schritte, dann zwei optionale. Unter den Schritten fügt die Kette jedes Glied des Kaufs hinzu, sobald der Kauf es erreicht, mit dem, der es prüft. Unter der Kette zeichnet das Lab jede Nachricht als Zeile, von oben nach unten.
Modus:EchtSimuliertEcht: das REST-Binding von UCP (nach der Spezifikation geschrieben, ohne SDK), die SD-JWT-Mandate von AP2 (@sd-jwt/sd-jwt-vc 0.21.1) und ES256-Signaturen mit WebCrypto-Schlüsseln, die auf dieser Seite erzeugt werden, sowie die signierten Anfragen von ANP in den Weiterführend-Labs. Simuliert: die Abwicklung und die Entscheidungen des Agenten, außer du verbindest ein Modell. Der Shop und die Karten sind erfunden.
Schritt 3 von 4: Check
Check
Als Nächstes: Frage 2 von 4
Schritt 4 von 4: Was du jetzt kannst
Was du jetzt kannst
- Eine UCP-Checkout-Session vom Profil bis completed verfolgen.
- Erklären, wie AP2-Mandate eine Zahlung an die signierte Zustimmung eines Menschen binden.
- Idempotency-Keys nutzen, damit Retries sicher sind.
- In zwei Sätzen sagen, was did:wba und signierte Anfragen von ANP hinzufügen.