Aller au contenu
Retour à Systèmes d'agents et standards

Systèmes d'agents et standards · Chapitre 4 sur 8

Des agents qui paient : UCP et AP2

Comment un agent passe commande chez un marchand avec UCP, et comment les mandats AP2 lient le paiement à ce que la personne a signé.

25 minutes0 objectifs sur 4 atteints

Objectifs

  • Créez et terminez une session de paiement.À faire
  • Signez les mandats sur le téléphone.À faire
  • Modifiez le montant après la signature et voyez la vérification échouer.À faire
  • Réussissez la vérification.À faire

Étape 1 sur 4 : La lecture

UCP : le paiement

UCP (Universal Commerce Protocol, version 2026-08-25) est la façon dont un agent d'achat, la plateforme, achète chez un marchand, l'entreprise. L'entreprise publie un profil à /.well-known/ucp : sa version, ses capacités comme checkout, ses gestionnaires de paiement et son endpoint REST. L'agent le lit, puis crée une session de paiement avec POST /checkout-sessions, la met à jour avec PUT jusqu'à ce que le statut soit ready_for_complete, et termine avec POST …/complete.

Chaque appel porte un en-tête UCP-Agent qui pointe vers le profil de la plateforme, pour que l'entreprise puisse vérifier ce que la plateforme prend en charge. Chaque écriture porte une Idempotency-Key : si un délai dépassé pousse l'agent à renvoyer la même requête, l'entreprise répond avec le premier résultat au lieu d'agir deux fois. Un double prélèvement comme celui de la commande 48213 de Halden est exactement ce qu'elle empêche.

AP2 : la signature de la personne

UCP seul fait confiance à quiconque détient la session. AP2 (Agent Payments Protocol) ajoute une preuve de consentement. Le fournisseur de l'agent émet deux mandats sous forme de verifiable credentials SD-JWT : un mandat de commande qui contient un hash de la commande exacte que Halden a signée, et un mandat de paiement qui contient le montant, le bénéficiaire et la carte. La personne les examine sur un écran où l'agent ne peut pas dessiner, le portefeuille de son téléphone, et la clé du téléphone signe un JWT de key binding sur chacun.

Halden compare le mandat de commande à la commande qu'il a signée. Le portefeuille de cartes vérifie le mandat de paiement avant d'émettre un token de paiement pour ce montant, et le processeur vérifie le token avant de débiter. Modifiez le panier ou le montant après la signature de la personne, et un hash ou une signature ne correspond plus, quoi que dise l'agent.

Ici, la personne est présente. Dans le mode autonome d'AP2, elle ne l'est pas : elle approuve à l'avance des mandats ouverts, avec des limites comme un prix maximum, et l'agent signe les mandats finaux dans ces limites.

ANP, en deux phrases

ANP (Agent Network Protocol) sert aux agents qui se rencontrent sur le web ouvert : chaque agent a un identifiant did:wba dont le document DID, servi depuis son propre domaine, liste ses clés publiques. Chaque requête est signée avec HTTP Message Signatures, donc l'autre partie sait quel agent l'a envoyée sans compte. Les labs ANP de l'étape Aller plus loin le font tourner.

Ce que vous faites ici

Un agent d'achat achète la tente Ridge 2 de Halden. Suivez le paiement, approuvez sur le téléphone, puis relancez avec Intercepter activé et augmentez le montant après la signature.

Étape 2 sur 4 : Essayez : Une chaîne de signatures

Une chaîne de signatures

Cinq étapes, puis deux facultatives. Sous les étapes, la chaîne ajoute chaque maillon de l'achat quand l'achat l'atteint, avec qui le vérifie. Sous la chaîne, le lab dessine chaque message comme une ligne, de haut en bas.

Mode :RéelSimuléRéel : le binding REST d'UCP (écrit d'après la spécification, sans SDK), les mandats SD-JWT d'AP2 (@sd-jwt/sd-jwt-vc 0.21.1) et les signatures ES256 avec des clés WebCrypto créées dans cette page, et les requêtes signées d'ANP dans les labs Aller plus loin. Simulé : le règlement, et les décisions de l'agent sauf si vous connectez un modèle. La boutique et les cartes sont fictives.

Étape 3 sur 4 : Vérification

Vérification

Question 1 sur 4Que lie un mandat de commande AP2 ?

Ensuite : Question 2 sur 4

Question 2 sur 4L'agent augmente le montant après la signature de la personne. Où cela échoue-t-il ?
Question 3 sur 4Qu'empêche l'Idempotency-Key d'UCP ?
Question 4 sur 4Pourquoi la personne approuve-t-elle dans le portefeuille de son téléphone plutôt que dans le chat de l'agent ?

Étape 4 sur 4 : Ce que vous savez faire maintenant

Ce que vous savez faire maintenant

  • Suivre une session de paiement UCP du profil jusqu'à completed.
  • Expliquer comment les mandats AP2 lient un paiement au consentement signé d'une personne.
  • Utiliser des clés d'idempotence pour rendre les nouvelles tentatives sûres.
  • Dire en deux phrases ce qu'apportent le did:wba et les requêtes signées d'ANP.