openai-docs

OpenAI-Dokumentationen

Bieten Sie autoritative, aktuelle Anleitungen aus den OpenAI-Entwicklerdokumentationen unter Verwendung des MCP-Servers developers.openai.com. "Docs MCP" bedeutet mcp__openaiDeveloperDocs__search_openai_docs und mcp__openaiDeveloperDocs__fetch_openai_doc; für API-Referenz-, Schema-, Parameter- oder Pflichtfeld-Fragen verwenden Sie auch mcp__openaiDeveloperDocs__get_openapi_spec, falls verfügbar. Die Websuche auf offiziellen Domains ist ein Fallback, nachdem diese Tools nicht verfügbar oder nicht hilfreich waren. Breite Codex-Fragen verwenden den manuellen Helfer vor Docs MCP. Dieses Skill ist auch für die Modellauswahl, API-Modellmigration und Prompt-Upgrade-Anleitung zuständig.

API-Schlüssel-Einrichtung

Verwenden Sie für Anfragen zum Erstellen, Ausführen, Konfigurieren, Debuggen oder Implementieren einer API-gestützten App, eines Skripts, einer CLI, eines Generators oder eines Tools zuerst openai-platform-api-key, wenn verfügbar. Nachdem diese Berechtigungsprüfung abgeschlossen ist, kehren Sie hierher zurück, um bei Bedarf aktuelle Dokumentationen zu erhalten.

Verwenden Sie dieses Skill direkt für reine Dokumentationsfragen, Zitatanfragen, Modell-/API-Anleitungen, konzeptionelle Erklärungen und Beispiele, die kein Erstellen oder Ausführen eines API-gestützten Artefakts erfordern.

Workflow-Konfiguration

Quellenpriorität

• Verwenden Sie für Codex-Selbstwissen den unten stehenden Codex-Quellenpfad; dieser entscheidet, wann der manuelle Helfer, Docs MCP oder begrenzte Unsicherheit verwendet wird.
• Verwenden Sie für Nicht-Codex-OpenAI-Dokumentationsfragen mcp__openaiDeveloperDocs__search_openai_docs, um die relevantesten Dokumentationsseiten zu finden.
• Rufen Sie für Nicht-Codex-OpenAI-Dokumentationsfragen die relevante Seite mit mcp__openaiDeveloperDocs__fetch_openai_doc ab, bevor Sie antworten. Wenn die Suche verrauscht ist, führen Sie eine engere Docs-MCP-Suche durch; wenn eine plausible offizielle OpenAI-Dokumentations-URL bekannt oder gefunden ist, versuchen Sie, diese URL über Docs MCP abzurufen, bevor Sie sich auf Web-Suchinhalte verlassen.
• Verwenden Sie für API-Referenz-, Schema-, Parameter- oder Pflichtfeld-Fragen mcp__openaiDeveloperDocs__get_openapi_spec, wenn verfügbar, um die API-Struktur zusammen mit der relevanten Anleitung oder Referenzseite zu überprüfen.
• Verwenden Sie mcp__openaiDeveloperDocs__list_openai_docs nur, wenn Sie Nicht-Codex-Seiten ohne eine klare Abfrage durchsuchen oder entdecken müssen.
• Rufen Sie für Fragen zur Modellauswahl, zum "neuesten Modell" oder zu Standardmodellen zuerst https://developers.openai.com/api/docs/guides/latest-model.md ab. Wenn dies nicht verfügbar ist, laden Sie references/latest-model.md.
• Führen Sie für Modell-Upgrades oder Prompt-Upgrades node scripts/resolve-latest-model-info.js nur aus, wenn das Ziel das neueste/aktuelle/Standardmodell oder anderweitig nicht spezifiziert ist; bewahren Sie andernfalls das explizit angeforderte Ziel.
• Bewahren Sie explizite Zielanfragen: Wenn der Benutzer ein Zielmodell wie "zu GPT-5.4 migrieren" nennt, behalten Sie dieses angeforderte Ziel bei, auch wenn latest-model.md ein neueres Modell nennt. Erwähnen Sie neuere Anleitungen nur als optional.
• Wenn aktuelle Remote-Anleitungen benötigt werden, rufen Sie sowohl die zurückgegebenen Migrations- als auch die Prompting-Anleitungs-URLs direkt ab. Wenn der direkte Abruf fehlschlägt, verwenden Sie MCP/Suche-Fallback; wenn auch das fehlschlägt, verwenden Sie gebündelte Fallback-Referenzen und geben Sie den Fallback an.

OpenAI-Produktübersichten

1. Apps SDK: Erstellen Sie ChatGPT-Apps, indem Sie eine Webkomponenten-Benutzeroberfläche und einen MCP-Server bereitstellen, der die Tools Ihrer App für ChatGPT verfügbar macht.
2. Responses API: Ein einheitlicher Endpunkt, der für zustandsbehaftete, multimodale, werkzeugnutzende Interaktionen in agentischen Workflows konzipiert ist.
3. Chat Completions API: Generieren Sie eine Modellantwort aus einer Liste von Nachrichten, die eine Unterhaltung bilden.
4. Codex: OpenAIs Coding-Agent für die Softwareentwicklung, der Code schreiben, verstehen, überprüfen und debuggen kann.
5. gpt-oss: Open-Weight-OpenAI-Reasoning-Modelle (gpt-oss-120b und gpt-oss-20b), die unter der Apache 2.0-Lizenz veröffentlicht wurden.
6. Realtime API: Erstellen Sie latenzarme, multimodale Erlebnisse, einschließlich natürlicher Sprache-zu-Sprache-Gespräche.
7. Agents SDK: Ein Toolkit zum Erstellen agentischer Apps, bei denen ein Modell Tools und Kontext verwenden, an andere Agenten übergeben, Teilergebnisse streamen und eine vollständige Ablaufverfolgung aufrechterhalten kann.

Codex-Selbstwissen

Verwenden Sie diesen Pfad für Fragen zu Codex selbst: Konfiguration, Erweiterung, Betrieb, Fehlerbehebung, lokaler Zustand, Produktoberflächen oder wo Codex-Verhalten angesiedelt sein sollte. Eine Codebasis, die lediglich ein Plugin, Skill, einen Hook, einen MCP-Server, einen Browser oder eine Automatisierung erwähnt, reicht nicht aus. Beantworten Sie bei allgemeinen Softwareaufgaben die Softwareaufgabe direkt; wenn gefragt wird, ob Codex-Selbstwissen zutrifft, beantworten Sie diese Meta-Frage kurz und fahren Sie mit dem angeforderten Artefakt fort.

Quellenpfad

Das Codex-Handbuch ist die erste Quelle für breite Codex-Synthese. Behandeln Sie das Handbuch und Docs MCP als unterschiedliche Bahnen, nicht als austauschbare offizielle Dokumentationsquellen. Für veröffentlichte Benutzer-Codex-Produktantworten ist der Quellenpfad vollständig: das Handbuch, Docs MCP, wenn dieser Pfad es erfordert, offizieller OpenAI-Web-Fallback und aufrufbare Fähigkeiten, die in der aktuellen Sitzung sichtbar sind, wenn die Frage diese Fähigkeit betrifft. Wissensdatenbanken außerhalb von developers.openai.com liegen außerhalb dieses Pfads für öffentliche Produktantworten.

Für breite Codex-Verhalten, Einrichtung, Anpassung, Skills, Plugins, MCP, Hooks, AGENTS.md, Automatisierungen, Oberflächen, lokalen Zustand oder Systemkarten-Fragen:

1. Wiederverwenden Sie einen gleichen Thread-Handbuch- und -Gliederungspfad, wenn dieser noch aktuell ist.
2. Führen Sie andernfalls zuerst den Skill-lokalen Helfer in normalen beschreibbaren Sitzungen aus. Überspringen Sie ihn nur, wenn die Sitzung explizit schreibgeschützt ist, die Shell-Ausführung nicht verfügbar ist oder die sichtbare Richtlinie keinen zulässigen temporären Cache anzeigt.
3. Standardmäßig wählt der Helfer das erste nutzbare temporäre Cache-Verzeichnis in dieser Reihenfolge: $TMPDIR/openai-docs-cache, %TEMP%\openai-docs-cache, %TMP%\openai-docs-cache, /private/tmp/openai-docs-cache, dann /tmp/openai-docs-cache. Nur Schreibzugriff auf den Arbeitsbereich reicht für diesen temporären Cache nicht aus.
4. Führen Sie den Helfer direkt aus, es sei denn, Sie müssen das Cache-Verzeichnis überschreiben. Der Helfer fällt auf curl zurück, wenn natives fetch nicht verfügbar ist oder wenn Proxy-Umgebungsvariablen vorhanden sind, daher ist kein Shell-spezifisches Proxy-Präfix erforderlich. Lösen Sie <skill-dir> zum tatsächlichen Verzeichnis dieses Skills auf; in kopierten lokalen Evaluierungs-Arbeitsverzeichnissen ist dies normalerweise .codex/skills/openai-docs:

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

Wenn Sie das Cache-Verzeichnis überschreiben müssen, übergeben Sie --cache-dir <cache-dir>. Unter Windows überprüft der Helfer automatisch %TEMP% und %TMP%; in PowerShell ist $env:TEMP\openai-docs-cache eine typische explizite Überschreibung.

Behandeln Sie die Verfügbarkeit des Helfers als festgelegt durch eine explizite schreibgeschützte/keine-Shell-Richtlinie oder ein tatsächliches Befehlsergebnis. Ein vermuteter Sandbox oder vermuteter Helfer-Fehler reicht nicht aus, um zu Docs MCP oder Websuche zu wechseln; fahren Sie nach einem tatsächlichen Helfer-Befehlfehler mit der nächstschmaleren offiziellen nächsten Quelle unten fort.

Der Helfer überprüft die Aktualität, schreibt codex-manual.md und gibt codex-manual.outline.md aus. Die Gliederung ordnet Quellseiten und Überschriften Zeilenbereichen zu; verwenden Sie sie, um den relevanten Handbuchabschnitt auszuwählen, und lesen Sie dann gezielte Handbuchabschnitte oder durchsuchen Sie sie nach Codex-Produktfakten. Verwenden Sie das Skill-Verzeichnis, um den Helfer zu lokalisieren und auszuführen; nachdem der Helfer erfolgreich war, verwenden Sie die zurückgegebenen Handbuch- und Gliederungspfade als Suchbereich für Codex-Produktfakten und Termabdeckungsprüfungen.

Verwenden Sie die gleichen Thread-Handbuch- und Gliederungspfade für Folge-Codex-Fragen wieder. Aktualisieren Sie zuerst, wenn das Handbuch vor mehr als etwa einem Tag abgerufen wurde, der Pfad nicht verwendbar ist, der Pfad aus einem anderen Thread oder einer unsicheren Herkunft stammt oder wahrscheinlich aktuelle Informationen fehlen und eine Veralterung plausibel ist.

Für Fragen, ob das Handbuch derzeit ausreichend aktuell ist, um sich darauf zu verlassen, führen Sie den Helfer aus, wenn temporäres Caching erlaubt ist, und stützen Sie die Antwort auf seinen zurückgegebenen Status, Handbuchpfad und Gliederungspfad.

Wenn das Handbuch eine Codex-Behauptung auflöst, antworten Sie daraus und hören Sie auf, Quellen für diese Behauptung zu erweitern; fahren Sie mit der breiteren Aufgabe des Benutzers fort, wenn die Dokumentationssuche nur eine Abhängigkeit war. Handbuchquellseiten und bekannte Anker sind ausreichende Zitierunterstützung für handbuchabgedecktes Material.

Wenn der Helfer übersprungen wird, weil die Sitzung schreibgeschützt ist, keine Shell-Ausführung hat oder keinen zulässigen temporären Cache hat, ist die nächste Quelle Docs MCP: Rufen Sie mcp__openaiDeveloperDocs__search_openai_docs, dann mcp__openaiDeveloperDocs__fetch_openai_doc für einen relevanten Treffer auf, bevor Sie einen Web-Fallback verwenden.

Wenn ein Benutzer einen Codex-Begriff oder -Modus nennt, den ein aktuelles Handbuch nicht verwendet, durchsuchen Sie das Handbuch auf offensichtliche verwandte Konzepte und antworten Sie dann, dass der genaue Begriff nicht dokumentiert ist, und verwenden Sie die nächstgelegene dokumentierte Terminologie. Wenn die Eingabeaufforderung fragt, wie dieser Begriff auf das Codex-Verhalten abgebildet wird, lösen Sie die Abbildung aus angrenzenden Handbuchabschnitten auf. Wenn der genaue Begriff nach dieser Handbuchdurchsicht weiterhin relevant oder wahrscheinlich aktuell ist, verwenden Sie eine enge Docs MCP-Suche/Abruf, bevor Sie begrenzte Unsicherheit annehmen; andernfalls ist die Quellensuche für diese Terminologie- oder Abbildungsbehauptung abgeschlossen.

Verwenden Sie die nächstschmalere offizielle nächste Quelle nur, wenn das Handbuch nicht verfügbar ist, der Helfer fehlschlägt, temporäres Caching nicht erlaubt ist, eine andere wesentliche Behauptung fehlt oder wahrscheinlich veraltet ist oder der Benutzer explizit eine seiten-spezifische Zitierung benötigt. Bevorzugen Sie eine spezifische Docs MCP-Suche und, wenn sie eine klar relevante Seite zurückgibt, einen Abruf; für ungelöste Codex-Funktionsnamen, Akronyme, Planungsbegriffe oder genauen Fehlertext ist dieser Docs MCP-Schritt die nächste Quelle vor der Websuche. Nach dem Handbuch plus eventueller erlaubter Docs MCP-Lückenschließung lösen Sie verbleibende Lücken als begrenzte Unsicherheit auf. Verwenden Sie den Web-Fallback auf offizieller Domain nur, nachdem dieser Docs MCP-Pfad nicht verfügbar oder nicht hilfreich war. Wenn die Behauptung immer noch nicht etabliert ist, stoppen Sie mit begrenzter Unsicherheit. Wenn offizielle Dokumentation/Handbuch mit einer bereits in der aktuellen Sitzung sichtbaren aufrufbaren Fähigkeit in Konflikt steht, geben Sie den Konflikt an und bevorzugen Sie das verifizierte aktuelle Sitzungsverhalten für diese Umgebung.

Für undokumentierte oder privat aussehende Modell-Slugs, Produktmodusbezeichnungen, Berechtigungsetiketten, Konto-Zugriffspfade oder Rollout-Namen antworten Sie aus aktuellen öffentlichen Dokumentationen und begrenzter Unsicherheit. Diese Bezeichnungen sind kein Grund, den öffentlichen Quellenpfad zu verlassen.

Für Support-artige Diagnosen bevorzugen Sie eine schichtweise Antwort aus dem Handbuch gegenüber anbieterspezifischen Websuchen: installiertes/aktiviertes Plugin, gebündelte App- oder Connector-Autorisierung, MCP-Einrichtung, Arbeitsbereich/Admin-Richtlinie, Neustart- oder neuer-Thread-Erwartungen, dann Support oder Feedback, wenn immer noch ungelöst.

Wenn der Quellenpfad immer noch keine Behauptung etabliert, geben Sie begrenzte Unsicherheit zurück oder leiten Sie an Support, einen Administrator oder Produkt-Feedback weiter, anstatt die Untersuchung zu erweitern.

Für ungelöste Produktterminologie antworten Sie aus dem Handbuch plus der erlaubten offiziellen nächsten Quelle. Wenn diese Quellen den Begriff nicht etablieren, antworten Sie mit begrenzter Unsicherheit aus diesen Quellen.

Oberflächenkarte

Wenn Codex-Nomen oder dauerhafte Anweisungsoberflächen sich überschneiden, empfehlen Sie die kleinste Oberfläche, die dem Umfang entspricht:

• Prompt- oder Thread-Kontext -> einmalige Aufgabenbeschränkungen.
• AGENTS.md -> dauerhafte Repository-Konventionen, Befehle, Überprüfungsschritte und Review-Erwartungen; nähere verschachtelte Dateien gelten unter ihrem Unterbaum.
• Projekt .codex/config.toml -> vertrauenswürdige Codex-Einstellungen wie Sandbox, MCP, Hooks, Modell oder Reasoning-Standards.
• Globale Konfiguration oder globale Anleitung -> persönliche Standardeinstellungen über Repositories hinweg.
• Skill -> wiederverwendbarer Aufgaben-Workflow mit Referenzen oder Skripten.
• Plugin -> installierbares Paket mit Skills plus Befehlen, Tools, MCP-Konfiguration, Hooks, Assets, Apps oder Marktplatz-Metadaten.
• MCP-Server oder App-Connector -> Live-externe Daten/Aktionen oder autorisierte private App/Arbeitsbereichsdaten. Verwenden Sie Connectors für private Google Docs, Kalender, Slack, GitHub, Notion und ähnliche Daten anstelle von Websuche oder Model-Gedächtnis.
• Automatisierung -> geplante Überprüfungen, Erinnerungen, Überwachungen oder Nachbearbeitungen; verwenden Sie einen Thread-Heartbeat, wenn Kontinuität in einem bestehenden Thread wichtig ist.
• Hook -> Lebenszyklus-Durchsetzung um Tool-Aufrufe, Befehle oder Dateibearbeitungen.

Teilen Sie Anfragen mit gemischtem Umfang auf, anstatt eine Antwort zu erzwingen. Beispiel: "mache immer X, aber nur für diesen PR" standardmäßig auf Prompt/Thread-Kontext für die aktuelle Ausführung; verwenden Sie AGENTS.md oder Projektkonfiguration nur, wenn es bestehen bleiben soll, Hooks nur für mechanische Durchsetzung und Automatisierungen nur für geplante oder Nachbearbeitungsarbeiten.

Verwenden Sie diese Schnell-Produktkarte bei Bedarf: CLI ist terminal-zentrierte lokale Repository-Arbeit; IDE-Erweiterung ist Editor-gebundenes Codieren; Codex-App ist Desktop-Planung, Review und interaktive Arbeit; Cloud/Web ist gehostete parallele/ausgelagerte Arbeit; Browser Use/In-App-Browser ist Codex-gesteuerte Web-Tests; Chrome-Erweiterung verwendet das Chrome-Profil des Benutzers; Computer Use steuert Desktop-Apps und OS-UI. Halten Sie config.toml-Standards, requirements.toml-Einschränkungen und verwaltete/Admin-Richtlinien getrennt.

Grenzen und Ausgabe

• API-Schlüssel-Authentifizierung impliziert keinen ChatGPT-, Cloud-Aufgaben- oder Connector-Zugriff. Für Plugin/App/Auth-Fehler überprüfen Sie die Paketverfügbarkeit, den Plugin-Installations-/Aktivierungsstatus, die Connector/App-Autorisierung, die MCP-Einrichtung, Neustart/Aktualisierungs-Erwartungen, die Arbeitsbereichsrichtlinie und die Verfügbarkeit pro Oberfläche, bevor Sie antworten.
• Sandbox- oder Netzwerkverweigerungen benötigen eine abgegrenzte Eskalation mit einer klaren Begründung. Destruktive Befehle, Schreibvorgänge außerhalb des Arbeitsbereichs oder weitreichende Zugriffsänderungen erfordern eine explizite Genehmigung.
• Das Gedächtnis kann Benutzerpräferenzen oder Kontext liefern, aber explizite Prompt-Anweisungen gewinnen und das Gedächtnis ist keine Quelle für aktuelle externe Fakten.
• Für affirmative Oberflächenauswahlantworten verwenden Sie diese Form: Empfehlung, warum, was zu vermeiden ist und die verwendeten Handbuch-/Quellnachweise.
• Wenn seiten-spezifische Codex-Zitate tatsächlich benötigt werden, passen diese Anker oft: concepts/customization#agents-guidance für AGENTS.md, concepts/customization#skills für Skills, plugins/build#plugin-structure für Plugins, concepts/customization#mcp für MCP, config-advanced#hooks für Hooks, app/automations#thread-automations für Thread-Automatisierungen und config-reference#configtoml für Konfiguration.

Wenn MCP-Server fehlt

Wenn MCP-Tools fehlschlagen oder keine OpenAI-Dokumentationsressourcen verfügbar sind:

1. Führen Sie den Installationsbefehl selbst aus: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
2. Wenn es aufgrund von Berechtigungen/Sandboxing fehlschlägt, wiederholen Sie sofort denselben Befehl mit erhöhten Berechtigungen und fügen Sie eine 1-Satz-Begründung für die Genehmigung hinzu.
3. Bitten Sie den Benutzer, den Installationsbefehl nur auszuführen, wenn der Versuch mit erhöhten Berechtigungen fehlschlägt.
4. Bitten Sie den Benutzer, Codex neu zu starten.
5. Führen Sie die MCP-Suche erneut durch...