ADK-Rust

Zahlungen und Handel

adk-payments fügt ADK-Rust eine protokollneutrale Handelsorchestrierung hinzu. Es wurde für agentische Handelsabläufe entwickelt, die ein dauerhaftes Transaktionsmodell über mehrere Protokolladapter hinweg benötigen, ohne dass rohe Zahlungsartefakte in den Konversationsverlauf oder das semantische Gedächtnis gelangen.

Unterstützungsstufen

  • ACP stable 2026-01-30: die produktionsorientierte Basis für Checkout, Abschluss, Stornierung, delegierte Zahlung und Auftragsnachverfolgung.
  • ACP experimental: funktionsgesteuerte Erkennung, Delegierten-Authentifizierung und Webhook-Erweiterungen. Behandeln Sie diese Routen als Kompatibilitätsoberflächen für die Entwicklung von ACP-Entwürfen.
  • AP2 v0.1-alpha: typisierte Mandats-, Zahlungs-, Quittungs-, Interventions-, A2A- und MCP-sichere Unterstützung für die aktuelle Alpha-Protokollform.

Primäre Abläufe

  • ACP persönliche Kassenabwicklung mit delegierter Zahlung, gefolgt von Händler- oder Webhook-Bestellaktualisierungen.
  • AP2 Koordination von Käufer, Händler, Anmeldeinformationsanbieter und Zahlungsabwickler in Anwesenheit eines Menschen.
  • AP2 Ausführung einer Absicht ohne Anwesenheit eines Menschen, entweder mit autonomer Vervollständigung oder expliziter Käufer-Rückbestätigung.
  • Händlerbereitstellungen mit Dual-Protokoll, bei denen ACP und AP2 zu derselben kanonischen transaction ID und demselben journal korrelieren.
  • Abruf nach der Kompaktierung, wobei das dauerhafte journal und der maskierte Speicher den Verlust des Transkripts überleben.

Sicherheit und Dauerhaftigkeit

  • Rohe Mandate, Signaturen, delegierte Anmeldeinformationen und Beleg-Payloads verbleiben im Beweisspeicher, der von adk-artifact unterstützt wird.
  • Dauerhafter Transaktionszustand lebt in adk-session über das strukturierte Journal, nicht in einem fragilen, nur auf Konversation basierenden Kontext.
  • Semantischer Abruf verwendet maskierte Zusammenfassungen durch adk-memory.
  • adk-auth bindet Anforderungsidentität, Mandantenbereich und Audit-Metadaten.
  • adk-guardrail wendet Betrag, Händler, Protokollversion, Intervention und Redaktionsrichtlinie an, bevor der Zustand persistent gespeichert wird.

Validierungspfad

Verwenden Sie die Integrationstests als den maßgeblichen End-to-End-Validierungspfad:

cargo test -p adk-payments --features acp --test acp_integration_tests
cargo test -p adk-payments --features ap2,ap2-a2a,ap2-mcp --test ap2_integration_tests
cargo test -p adk-payments --test cross_protocol_correlation_tests
cargo test -p adk-payments --features acp-experimental --test acp_experimental_integration_tests

Referenzdateien:

  • adk-payments/tests/acp_integration_tests.rs
  • adk-payments/tests/ap2_integration_tests.rs
  • adk-payments/tests/cross_protocol_correlation_tests.rs
  • examples/payments/README.md

Die Beispiel-Crate unter examples/payments/ ist der Szenario-Index für die unterstützten Journeys, während die Integrationstests die ausführbare Grundwahrheit für Protokoll-, Journal- und Beweisverhalten sind.