Historique des modifications de l’interface des plugins

Les applications ChatGPT peuvent utiliser l’URL de redirection OAuth stable https://chatgpt.com/connector_platform_oauth_redirect si leur ressource protégée et leurs métadonnées OAuth indiquent le même serveur d’autorisation et si ce serveur prend en charge l’identification de l’émetteur selon la RFC 9207.

Les applications qui utilisent des documents de métadonnées d’identifiant client (CIMD) peuvent aussi utiliser https://chatgpt.com/oauth/client.json comme identifiant client stable. Les serveurs qui ne prennent pas en charge l’identification de l’émetteur continuent de gérer les redirections comme auparavant. En savoir plus.

Le champ _meta["openai/visibility"] est désormais obsolète. Sa valeur private masque l’outil au modèle sans préciser si l’application peut y accéder. Il peut donc être difficile de savoir à qui l’outil est destiné. Utilisez _meta.ui.visibility pour choisir si l’outil est accessible au modèle, à l’application ou aux deux.

Les utilisateurs de ChatGPT peuvent désormais choisir quand les applications connectées doivent leur demander une autorisation : systématiquement, avant toute modification ou uniquement avant une modification importante. Les titulaires d’un compte personnel peuvent définir leurs préférences pour l’ensemble des applications et pour chacune d’elles. Les administrateurs Business et Enterprise gèrent les paramètres par défaut de l’espace de travail et de chaque application.

Lors de l’initialisation, ChatGPT fournit désormais les variables CSS de l’hôte définies par le standard MCP Apps via hostContext.styles.variables. Lorsque le thème de l’hôte change, ChatGPT transmet les valeurs mises à jour via ui/notifications/host-context-changed. Les applications peuvent ainsi s’adapter aux thèmes clair et sombre de ChatGPT sans coder en dur les couleurs propres à l’hôte.

Lorsque ChatGPT lance un widget, window.openai.toolResponseMetadata conserve désormais l’enveloppe canonique du résultat de l’outil MCP, y compris le champ masqué _meta.

Lorsqu’un outil nécessite l’approbation de l’utilisateur, ChatGPT attend désormais cette approbation pour transmettre au widget les données d’entrée de l’outil via la notification ui/notifications/tool-input du cycle de vie de MCP Apps. Auparavant, ChatGPT préchargeait ces données dans les variables globales du widget dès son initialisation.

ChatGPT lit désormais les instructions que le serveur MCP renvoie lors de l’initialisation. Il s’appuie sur ces instructions et sur les métadonnées des outils pour comprendre les workflows qui font intervenir plusieurs outils, les contraintes et les consignes qui s’appliquent à l’ensemble du serveur.

La documentation sur l’interface des plugins et les serveurs MCP utilise désormais outputSchema dans les exemples d’outils. Elle recommande de déclarer un schéma de sortie pour les outils qui renvoient du contenu structuré.

Les intégrations approuvées de l’Apps SDK pouvaient être distribuées sous forme de plugins Codex. Au lancement, les plugins étaient disponibles uniquement dans Codex.

window.openai.selectFiles() permet aux widgets de sélectionner des fichiers existants dans la bibliothèque de fichiers ChatGPT de l’utilisateur lorsqu’elle est disponible.

window.openai.uploadFile(file, { library: true }) permet aux widgets d’enregistrer les fichiers importés dans la bibliothèque de fichiers ChatGPT de l’utilisateur lorsqu’elle est disponible.

window.openai.uploadFile accepte désormais d’autres types de fichiers que les images.

ChatGPT est désormais entièrement compatible avec la spécification MCP Apps.

window.openai.openExternal({ href, redirectUrl }) accepte redirectUrl: false, ce qui empêche l’hôte d’ajouter ?redirectUrl=... à la fin des liens externes.

window.openai.setOpenInAppUrl({ href }) est la méthode prise en charge pour modifier la destination de « Ouvrir dans  » en mode plein écran. Sans cet appel, ChatGPT continue d’ouvrir le chemin actuel de l’iframe du widget.

Lors de la construction d’une ressource, si la propriété openai/widgetDescription est définie, elle est prise en compte et a priorité sur resource.description.

window.openai.sendFollowUpMessage accepte le paramètre scrollToBottom. Sa valeur par défaut est true. Passez false pour désactiver le défilement automatique vers le bas.

La documentation explique désormais comment assurer la compatibilité avec les connaissances de l’entreprise dans ChatGPT pour les outils search et fetch. En savoir plus.

Les appels d’outils incluent désormais _meta["openai/session"], un identifiant de conversation anonymisé qui vous permet de relier les requêtes d’une même session ChatGPT.

window.openai.requestModal({ template }) permet désormais d’ouvrir un autre modèle d’interface enregistré en lui passant l’URI du modèle fournie par registerResource.

Nous avons publié un guide qui explique comment conserver l’état dans l’interface d’un plugin.

Vous pouvez désormais copier tous les extraits de code.

Nous avons lancé un journal des modifications unifié pour les développeurs.