Architecture 4 couches de l'agent River (Shopify)
Slack comme interface, River comme surface d'agent, Aquifer comme fondation et un harnais séparé : les quatre couches d'un agent interne qui traite la session comme une entité durable.
Flux des modes de session de River (Shopify)
Trois modes de session dans un même agent : interactif dans Slack, revue automatisée dans la demande de fusion et exécutions par lots éphémères déclenchées par la CI.
Code FlowZap complet
Copiez et collez le code FlowZap suivant dans un projet de votre compte FlowZap pour voir ce diagramme.
river { # Interactive Mode
n1: circle label:"@River Slack"
n2: rectangle label:"Public session"
n1.handle(right) -> n2.handle(left)
n2.handle(bottom) -> aquifer.n7.handle(top) [label="via Aquifer"]
}
review { # Automation Mode
n3: circle label:"PR Webhook"
n4: rectangle label:"Automated review"
n3.handle(right) -> n4.handle(left)
n4.handle(bottom) -> aquifer.n8.handle(top) [label="via Aquifer"]
}
ci { # Batch Mode
n5: circle label:"CI Trigger"
n6: rectangle label:"Ephemeral batch"
n5.handle(right) -> n6.handle(left)
n6.handle(bottom) -> aquifer.n9.handle(top) [label="via Aquifer"]
}
aquifer { # Aquifer - Shared Foundation
n7: rectangle label:"Session model"
n8: rectangle label:"Sandbox plane"
n9: rectangle label:"Gateway"
n7.handle(right) -> n8.handle(left)
n8.handle(right) -> n9.handle(left)
}
Installer le paquet MCPnpm install -g flowzap-mcpDocumentation MCP
Modèles associés
Architecture de découplage cerveau-mains (Shopify River)
Découpler le cerveau des mains : le harnais appelle le LLM et émet des intentions d'outils, le bac à sable les exécute — un nouvel agent devient un profil, pas une plateforme.
Hub d'intégration e-commerce multiplateforme
n8n comme couche d'intégration centrale : un seul flux détermine s'il s'agit d'une synchronisation produit ou d'une commande, l'achemine vers le bon canal et boucle le traitement.
Flux de paiement USDC d'agent à agent
Flux Coinbase AgentKit : un humain alloue un budget USDC, l'agent authentifie son portefeuille Base, règle une facture x402 et traite les données du fournisseur, sans passage par le fiat.
Flux de paiement fiat médié par agent
Flux Stripe Agent Toolkit : le consommateur approuve une dépense d'agent, l'agent demande un jeton à portée limitée, le transmet au marchand et la commande se conclut en fiat.
Coinbase Trust Flow — règlement on-chain
La couche de confiance des paiements d'agent à agent chez Coinbase : l'agent initie la dépense, la transaction est diffusée, le bloc confirme et le paiement devient définitif on-chain.