Spécification des plugins de finalisation de commande

Objectif

Nous voulons permettre à ChatGPT d’appeler directement les plugins de nos partenaires lorsque l’utilisateur manifeste une forte intention d’achat, par exemple au moment de finaliser une commande.

Une fois qu’un partenaire nous a fourni un flux de produits pour la recherche, nous pouvons connecter ses serveurs MCP pour exécuter les dernières étapes du parcours d’achat. Pour cela, les plugins partenaires doivent respecter un contrat commun qui définit le nom du widget, le nom de l’outil et les données d’entrée de l’outil.

Pour créer un plugin conforme à cette spécification, demandez l’accès via le formulaire ChatGPT pour les marchands.

Expérience utilisateur

Lorsqu’un utilisateur recherche des produits, le panneau latéral de la fiche produit peut afficher des boutons Ouvrir pour les différents vendeurs. Si un vendeur dispose d’un plugin, ChatGPT peut l’ouvrir dans la conversation pour permettre à l’utilisateur de finaliser sa commande sans se rendre sur un site externe.

Contrat actuellement requis

• Nom du widget : ui://widget/checkout-session.html
• Nom de l’outil : checkout_session

checkout_session doit définir la propriété suivante :

_meta.ui.resourceUri = "ui://widget/checkout-session.html";

Tout outil appelé directement depuis un widget doit définir la propriété suivante :

_meta["openai/widgetAccessible"] = true;

Données d’entrée de checkout_session

Pour chaque article de la commande, seuls les champs id et quantity sont obligatoires. Le champ offerId et les métadonnées de l’offre sélectionnée chez le marchand sont facultatifs :

{
  "checkout_session": {
    "items": [
      {
        "id": "string",
        "quantity": 1,
        "offerId": "string",
        "name": "Wireless headphones",
        "description": "Wireless headphones with noise cancellation.",
        "images": [
          "https://merchant.example.com/images/headphones.jpg",
          "https://merchant.example.com/images/headphones-side.jpg"
        ],
        "url": "https://merchant.example.com/products/headphones",
        "merchant_name": "Example Merchant",
        "price": "$24.99"
      }
    ]
  }
}

Les champs suivants sont facultatifs pour chaque article :

images contient zéro, une ou plusieurs URL issues du flux du marchand sélectionné. Si la liste contient au moins une URL, ChatGPT affiche l’image correspondant à la première URL comme image principale. ChatGPT omet les champs facultatifs dont la valeur est indisponible. Il ne génère pas de description et n’utilise ni la description ni les images d’un autre marchand. Déclarez ces champs comme facultatifs dans le schéma d’entrée de votre outil. Utilisez les identifiants de l’article commandé et de l’offre pour récupérer dans votre propre catalogue les données de référence sur le produit, les stocks et les prix.

La structure de la session de commande imbriquée correspond à celle que décrit la spécification Commerce des sessions de commande.