Aperçu
Les modèles d’applications sont un parcours de configuration destiné aux espaces de travail Business et Enterprise qui ont besoin d’une version propre à l’espace de travail d’une application ou d’un connecteur ChatGPT. Au lieu d’activer une application partagée à partir du répertoire, un administrateur ou propriétaire d’espace de travail part d’un modèle fourni par OpenAI, ajoute les détails propres à son organisation et crée un brouillon d’application à examiner.
Les modèles sont utiles lorsqu’OpenAI peut fournir le comportement commun de l’application, mais que chaque espace de travail doit fournir une configuration propre au fournisseur. Selon le modèle, cette configuration peut inclure un nom de locataire ou d’hôte, des identifiants client OAuth, des URL de rappel, des portées, des détails de webhook, des URL de serveur MCP géré ou d’autres paramètres du fournisseur. Par exemple, un modèle GitHub Enterprise peut créer le connecteur propre à l’espace de travail que Codex utilise pour accéder à l’hôte GitHub Enterprise de cette organisation.
Après la configuration, les membres n’utilisent pas le modèle d’origine. Ils utilisent l’application publiée de l’espace de travail créée à partir de celui-ci. Les administrateurs peuvent ensuite gérer cette application comme les autres applications ChatGPT, y compris l’accès selon le rôle, les contrôles des actions, les autorisations de l’application et l’autorisation du fournisseur.
Les plugiciels Codex peuvent aussi inclure des modèles d’applications ou des applications créées à partir de modèles. Si un plugiciel inclut un modèle d’application, un administrateur ou propriétaire d’espace de travail doit quand même créer et publier l’application propre à l’espace de travail avant que les membres puissent la connecter dans ChatGPT et l’utiliser par l’intermédiaire de ce plugiciel. Lorsque le plugiciel s’exécute, il utilise l’instance de l’application disponible dans cet espace de travail au lieu de demander aux membres de configurer eux-mêmes le modèle d’origine. Si le modèle requis n’a pas encore été configuré, les membres peuvent devoir demander à un administrateur de terminer d’abord la configuration. Le plugiciel ne peut pas utiliser un modèle d’application à lui seul.
Utilisez cet article pour le flux général des modèles. Pour la configuration propre au fournisseur, consultez :
Les modèles sont utiles lorsque le même modèle d’application peut fonctionner dans de nombreuses organisations, mais que chaque organisation a besoin de sa propre configuration.
Exemples courants :
L’URL du fournisseur comprend un locataire, un compte, une organisation ou un nom d’hôte d’espace de travail de l’entreprise.
L’organisation doit fournir son propre client OAuth ou ses propres identifiants de fournisseur.
Le fournisseur exige une configuration d’URL de rappel propre au client.
L’application devrait utiliser le même modèle d’implémentation, tandis que chaque espace de travail contrôle séparément l’accès, les actions et les paramètres de sécurité.
Différences entre les modèles et les applications régulières
Une application régulière peut généralement être activée directement à partir du répertoire des applications. Un modèle lance plutôt un flux de configuration.
Le flux habituel est le suivant :
Un administrateur trouve un modèle dans le répertoire des applications.
L’administrateur saisit la configuration requise propre à l’espace de travail.
ChatGPT crée un brouillon d’application pour l’espace de travail.
L’administrateur examine et publie le brouillon.
L’administrateur configure l’accès et les paramètres d’action de l’application publiée.
Les membres utilisent l’application publiée de l’espace de travail, et non le modèle d’origine.
Trouver et configurer un modèle d’application
Ouvrez Paramètres de l’espace de travail > Applications.
Sélectionnez Répertoire.
Recherchez le fournisseur ou le nom de l’application.
Repérez les entrées marquées comme modèles.
Sélectionnez Activer pour lancer le flux de configuration.
Le flux de configuration demande les détails nécessaires pour créer l’application propre à l’espace de travail. Les champs exacts dépendent du modèle.
Par exemple, un modèle GitHub Enterprise peut demander des détails comme :
Nom et description de l’application.
Nom d’hôte GitHub Enterprise.
Configuration de l’URL de rappel.
ID client OAuth et secret client.
Clé privée de l’application GitHub.
Portées demandées.
Détails de configuration du webhook.
Examinez attentivement chaque champ avant de créer le brouillon. Si votre organisation gère OAuth ou les identifiants de fournisseur de façon centralisée, coordonnez-vous avec l’équipe responsable de ces identifiants.
Consultez les instructions propres à l’application : GitHub, Snowflake et Databricks.
Configuration du client OAuth
Certains modèles exigent que votre organisation fournisse son propre client OAuth. Lorsque c’est requis, créez ou configurez l’application OAuth dans la console d’administration du fournisseur externe, puis copiez l’URL de rappel de ChatGPT dans les paramètres d’URL de redirection ou de rappel du fournisseur.
Saisissez l’ID et le secret du client OAuth dans ChatGPT seulement après avoir confirmé que la configuration du fournisseur correspond aux instructions de configuration du modèle.
Si le modèle inclut des portées par défaut, conservez-les, sauf si votre organisation a examiné les autorisations du fournisseur et a une raison claire de les modifier.
Créer un brouillon
Après avoir saisi les renseignements requis, sélectionnez Créer un brouillon.
La création d’un brouillon ne rend pas automatiquement l’application accessible aux membres. Examinez le brouillon, publiez-le, puis configurez les paramètres d’accès et d’action avant de demander aux membres de l’utiliser.
Publier et gérer l’application obtenue
Après la publication, gérez l’application propre à l’espace de travail à partir de Paramètres de l’espace de travail > Applications > Activées.
Vérifications recommandées après la publication :
Confirmez que l’application apparaît dans Applications activées.
Définissez l’Accès des utilisateurs pour les rôles qui doivent utiliser l’application.
Passez en revue le Contrôle des actions pour les actions de lecture et d’écriture.
Passez en revue les Autorisations de l’application pour choisir quand ChatGPT demande aux membres avant d’utiliser l’application.
Demandez à un utilisateur test autorisé d’ouvrir Applications dans ChatGPT et de confirmer que l’application apparaît.
Si l’application exige une authentification auprès du fournisseur, demandez à l’utilisateur test de connecter son compte de fournisseur.
Exécutez une invite de test à faible risque pour confirmer que l’application fonctionne comme prévu.
Ces autorisations d’application s’appliquent aux conversations ChatGPT. Les agents d’espace de travail utilisent des contrôles propres à chaque agent, définis par le créateur de l’agent, pour déterminer quelles actions d’application sont disponibles et quand les utilisateurs finaux doivent les approuver. Pour le comportement des agents, consultez : Agents d’espace de travail ChatGPT pour Enterprise et Business.
Si un modèle ne peut être utilisé qu’une seule fois
Certains modèles peuvent ne créer qu’une seule application par espace de travail. Si un modèle a déjà été utilisé, le bouton Activer peut ne pas être disponible. Dans ce cas, gérez le brouillon ou l’application publiée existants au lieu d’en créer un autre à partir du même modèle.
Ce que voient les membres
Les membres voient l’application publiée créée à partir du modèle. La possibilité pour un membre de la voir ou de l’utiliser dépend des paramètres de l’espace de travail et de l’autorisation du fournisseur. Si l’application est incluse dans un plugiciel, les membres peuvent y accéder par l’intermédiaire de ce plugiciel, mais les mêmes exigences d’accès à l’espace de travail et d’autorisation du fournisseur s’appliquent toujours.
Vérifiez que :
L’application est publiée.
L’application est activée pour l’espace de travail.
Le rôle du membre dans l’espace de travail y donne accès.
Le membre se trouve dans le bon espace de travail.
Le membre dispose des autorisations requises auprès du fournisseur externe.
Les applications publiées apparaîtront dans le répertoire des applications ChatGPT, dans la section propre à l’espace de travail.
Dépannage
Si la configuration échoue ou que l’application n’apparaît pas, vérifiez les éléments suivants :
Le nom d’hôte du locataire, du compte ou de l’espace de travail est correct.
L’URL de rappel a été copiée exactement dans la configuration du fournisseur.
L’ID client OAuth et le secret client sont corrects.
Les portées demandées correspondent à ce que l’application OAuth du fournisseur autorise.
Un brouillon a été créé.
Le brouillon a été publié.
L’accès selon le rôle permet à l’utilisateur test de voir l’application.
Les autorisations côté fournisseur permettent les données ou l’action testées.
Notes de sécurité
Traitez les secrets client OAuth et les identifiants du fournisseur comme des renseignements sensibles.
Passez en revue les portées demandées avant de créer le brouillon.
Utilisez le Contrôle des actions après la publication pour limiter ce que l’application peut faire.
Utilisez les Autorisations de l’application pour décider quand ChatGPT demande aux membres avant d’utiliser l’application.
Notez que les autorisations du fournisseur s’appliquent toujours après l’activation de l’application dans ChatGPT.