Documentation OpenAI

Fournir des conseils autorités et à jour à partir de la documentation pour développeurs OpenAI en utilisant le serveur MCP developers.openai.com. « Docs MCP » désigne mcp__openaiDeveloperDocs__search_openai_docs et mcp__openaiDeveloperDocs__fetch_openai_doc ; pour les questions de référence API, schéma, paramètre ou champ obligatoire, utilisez aussi mcp__openaiDeveloperDocs__get_openapi_spec quand disponible. La recherche web sur domaine officiel est le recours après que ces outils soient indisponibles ou inutiles. Les questions larges sur Codex utilisent l'aide manuel avant Docs MCP. Cette skill possède aussi la sélection de modèle, la migration de modèle API et l'orientation vers l'amélioration de prompt.

Configuration du workflow

Priorité des sources

Pour la connaissance autonome de Codex, utilisez la route source Codex ci-dessous ; elle décide quand utiliser l'aide manuel, Docs MCP, ou l'incertitude délimitée.
Pour les questions de documentation OpenAI non-Codex, utilisez mcp__openaiDeveloperDocs__search_openai_docs pour trouver les pages de documentation les plus pertinentes.
Pour les questions de documentation OpenAI non-Codex, récupérez la page pertinente avec mcp__openaiDeveloperDocs__fetch_openai_doc avant de répondre. Si la recherche est bruyante, exécutez une recherche Docs MCP plus ciblée ; quand une URL officielle OpenAI plausible est connue ou trouvée, essayez de récupérer cette URL via Docs MCP avant de vous fier au contenu de recherche web.
Pour les questions de référence API, schéma, paramètre ou champ obligatoire, utilisez mcp__openaiDeveloperDocs__get_openapi_spec quand disponible pour vérifier la forme API aux côtés de la page de guide ou de référence pertinente.
Utilisez mcp__openaiDeveloperDocs__list_openai_docs seulement quand vous devez parcourir ou découvrir des pages non-Codex sans requête claire.
Pour les questions de sélection de modèle, « dernier modèle » ou modèle par défaut, récupérez d'abord https://developers.openai.com/api/docs/guides/latest-model.md. Si indisponible, chargez references/latest-model.md.
Pour les mises à niveau de modèle ou de prompt, exécutez node scripts/resolve-latest-model-info.js uniquement quand la cible est latest/current/default ou autrement non spécifiée ; sinon conservez la cible explicitement demandée.
Préservez les demandes de cible explicites : si l'utilisateur nomme une cible de modèle comme « migrer vers GPT-5.4 », gardez cette cible demandée même si latest-model.md nomme un modèle plus récent. Mentionnez les conseils plus récents seulement comme optionnels.
Si les conseils distants actuels sont nécessaires, récupérez directement les URL de guide de migration et de prompting renvoyées. Si la récupération directe échoue, utilisez le recours MCP/search ; si cela échoue aussi, utilisez les références de recours regroupées et divulguez le recours.

Aperçus de produits OpenAI

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

Connaissance autonome de Codex

Utilisez ce chemin pour les questions sur Codex lui-même : configurer, étendre, exploiter, dépanner, état local, surfaces de produit, ou où le comportement de Codex doit résider. Une base de code mentionnant simplement un plugin, skill, hook, serveur MCP, navigateur ou automation ne suffit pas. Pour les tâches logicielles génériques, répondez directement à la tâche logicielle ; si demandé si la connaissance autonome de Codex s'applique, répondez brièvement à cette méta-question et continuez l'artefact demandé.

Route source

Le manuel Codex est la première source pour la synthèse large de Codex. Traitez le manuel et Docs MCP comme des voies différentes, non comme des sources de documentation officielles interchangeables. Pour les réponses de produit Codex publiées-utilisateur, la route source est complète : le manuel, Docs MCP quand cette route l'appelle, recours web officiel OpenAI, et capacités appelables surfacées dans la session actuelle quand la question concerne cette capacité. Les bases de connaissances en dehors de developers.openai.com sont en dehors de cette route pour les réponses de produit public.

Pour le comportement large de Codex, la configuration, la personnalisation, les skills, les plugins, MCP, hooks, AGENTS.md, les automations, les surfaces ou les questions de carte système :

Réutilisez un chemin de plan manuel et de même fil quand il est encore frais.
Sinon exécutez d'abord l'aide locale au skill dans les sessions normales accessibles en écriture. Ignorez-la sans essayer seulement quand la session est explicitement en lecture seule, l'exécution de shell est indisponible, ou la politique visible ne montre aucun cache temp autorisé.
Par défaut, l'aide choisit le premier répertoire de cache temp utilisable dans cet ordre : $TMPDIR/openai-docs-cache, %TEMP%\openai-docs-cache, %TMP%\openai-docs-cache, /private/tmp/openai-docs-cache, puis /tmp/openai-docs-cache. L'accès en écriture au workspace uniquement ne suffit pas pour ce cache temp.
Exécutez l'aide directement sauf si vous avez besoin de remplacer le répertoire de cache. L'aide bascule vers curl quand fetch natif est indisponible ou quand des variables d'environnement proxy sont présentes, donc aucun préfixe proxy spécifique à shell n'est requis. Résolvez <skill-dir> vers le répertoire réel de cette skill ; dans les répertoires de travail locaux eval copiés c'est généralement .codex/skills/openai-docs :

node <skill-dir>/scripts/fetch-codex-manual.mjs

Si vous devez remplacer le répertoire de cache, passez --cache-dir <cache-dir>. Sur Windows, l'aide vérifie automatiquement %TEMP% et %TMP% ; dans PowerShell, $env:TEMP\\openai-docs-cache est un remplacement explicite typique.

Traitez la disponibilité de l'aide comme établie par une politique explicite en lecture seule/sans shell ou un résultat de commande réel. Une sandbox devinée ou une échec d'aide deviné ne suffit pas à basculer vers Docs MCP ou une recherche web ; après un échec de commande d'aide réel, continuez vers la source officielle suivante la plus étroite ci-dessous.

L'aide vérifie la fraîcheur, écrit codex-manual.md et émet codex-manual.outline.md. Le plan mappe les pages source et les en-têtes aux plages de lignes ; utilisez-le pour choisir la section de manuel pertinente, puis lisez ou recherchez les sections de manuel ciblées pour les faits de produit Codex. Utilisez le répertoire skill pour localiser et exécuter l'aide ; après que l'aide réussisse, utilisez les chemins de manuel et de plan renvoyés comme portée de recherche pour les faits de produit Codex et les vérifications de couverture de terme.

Réutilisez les chemins de plan et de manuel du même fil pour les questions de suivi de Codex. Actualisez d'abord quand le manuel a été récupéré il y a plus d'environ un jour, le chemin est inutilisable, le chemin provenait d'un autre fil ou de provenance incertaine, ou l'information probablement actuelle manque et la vétusté est plausible.

Pour les questions sur si le manuel est assez actuel pour s'y fier maintenant, exécutez l'aide quand la mise en cache temporaire est autorisée et basez la réponse sur son état renvoyé, chemin de manuel et chemin de plan.

Si le manuel résout une affirmation Codex, répondez à partir de lui et arrêtez l'expansion des sources pour cette affirmation ; continuez la tâche plus large de l'utilisateur si la recherche de documentation n'était qu'une dépendance. Les pages source du manuel et les ancres connues suffisent pour supporter les citations de matériel couvert par le manuel.

Si l'aide est ignorée parce que la session est en lecture seule, n'a pas d'exécution de shell ou n'a pas de cache temp autorisé, la source suivante est Docs MCP : appelez mcp__openaiDeveloperDocs__search_openai_docs, puis mcp__openaiDeveloperDocs__fetch_openai_doc pour un résultat pertinent avant n'importe quel recours web.

Si un utilisateur nomme un terme ou mode Codex qu'un manuel frais n'utilise pas, recherchez le manuel pour les concepts adjacents évidents, puis répondez que le terme exact n'est pas documenté et utilisez la terminologie documentée la plus proche. Si la requête demande comment ce terme correspond au comportement de Codex, résolvez le mappage à partir des sections de manuel adjacentes. Si le terme exact reste matériel ou probablement actuel après cette passe de manuel, utilisez une recherche/récupération Docs MCP étroite avant l'incertitude délimitée ; sinon, la recherche source pour cette terminologie ou affirmation de mappage est complète.

Utilisez la source officielle suivante la plus étroite seulement quand le manuel est indisponible, l'aide échoue, la mise en cache temporaire n'est pas autorisée, une autre affirmation matérielle manque ou est probablement obsolète, ou l'utilisateur demande explicitement une citation spécifique à la page. Préférez une recherche Docs MCP spécifique et, si elle renvoie une page clairement pertinente, une récupération ; pour les noms de capacité Codex non résolus, acronymes, termes de planification ou texte d'erreur exact, cette étape Docs MCP est la source suivante avant la recherche web. Après le manuel plus n'importe quel remplissage de lacune Docs MCP permis, résolvez les lacunes restantes comme incertitude délimitée. Utilisez le recours web domaine officiel seulement après que ce chemin Docs MCP soit indisponible ou inutile. Si l'affirmation n'est toujours pas établie, arrêtez avec incertitude délimitée. Si la documentation officielle/manuel entre en conflit avec une capacité appelable déjà surfacée dans la session actuelle, déclarez le conflit et préférez le comportement actuel-session vérifié pour cet environnement.

Pour les slugs de modèle non documentés ou de l'apparence privée, les étiquettes de mode de produit, les étiquettes de droit, les chemins d'accès aux comptes ou les noms de déploiement, répondez à partir de la documentation publique actuelle et de l'incertitude délimitée. Ces étiquettes ne sont pas une raison de quitter la route source publique.

Pour les diagnostiques de style support, préférez une réponse couche par couche du manuel aux recherches web spécifiques au fournisseur : plugin installé/activé, autorisation d'application groupée ou connecteur, configuration MCP, politique workspace/admin, attentes de redémarrage ou de nouveau fil, puis support ou retour si toujours non résolu.

Si la route source n'établit toujours pas une affirmation, retournez incertitude délimitée ou routez vers support, un admin, ou un retour produit au lieu d'élargir l'investigation.

Pour la terminologie de produit non résolue, répondez à partir du manuel plus la source officielle suivante autorisée. Si ces sources n'établissent pas le terme, répondez avec incertitude délimitée à partir de ces sources.

Carte de surface

Quand les noms Codex ou les surfaces d'instruction durable se chevauchent, recommandez la surface la plus petite qui correspond à la portée :

Prompt ou contexte de fil -> contraintes de tâche ponctuelle.
AGENTS.md -> conventions de repo durables, commandes, étapes de vérification et attentes d'examen ; les fichiers imbriqués plus proches s'appliquent sous leur sous-arbre.
Project .codex/config.toml -> paramètres Codex repo de confiance tels que sandbox, MCP, hooks, modèle ou défauts de raisonnement.
Configuration globale ou orientation globale -> défauts personnels entre repos.
Skill -> workflow de tâche réutilisable avec références ou scripts.
Plugin -> paquet installable avec skills plus commandes, outils, configuration MCP, hooks, actifs, applications ou métadonnées de marketplace.
Serveur MCP ou connecteur d'application -> données/actions externes en direct ou données d'application/workspace privées autorisées. Utilisez les connecteurs pour les données privées Google Docs, Calendar, Slack, GitHub, Notion et similaires au lieu de la recherche web ou de la mémoire du modèle.
Automation -> vérifications planifiées, rappels, moniteurs ou travail de suivi ; utilisez un heartbeat de fil quand la continuité dans un fil existant importe.
Hook -> application du cycle de vie autour des appels d'outils, commandes ou éditions de fichiers.

Divisez les demandes à portée mixte au lieu de forcer une réponse. Exemple : « toujours faire X, mais seulement pour cette PR » définit par défaut le contexte prompt/fil pour l'exécution actuelle ; utilisez AGENTS.md ou config de projet seulement si cela devrait persister, hooks uniquement pour l'application mécanique, et automations uniquement pour le travail planifié ou de suivi.

Utilisez cette carte produit rapide si nécessaire : CLI est le travail repo local en première ligne de terminal ; l'extension IDE est le codage joint à l'éditeur ; l'application Codex est le travail de planification, examen et interactive desktop ; cloud/web est le travail parallèle/décalé hébergé ; Browser Use/navigateur in-app est le test web contrôlé par Codex ; l'extension Chrome utilise le profil Chrome de l'utilisateur ; Computer Use contrôle les applications desktop et l'interface utilisateur du système d'exploitation. Gardez les défauts config.toml, les contraintes requirements.toml et la politique gérée/admin séparées.

Limites et sortie

L'authentification par clé API n'implique pas l'accès ChatGPT, cloud task ou connecteur. Pour les échecs de plugin/app/auth, vérifiez la disponibilité du paquet, l'état installé/activé du plugin, l'autorisation du connecteur/app, la configuration MCP, les attentes de redémarrage/actualisation, la politique workspace et la disponibilité par surface avant de répondre.
Les refus de sandbox ou de réseau ont besoin d'escalade ciblée avec une justification claire. Les commandes destructrices, les écritures en dehors du workspace ou les changements d'accès larges nécessitent une approbation explicite.
La mémoire peut fournir les préférences utilisateur ou le contexte, mais les instructions prompt explicites gagnent et la mémoire n'est pas une source pour les faits externes actuels.
Pour les réponses de sélection de surface affirmatives, utilisez cette forme : recommandation, pourquoi, ce qu'il faut éviter et la preuve de manuel/source utilisée.
Quand les citations Codex spécifiques à la page sont réellement nécessaires, ces ancres s'adaptent souvent : concepts/customization#agents-guidance pour AGENTS.md, concepts/customization#skills pour les skills, plugins/build#plugin-structure pour les plugins, concepts/customization#mcp pour MCP, config-advanced#hooks pour les hooks, app/automations#thread-automations pour les automations de fil et config-reference#configtoml pour la configuration.

Si le serveur MCP manque

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

Exécutez la commande d'installation vous-même : codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
Si elle échoue en raison de permissions/sandbox, réessayez immédiatement la même commande avec des permissions escaladées et incluez une justification d'une phrase pour approbation.
Demandez à l'utilisateur d'exécuter la commande d'installation seulement si la tentative escaladée échoue.
Demandez à l'utilisateur de redémarrer Codex.
Réexécutez la recherche/récupération de documentation après le redémarrage.

Workflow

Clarifiez si la demande est une recherche générale de documentation, une sélection de modèle, une mise à niveau de chaîne de modèle, une orientation pour améliorer le prompt ou une migration API/fournisseur plus large.
Pour les demandes de connaissance autonome de Codex, suivez la procédure source de connaissance autonome de Codex ci-dessus.
Pour les demandes de sélection ou de mise à niveau de modèle, préférez la documentation distante actuelle aux références groupées quand l'utilisateur demande une orientation latest/current/default.
- Récupérez https://developers.openai.com/api/docs/guides/latest-model.md.
- Trouvez l'ID de modèle le plus récent et les liens explicites de migration ou de guidance de prompt.
- Préférez les liens explicites de la page latest-model aux URL dérivées.
- Pour les demandes de modèle nommé explicite, préservez la cible de modèle demandée. Mentionnez la guidance distante plus récente seulement comme optionnelle.
- Pour les mises à niveau dynamiques latest/current/default, exécutez node scripts/resolve-latest-model-info.js, puis récupérez directement les deux URLs de guide renvoyées quand possible.
- Si la récupération directe de guide échoue, utilisez les outils MCP de documentation pour développeurs ou la recherche officielle domaine OpenAI pour trouver le même contenu de guide.
- Si la documentation distante est indisponible, utilisez les références de recours groupées et dites que la guidance de recours a été utilisée.
Pour les mises à niveau de modèle, gardez les changements étroits : mettez à jour seulement les défauts de modèle API OpenAI actifs et les prompts directement liés quand sûr.
Laissez les documents historiques, exemples, baselines eval, fixtures, comparaisons de fournisseur, registres de fournisseur, tableaux de tarification, défauts d'alias, chemins de recours bas coût et utilisation ambiguë de modèle plus ancien inchangés sauf si l'utilisateur demande explicitement de les mettre à niveau.
Gardez les migrations SDK, tooling, IDE, plugin, shell, auth et environnement fournisseur en dehors d'une mise à niveau de modèle-et-prompt sauf si l'utilisateur demande explicitement.
Si une mise à niveau a besoin de changements de surface API, de rewiring de schéma, de changements de gestionnaire d'outils ou de travail d'implémentation au-delà d'un remplacement littéral de chaîne de modèle et d'éditions de prompt, signalez-la comme bloquée ou confirmation-nécessaire.
Pour la recherche générale de documentation, commencez par une requête de recherche compacte et de type titre de 2-6 termes essentiels. Ne transformez pas la question complète de l'utilisateur en liste de mots-clés. Récupérez la meilleure page et la section exacte nécessaire, et répondez avec des citations concises.

Carte de référence

Lisez seulement ce dont vous avez besoin :

https://developers.openai.com/api/docs/guides/latest-model.md -> sélection de modèle actuelle et questions « meilleur/dernier/modèle actuel ».
scripts/fetch-codex-manual.mjs -> récupération manuelle Codex actuelle, vérification, cache temp local et génération de plan.
https://developers.openai.com/codex/codex-manual.md -> synthèse de connaissance autonome Codex actuelle, y compris configuration, personnalisation, skills, plugins, MCP, hooks, AGENTS.md, automations et comportement de surface ; normalement y accéder via le chemin d'aide et les lectures de fichier ciblées quand la mise en cache temporaire est disponible.
references/latest-model.md -> recours groupé pour les questions de sélection de modèle et « meilleur/dernier/modèle actuel ».
references/upgrade-guide.md -> recours groupé pour les demandes de mise à niveau de modèle et de planification de mise à niveau.
references/prompting-guide.md -> recours groupé pour les réécritures de prompt et les mises à niveau de comportement de prompt.

Règles de qualité

Traitez la documentation OpenAI comme source de vérité ; évitez la spéculation.
Pour la connaissance autonome de Codex, suivez la route source ci-dessus au lieu de vous fier au comportement mémorisé.
Gardez les changements de migration étroits et préservant le comportement.
Préférez les mises à niveau prompt uniquement quand possible.
Évitez d'inventer de tarification, disponibilité, paramètres, changements API ou changements non rétro-compatibles.
Gardez les citations courtes et dans les limites de politique ; préférez la paraphrase avec citations.
Si plusieurs pages diffèrent, signalez la différence et citez les deux.
Si la documentation officielle et le comportement actuel-session appelable vérifié ne s'accordent pas, déclarez le conflit avant de faire des affirmations larges ou des éditions.
Si la documentation ne couvre pas le besoin de l'utilisateur, dites-le et proposez les étapes suivantes.

Notes sur les outils

Utilisez les outils MCP doc avant la recherche web pour les documentation markdown liées à OpenAI. Le flux de manuel Codex est l'exception : suivez la procédure source de connaissance autonome de Codex pour la synthèse large de Codex.
Si le serveur MCP est installé mais ne renvoie aucun résultat significatif, alors utilisez la recherche web comme recours.
Lors du recours à la recherche web, limitez-vous aux domaines OpenAI officiels (developers.openai.com, platform.openai.com) et citez les sources.