Documentation OpenAI

Fournir des conseils faisant autorité et à jour à partir de la documentation des développeurs OpenAI en utilisant le serveur MCP developers.openai.com. Toujours privilégier les outils MCP de la documentation des développeurs plutôt que web.run pour les questions liées à OpenAI. Cette compétence gère également la sélection de modèles, la migration de modèles API et les conseils de mise à niveau de prompts. Seulement si le serveur MCP est installé et ne retourne pas de résultats probants, basculer vers la recherche web.

Démarrage rapide

Utiliser mcp__openaiDeveloperDocs__search_openai_docs pour trouver les pages de documentation les plus pertinentes.
Utiliser mcp__openaiDeveloperDocs__fetch_openai_doc pour extraire des sections exactes et citer/paraphraser avec précision.
Utiliser mcp__openaiDeveloperDocs__list_openai_docs uniquement quand vous devez parcourir ou découvrir des pages sans requête claire.
Pour les questions de sélection de modèles, « dernier modèle » ou modèle par défaut, récupérer d'abord https://developers.openai.com/api/docs/guides/latest-model.md. Si indisponible, charger references/latest-model.md.
Pour les mises à niveau de modèles ou de prompts, exécuter node scripts/resolve-latest-model-info.js uniquement quand la cible est latest/current/default ou non spécifiée ; sinon préserver la cible explicitement demandée.
Préserver les demandes de cible explicite : si l'utilisateur nomme un modèle cible comme « migrer vers GPT-5.4 », conserver cette cible demandée même si latest-model.md nomme un modèle plus récent. Mentionner les conseils plus récents seulement comme option.
Si des conseils distants actuels sont nécessaires, récupérer directement les URLs des guides de migration et de prompting retournés. Si la récupération directe échoue, utiliser la solution de secours MCP/recherche ; si celle-ci échoue aussi, utiliser les références de secours intégrées et divulguer la solution de secours.

Aperçus des produits OpenAI

Apps SDK : Créer des applications ChatGPT en fournissant une UI composant web et un serveur MCP exposant les outils de votre application à ChatGPT.
Responses API : Un endpoint unifié conçu pour les interactions stateful, multimodales et utilisant des outils dans les workflows agentiques.
Chat Completions API : Générer une réponse de modèle à partir d'une liste de messages constituant une conversation.
Codex : Agent de codage OpenAI pour le développement logiciel capable d'écrire, comprendre, examiner et déboguer du code.
gpt-oss : Modèles de raisonnement OpenAI de poids ouvert (gpt-oss-120b et gpt-oss-20b) publiés sous la licence Apache 2.0.
Realtime API : Construire des expériences à faible latence, multimodales incluant des conversations naturelles synthèse vocale-à-synthèse vocale.
Agents SDK : Un kit d'outils pour construire des applications agentiques où un modèle peut utiliser des outils et du contexte, déléguer à d'autres agents, streamer des résultats partiels et conserver une trace complète.

Si le serveur MCP est absent

Si les outils MCP échouent ou qu'aucune ressource de documentation OpenAI n'est disponible :

Exécuter vous-même la commande d'installation : codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
Si cela échoue en raison de permissions/sandboxing, réessayer immédiatement la même commande avec des permissions élevées et inclure une justification d'une phrase pour approbation. Ne pas demander à l'utilisateur de l'exécuter encore.
Seulement si la tentative avec permissions élevées échoue, demander à l'utilisateur d'exécuter la commande d'installation.
Demander à l'utilisateur de redémarrer Codex.
Relancer la recherche/récupération de documentation après redémarrage.

Flux de travail

Clarifier si la demande est une recherche générale de documentation, une sélection de modèles, une mise à niveau de chaîne de modèles, des conseils de mise à niveau de prompt, ou une migration plus large API/fournisseur.
Pour les demandes de sélection ou de mise à niveau de modèles, privilégier la documentation distante actuelle plutôt que les références intégrées quand l'utilisateur demande des conseils latest/current/default.
- Récupérer https://developers.openai.com/api/docs/guides/latest-model.md.
- Trouver l'ID du dernier modèle et les liens de migration explicites ou de conseils de prompt.
- Privilégier les liens explicites de la page latest-model plutôt que les URLs dérivées.
- Pour les demandes de modèles nommés explicites, préserver la cible de modèle demandée et ne pas rediriger silencieusement vers le dernier modèle. Mentionner les conseils distants plus récents seulement comme option.
- Pour les mises à niveau latest/current/default dynamiques, exécuter node scripts/resolve-latest-model-info.js, puis récupérer directement les deux URLs de guides retournées quand possible.
- Si la récupération directe du guide échoue, utiliser les outils MCP de documentation des développeurs ou la recherche officielle sur domaine OpenAI pour trouver le même contenu de guide.
- Si la documentation distante est indisponible, utiliser les références de secours intégrées et dire que les conseils de secours ont été utilisés.
Pour les mises à niveau de modèles, garder les changements étroits : mettre à jour uniquement les modèles API OpenAI actifs par défaut et les prompts directement liés quand c'est sûr.
Laisser inchangés la documentation historique, les exemples, les baselines d'évaluation, les fixtures, les comparaisons de fournisseurs, les registres de fournisseurs, les tableaux de tarification, les defaults d'alias, les chemins de secours à bas coût et l'utilisation ambigu de modèles plus anciens sauf si l'utilisateur demande explicitement une mise à niveau.
Ne pas effectuer de migrations SDK, outillage, IDE, plugin, shell, auth ou environnement de fournisseur dans le cadre d'une mise à niveau de modèle et prompt.
Si une mise à niveau nécessite des changements de surface API, un recâblage de schéma, des changements de gestionnaire d'outils ou un travail d'implémentation au-delà d'un remplacement littéral de chaîne de modèles et d'édits de prompts, la signaler comme bloquée ou confirmation nécessaire.
Pour la recherche générale de documentation, chercher la documentation avec une requête précise, récupérer la meilleure page et la section exacte nécessaire, et répondre avec des citations concises.

Carte de référence

Lire uniquement ce dont vous avez besoin :

https://developers.openai.com/api/docs/guides/latest-model.md -> sélection de modèles actuelle et questions de « meilleur/dernier/modèle actuel ».
references/latest-model.md -> secours intégré pour sélection de modèles et questions de « meilleur/dernier/modèle actuel ».
references/upgrade-guide.md -> secours intégré pour demandes de mise à niveau de modèles et de planification de mise à niveau.
references/prompting-guide.md -> secours intégré pour réécriture de prompts et mises à niveau de comportement de prompt.

Règles de qualité

Traiter la documentation OpenAI comme source de vérité ; éviter la spéculation.
Garder les changements de migration étroits et préservant le comportement.
Privilégier les mises à niveau sur prompt uniquement quand possible.
Ne pas inventer de tarification, disponibilité, paramètres, changements API ou breaking changes.
Garder les citations courtes et dans les limites de politique ; préférer la paraphrase avec citations.
Si plusieurs pages diffèrent, signaler la différence et citer les deux.
Si la documentation officielle et le comportement du repo ne s'accordent pas, énoncer le conflit et arrêter avant de faire des édits larges.
Si la documentation ne couvre pas le besoin de l'utilisateur, le dire et offrir les prochaines étapes.

Notes d'outillage

Toujours utiliser les outils MCP de documentation avant toute recherche web pour les questions liées à OpenAI.
Si le serveur MCP est installé mais ne retourne pas de résultats probants, alors utiliser la recherche web comme solution de secours.
Lors du basculement vers la recherche web, restreindre aux domaines OpenAI officiels (developers.openai.com, platform.openai.com) et citer les sources.

openai-docs