LangChain: Restock-Agent bezahlt echte Bestellungen über Stripes Link

Was Restock leistet

Restock ist ein Beispiel-Agent für Büromaterial, der in Slack auf Managed Deep Agents (MDA) läuft. Laut LangChain durchsucht er echte Produkte, stellt einen Warenkorb zusammen und schließt den Kauf über eine API ab, die MPP unterstützt. Das Unternehmen versteht das Projekt als Vorlage für Entwickler, die Agenten bauen wollen, die Geld ausgeben.

Der Blogbeitrag begleitet eine einzelne Anfrage: Ein Nutzer bittet um eine 12er-Packung blauer Kugelschreiber fürs Büro, insgesamt für höchstens 25 US-Dollar. Restock bestellt sie für 22,18 US-Dollar inklusive Gebühren. LangChain weist darauf hin, dass die Preise im Beitrag nur der Veranschaulichung dienen.

Das Unternehmen beschreibt das Problem nüchtern: Agenten finden bereits gut Dinge zum Kaufen, doch das Bezahlen ist schwieriger, weil es um echtes Geld geht, Zugangsdaten erfordert, die das Modell nie sehen darf, und sich kaum rückgängig machen lässt.

So funktioniert der Bezahlvorgang

LangChain stellt zwei Wege des Bezahlens gegenüber. Ein Agent kann den Checkout eines Händlers im Browser steuern, doch das ist fehleranfällig: Seiten ändern sich, Websites blockieren automatisierte Bestellungen, und Zahlungsdaten müssen eingegeben werden, ohne dass das Modell sie sieht. Eine MPP-fähige API umgeht das, indem sie dem Agenten genau mitteilt, was zu zahlen ist, und die Zahlung direkt entgegennimmt. Der Preis dafür ist die begrenzte Abdeckung, denn der Agent kann nur über MPP-fähige APIs einkaufen. Diese Liste wachse, sagt LangChain: Aggregatoren wie Apify und Mercator kämen zu vertikalen Anbietern wie Zinc für den Einzelhandel hinzu. Restock nutzt Zinc.

Restock besteht aus vier Bausteinen:

• Link, Stripes Wallet für Verbraucher, verwaltet die Zahlungsmethoden des Nutzers und bittet ihn, Zahlungen zu genehmigen.
• MPP definiert den Zahlungsablauf über HTTP. Der Händler antwortet mit 402 Payment Required und Zahlungsanweisungen, der Client wiederholt die Anfrage mit einem Zahlungsnachweis.
• Zinc durchsucht Produkte und löst über seine MPP-Order-API Händlerbestellungen aus.
• Managed Deep Agents hostet den Agenten und übernimmt Slack, menschliche Freigabe, Zugangsdaten und gespeicherte Zustände.

LangChain hat eigene Tools für die Zinc-Suche, den Warenkorb und die Zahlung geschrieben, dazu Anweisungen, die den Gesprächsverlauf steuern. MDA speichert Unterhaltungen und Bestellungen, sodass ein Nutzer Tage später zurückkehren und nach denselben Kugelschreibern fragen kann.

Budgets, Freigaben und Geheimnisse

Restock behandelt das Budget von 25 US-Dollar als Obergrenze, nicht als abzubuchenden Betrag. Steuern und Versand sind aus einem Produkteintrag nicht ersichtlich, deshalb fragt der Agent den Nutzer, wie viel er vorab zahlen möchte, bis maximal 25 US-Dollar. Im Beispiel wählt der Nutzer 23 US-Dollar. Zinc behält eine Grundgebühr von 1 US-Dollar ein, sodass 22 US-Dollar für Artikel, Steuern und Versand beim Händler bleiben. Zinc bezahlt den Händler aus dem Vorabbetrag und erstattet den Rest. Optionale Gebühren können diesen Spielraum verkleinern, weshalb Restock die tatsächlichen Gebühren vor der Freigabe aus der 402-Antwort von Zinc ausliest.

Der Nutzer genehmigt zweimal. Zuerst prüft er in Slack Warenkorb, Büro-Label, Gebühren und Vorabbetrag. Restock löst einen Interrupt aus, der Ablauf bleibt also pausiert, bis der Nutzer auf Approve oder Reject klickt; nichts, was das Modell in einen Tool-Aufruf schreibt, kann die Freigabe ersetzen, betont LangChain. Danach bestätigt der Nutzer den genauen Betrag auf der Link-Website.

Bei den Geheimnissen liegt die Link-Sitzung in einer nutzereigenen MDA-Connection, sodass jede Wallet bei ihrem Besitzer bleibt. Lieferadresse, Benachrichtigungs-E-Mail und Zinc-API-Schlüssel liegen in Connections des Agenten. Das Link-CLI läuft in der verwalteten Sandbox von MDA. Nach der Freigabe sendet Restock die bezahlte Anfrage mit einem Link Shared Payment Token an Zinc; das Zahlungs-Tool löscht das Token nach der Nutzung und gibt dem Modell nur eine öffentliche Zusammenfassung zurück. Da das Token selbst keine Warenkorbdetails erzwingt, gleicht das Tool die Bestellung zusätzlich mit dem ab, was der Nutzer geprüft hat, und stellt sicher, dass die Freigabe noch aktuell ist.

Im Beispiel beläuft sich die Händlerbestellung auf 21,18 US-Dollar: 14,99 US-Dollar für die Stifte, 1,20 US-Dollar Steuern und 4,99 US-Dollar Versand. Der Nutzer zahlt inklusive Zinc-Gebühr 22,18 US-Dollar, Zinc erstattet 0,82 US-Dollar. Restock bestätigt in Slack, sobald Zinc order_placed meldet, und teilt die Sendungsverfolgung mit, wenn der Händler versendet.

Einstieg und Einschränkungen

Der Code ist unter langchain-samples/restock-agent verfügbar, die README beschreibt Einrichtung und Deployment. LangChain gibt an, Restock auf einem gehosteten Deployment durchgängig getestet zu haben: Eine Live-Bestellung erreichte den Status order_placed, und die erwartete Erstattung kam an.

Restock ist ein Beispielprojekt mit Grenzen: Es unterstützt nur Lieferungen in die USA und nur US-Dollar, ein Büro pro Deployment und die Zahlung aus der Wallet des Anfragenden. Es gibt drei Modi, die über RESTOCK_MODE festgelegt werden:

• rehearsal: fiktive Produkte und eine simulierte Freigabe. Erforderlich sind ein OpenAI-API-Schlüssel und ein LangSmith-Workspace mit Zugang zu Managed Deep Agents.
• link-test: echte Zinc-Suche und echte Link-Freigabe, aber ohne Kauf. Hinzu kommen eine Link-Wallet, ein Zinc-API-Schlüssel, ein aufgeladenes Zinc-Suchkonto und Lieferdaten.
• live: echte Zahlung und echte Händlerbestellung.

Das Muster lasse sich auf jeden Agenten übertragen, der Geld ausgibt, so LangChain: Der Agent sucht und stellt den Warenkorb zusammen, Ausgabenlimit und Freigaben liegen in Code, den das Modell nicht anfassen kann, und eine Bestellung gilt erst als aufgegeben, wenn der Händler dies bestätigt.