Documentation OpenAI
Fournir des conseils autorisés et actuels à partir de la documentation des développeurs OpenAI en utilisant le serveur MCP developers.openai.com. Toujours privilégier les outils MCP de documentation des développeurs par rapport à web.run pour les questions liées à OpenAI. Cette compétence couvre également la sélection de modèles, la migration de modèles d'API et les conseils de mise à niveau des invites. Ce n'est que si le serveur MCP n'est pas installé et ne retourne aucun résultat significatif que vous devriez basculer vers une recherche web.
Démarrage rapide
- Utiliser
mcp__openaiDeveloperDocs__search_openai_docspour trouver les pages de documentation les plus pertinentes. - Utiliser
mcp__openaiDeveloperDocs__fetch_openai_docpour extraire les sections exactes et citer/paraphraser avec précision. - Utiliser
mcp__openaiDeveloperDocs__list_openai_docsuniquement quand vous avez besoin de parcourir ou découvrir des pages sans requête claire. - Pour la sélection de modèles, les questions sur le « dernier modèle » ou le modèle par défaut, récupérer d'abord
https://developers.openai.com/api/docs/guides/latest-model.md. Si celui-ci n'est pas disponible, chargerreferences/latest-model.md. - Pour les mises à niveau de modèles ou d'invites, exécuter
node scripts/resolve-latest-model-info.jsuniquement quand la cible est latest/current/default ou autrement non spécifiée ; autrement 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.mdnomme un modèle plus récent. Mentionner les conseils plus récents uniquement comme optionnels. - Si des conseils à distance actuels sont nécessaires, récupérer directement les URL de migration et de guide d'invite renvoyées. Si la récupération directe échoue, utiliser le fallback MCP/recherche ; si cela échoue aussi, utiliser les références de fallback groupées et divulguer le fallback.
Aperçus des produits OpenAI
- Apps SDK : Créer des applications ChatGPT en fournissant une interface utilisateur de composant web et un serveur MCP qui expose les outils de votre application à ChatGPT.
- Responses API : Un point de terminaison unifié conçu pour les interactions apatrides, multimodales et utilisant des outils dans les flux de travail d'agents.
- Chat Completions API : Générer une réponse du 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 OpenAI à poids ouvert (gpt-oss-120b et gpt-oss-20b) publiés sous la licence Apache 2.0.
- Realtime API : Créer des expériences à faible latence et multimodales incluant des conversations naturelles de synthèse vocale à synthèse vocale.
- Agents SDK : Un kit d'outils pour créer des applications d'agents où un modèle peut utiliser des outils et du contexte, déléguer à d'autres agents, diffuser des résultats partiels et conserver une trace complète.
Si le serveur MCP manque
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 - S'il échoue en raison de permissions/sandboxing, relancer immédiatement la même commande avec des permissions élevées et inclure une justification d'une phrase pour l'approbation. Ne pas demander à l'utilisateur de l'exécuter encore.
- Uniquement 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 le redémarrage.
Flux de travail
- Clarifier si la demande est une consultation générale de documentation, une sélection de modèle, une mise à niveau de chaîne de modèle, des conseils de mise à niveau d'invite, ou une migration plus large d'API/fournisseur.
- Pour les demandes de sélection ou mise à niveau de modèles, préférer la documentation à distance actuelle aux références groupé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 explicites de migration ou de conseils d'invite.
- Préférer les liens explicites de la page latest-model aux URL dérivées.
- Pour les demandes de modèle nommé explicite, préserver la cible de modèle demandée et ne pas rediriger silencieusement vers le dernier modèle. Mentionner les conseils à distance plus récents uniquement comme optionnels.
- Pour les mises à niveau dynamiques latest/current/default, exécuter
node scripts/resolve-latest-model-info.js, puis récupérer directement les deux URL de guide 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 sur le domaine OpenAI officiel pour trouver le même contenu de guide.
- Si la documentation à distance n'est pas disponible, utiliser les références de fallback groupées et indiquer que les conseils de fallback ont été utilisés.
- Récupérer
- Pour les mises à niveau de modèles, garder les changements limités : mettre à jour les défauts de modèle OpenAI API actifs et les invites directement associées uniquement quand c'est sûr.
- Laisser la documentation historique, les exemples, les lignes de base d'évaluation, les fixtures, les comparaisons de fournisseurs, les registres de fournisseurs, les tableaux de tarification, les alias par défaut, les chemins de fallback à faible coût et l'utilisation de modèle plus ancien ambiguë inchangés sauf si l'utilisateur demande explicitement de les mettre à niveau.
- Ne pas effectuer de migrations SDK, outillage, IDE, plugin, shell, authentification ou environnement de fournisseur dans le cadre d'une mise à niveau de modèle et d'invite.
- Si une mise à niveau nécessite des changements de surface API, un reparamétrage 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èle et d'éditions d'invite, le signaler comme bloqué ou nécessitant une confirmation.
- Pour une consultation générale de documentation, rechercher dans 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-> questions actuelles de sélection de modèle et « meilleur/dernier/modèle courant ».references/latest-model.md-> fallback groupé pour les questions de sélection de modèle et « meilleur/dernier/modèle courant ».references/upgrade-guide.md-> fallback groupé pour les demandes de mise à niveau de modèle et de planification de mise à niveau.references/prompting-guide.md-> fallback groupé pour les réécritures d'invite et les mises à niveau de comportement d'invite.
Règles de qualité
- Traiter la documentation OpenAI comme source de vérité ; éviter la spéculation.
- Garder les changements de migration limités et préservant le comportement.
- Préférer les mises à niveau basées sur l'invite uniquement quand possible.
- Ne pas inventer de tarification, disponibilité, paramètres, changements d'API ou changements de rupture.
- 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 dépôt sont en désaccord, déclarer le conflit et arrêter avant d'effectuer des éditions étendues.
- Si la documentation ne couvre pas le besoin de l'utilisateur, le dire et proposer 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 aucun résultat significatif, utiliser la recherche web comme fallback.
- Quand basculer vers la recherche web, restreindre aux domaines OpenAI officiels (developers.openai.com, platform.openai.com) et citer les sources.