Connecter l’application de bureau ChatGPT

Utilisez l’agent Codex dans l’application de bureau ChatGPT avec des modèles, des outils MCP et des compétences via Unity Gateway. Les abonnements ChatGPT ne sont pas pris en charge via Unity Gateway.

Prerequisites

Vous avez besoin de l’URL de votre espace de travail Azure Databricks, de l’accès aux modèles et outils que vous souhaitez utiliser, ainsi que de la dernière version de ChatGPT desktop.

Si votre administrateur a déjà configuré votre appareil, suivez les instructions de lancement de votre organisation.

Installez ug, puis exécutez cette commande dans un terminal interactif :

ug configure --agents codex

Sélectionnez votre espace de travail et connectez-vous. Cette commande configure à la fois l’interface CLI Codex et l’assistant de travail installé dans l’application de bureau ChatGPT pour le même espace de travail. Si vous le demandez, approuvez la mise à jour de configuration système avec le mot de passe de votre appareil. ug configure la connexion Unity Gateway et le rafraîchissement du jeton OAuth.

Sous Windows, exécutez la commande depuis un terminal ouvert avec les droits administrateur. L’application de bureau ChatGPT sous Windows nécessite Codex 0.156.0 ou une version ultérieure pour appliquer cette configuration.

Ouvrez ou redémarrez l’application de bureau ChatGPT, puis lancez une conversation Codex. Utilisez le sélecteur de modèles pour changer de modèle.

Ajouter des outils et compétences MCP

Utilisez ug pour ajouter les serveurs MCP et les compétences disponibles via votre espace de travail :

ug mcp add --agents codex
ug skills add

Ouvrez ou redémarrez l’application de bureau ChatGPT après la configuration. Entrez /mcp pour vérifier les connexions MCP. Les compétences sont disponibles à partir de ~/.agents/skills/.

Pour la configuration manuelle du modèle, du MCP et des skills, voir Connect Codex. Ces paramètres s’appliquent à la fois à la ligne de commande Codex et à l’application de bureau ChatGPT.

Limitations

Cette configuration configure à la fois le Codex CLI et l’application de bureau ChatGPT. La configuration s’applique à toutes les conversations dans les deux outils, et leurs requêtes d’inférence sont acheminées via Unity Gateway.

ChatGPT pour le bureau prend en charge les modèles ouverts via Unity Gateway. Le routage intelligent n’est pas pris en charge dans l’application de bureau ChatGPT.

Troubleshooting

  • L’application de bureau ChatGPT demande de se connecter à OpenAI : Relancer ug configure --agents codex de façon interactive et compléter la mise à jour de configuration du système. Sous Windows, exécutez-le depuis un terminal surélevé. Le profil CLI seul ne configure pas l’application de bureau ChatGPT. Pour la configuration manuelle, vérifiez que model_provider se trouve au niveau supérieur et que requires_openai_auth = false figure dans la table des fournisseurs. N’ajoutez pas ce drapeau à un fournisseur qui utilise une table auth pour le rafraîchissement des tokens OAuth.

  • Un modèle manque : Vérifiez vos autorisations de modèle. Définissez model sur son nom complet dans Unity Catalog dans la configuration active et démarrez une nouvelle conversation.

  • Une connexion MCP ou Skill échoue : Vérifiez l’URL, les permissions et l’erreur du connecteur. Pour les connexions manuelles, vérifiez également l’expiration du jeton. Pour les ug problèmes de configuration, exécutez ug doctor.

  • La connexion Workspace fonctionne, mais un outil vous demande de vous connecter : Ouvrez le lien de connexion envoyé par le MCP, connectez-vous au fournisseur externe, puis réessayez l’appel. La connexion à l’espace de travail et la connexion au fournisseur sont des étapes distinctes.

Étapes suivantes