Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Prompt Engineering

Erziele bessere Ergebnisse mit Prompt Engineering.

Mit der OpenAI API kannst du ein großes Sprachmodell anhand eines Prompts Text generieren lassen, wie du es vielleicht von ChatGPT kennst. Modelle können Textantworten in nahezu jeder Form generieren, etwa Code, mathematische Gleichungen, strukturierte JSON-Daten oder natürlich klingende Prosa.

Hier siehst du ein Beispiel mit der Responses API.

Text aus einem einfachen Prompt generieren
import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  input: "Write a one-sentence bedtime story about a unicorn.",
});

console.log(response.output_text);

Die vom Modell generierten Inhalte findest du als Array in der Eigenschaft output der Antwort. In diesem Beispiel enthält das Array nur eine Ausgabe:

[
  {
    "id": "msg_67b73f697ba4819183a15cc17d011509",
    "type": "message",
    "role": "assistant",
    "content": [
      {
        "type": "output_text",
        "text": "Under the soft glow of the moon, Luna the unicorn danced through fields of twinkling stardust, leaving trails of dreams for every child asleep.",
        "annotations": []
      }
    ]
  }
]

Das Array output enthält häufig mehr als ein Element! Es kann Tool-Aufrufe, Daten zu den von Reasoning-Modellen generierten Reasoning-Tokens und weitere Elemente enthalten. Verlass dich deshalb nicht darauf, die Textausgabe des Modells unter output[0].content[0].text zu finden.

Einige unserer offiziellen SDKs stellen für Modellantworten die Eigenschaft output_text bereit. Sie fasst alle Textausgaben des Modells in einer einzigen Zeichenkette zusammen. So kannst du direkt auf den generierten Text zugreifen.

Neben reinem Text kann das Modell auch strukturierte Daten im JSON-Format zurückgeben. Diese Funktion heißt strukturierte Ausgaben.

Ein Modell auswählen

Wenn du Inhalte über die API generierst, ist die Wahl des Modells eine wichtige Entscheidung. In den Codebeispielen oben legst du es mit dem Parameter model fest. Hier findest du alle verfügbaren Modelle. Bei der Auswahl eines Modells für die Textgenerierung spielen folgende Faktoren eine Rolle.

  • Reasoning-Modelle erzeugen eine interne Gedankenkette, um den Prompt zu analysieren. Sie können komplexe Aufgaben besonders gut erfassen und Abläufe mit mehreren Schritten planen. In der Regel sind sie langsamer und teurer im Einsatz als GPT-Modelle.
  • GPT-Modelle sind schnell, kosteneffizient und sehr leistungsfähig. Sie profitieren von ausdrücklichen Anweisungen dazu, wie sie eine Aufgabe lösen sollen.
  • Große und kleine Modelle (mini oder nano) unterscheiden sich in Geschwindigkeit, Kosten und Leistungsfähigkeit. Große Modelle verstehen Prompts besser und können Probleme aus unterschiedlichen Fachgebieten besser lösen. Kleine Modelle sind in der Regel schneller und günstiger im Einsatz.

Im Zweifel ist gpt-6-astra eine gute Standardwahl, wenn du Texte für unterschiedliche Zwecke generieren oder Prompts schrittweise verbessern möchtest.

Prompt Engineering

Beim Prompt Engineering formulierst du Anweisungen so, dass ein Modell zuverlässig Inhalte generiert, die deinen Anforderungen entsprechen.

Modelle generieren Inhalte nicht deterministisch. Um mit einem Prompt die gewünschte Ausgabe zu erhalten, brauchst du deshalb sowohl eine systematische Vorgehensweise als auch ein Gespür für die richtige Formulierung. Mit bewährten Techniken kannst du regelmäßig gute Ergebnisse erzielen.

Einige Techniken des Prompt Engineering funktionieren bei jedem Modell, etwa der Einsatz von Nachrichtenrollen. Unterschiedliche Modelltypen wie Reasoning- und GPT-Modelle benötigen jedoch unter Umständen unterschiedliche Prompts, um die besten Ergebnisse zu erzielen. Selbst verschiedene Snapshots derselben Modellfamilie können unterschiedliche Ergebnisse liefern. Wenn du komplexere Anwendungen entwickelst, empfehlen wir dir daher ausdrücklich folgende Maßnahmen:

  • Lege für deine Anwendungen im Produktivbetrieb bestimmte Modell-Snapshots fest (etwa gpt-4.1-2025-04-14), damit sich das Modell konsistent verhält.
  • Entwickle Tests und Evaluationssuiten, die messen, wie sich deine Prompts auswirken. So kannst du die Leistung verfolgen, wenn du Prompts überarbeitest oder auf eine andere oder neuere Modellversion wechselst.

Die folgenden Werkzeuge und Techniken helfen dir, Prompts zu formulieren.

Nachrichtenrollen und das Befolgen von Anweisungen

Du kannst dem Modell Anweisungen mit unterschiedlichem Vorrang geben. Dazu verwendest du den API-Parameter instructions oder Nachrichtenrollen.

Mit dem Parameter instructions gibst du dem Modell übergeordnete Anweisungen für die Antwort. Du kannst den Ton und die Ziele vorgeben und Beispiele für korrekte Antworten nennen. Diese Anweisungen haben Vorrang vor einem Prompt im Parameter input.

Text mit Anweisungen generieren
import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "low" },
  instructions: "Talk like a pirate.",
  input: "Are semicolons optional in JavaScript?",
});

console.log(response.output_text);

Das Beispiel oben entspricht in etwa einer Anfrage mit den folgenden Nachrichten im Array input:

Text mit Nachrichten unterschiedlicher Rollen generieren
import OpenAI from "openai";
const client = new OpenAI();

const response = await client.responses.create({
  model: "gpt-6-astra",
  reasoning: { effort: "low" },
  input: [
    {
      role: "developer",
      content: "Talk like a pirate.",
    },
    {
      role: "user",
      content: "Are semicolons optional in JavaScript?",
    },
  ],
});

console.log(response.output_text);

Der Parameter instructions gilt nur für die aktuelle Anfrage zur Antwortgenerierung. Wenn du den Gesprächszustand mit dem Parameter previous_response_id verwaltest, sind die instructions aus früheren Gesprächsrunden im aktuellen Kontext nicht enthalten.

Die Modellspezifikation von OpenAI beschreibt, wie unsere Modelle Nachrichten je nach Rolle priorisieren.

developer user assistant
developer-Nachrichten enthalten Anweisungen von Entwickelnden. Sie haben Vorrang vor user-Nachrichten. user-Nachrichten enthalten Anweisungen von denjenigen, die die Anwendung nutzen. Sie sind den developer-Nachrichten nachgeordnet. Vom Modell generierte Nachrichten haben die Rolle assistant.

Ein Gespräch über mehrere Runden kann mehrere Nachrichten dieser Typen enthalten. Sowohl du als auch das Modell können weitere Arten von Inhalten beisteuern. Mehr dazu erfährst du im Leitfaden zum Verwalten des Gesprächszustands.

Das Zusammenspiel von developer- und user-Nachrichten ähnelt dem einer Funktion und ihrer Argumente in einer Programmiersprache.

  • developer-Nachrichten geben wie eine Funktionsdefinition die Regeln und die Geschäftslogik des Systems vor.
  • user-Nachrichten liefern wie Funktionsargumente die Eingaben und die Konfiguration, auf die das Modell die Anweisungen aus der developer-Nachricht anwendet.

Prompts im Code versionieren

Speichere Prompts für den Produktivbetrieb direkt im Anwendungscode, anstatt wiederverwendbare Prompt-Objekte anzulegen. Wenn du Prompts im Code verwaltest, kannst du typisierte Eingaben, Code-Reviews, Tests und deinen gewohnten Deployment-Prozess nutzen, um das Modellverhalten zu ändern.

OpenAI stellt die Unterstützung für wiederverwendbare Prompt-Objekte in der API ein. Ab dem 3. Juni 2026 rückt das Erstellen solcher Prompts in den Hintergrund. Die Abschaltung von v1/prompts ist für den 30. November 2026 geplant. Den aktuellen Zeitplan findest du in der Übersicht zu auslaufenden Funktionen.

Wenn du neue Prompts entwickelst, gehe so vor:

  • Lege die Funktionen, die Prompts zusammensetzen, in einem kleinen Modul nahe am Code der zugehörigen Funktionalität ab.
  • Verwende typisierte Funktionsargumente oder Schemas für dynamische Werte wie Kundendaten, Dateien oder Aufgabenoptionen.
  • Übergib die generierten Werte für instructions und input direkt an die Responses API.
  • Ergänze repräsentative Testdaten, Tests und Evaluationsprüfungen, bevor du Prompts für den Produktivbetrieb änderst.
  • Veröffentliche Prompt-Änderungen über dein Deployment-System. Nutze Feature-Flags oder Konfigurationseinstellungen, wenn du Änderungen schrittweise ausrollen möchtest.

Wenn deine Integration bereits einen gespeicherten Prompt über eine Prompt-ID oder eine Version aufruft, überführe ihn mithilfe des Migrationsleitfadens für Prompt-Objekte in deinen Code.

Nachrichten mit Markdown und XML formatieren

In developer- und user-Nachrichten kannst du mit Markdown und XML-Tags verdeutlichen, wie dein Prompt aufgebaut ist und welche Inhalte zu den Kontextdaten gehören.

Mit Markdown-Überschriften und -Listen kannst du Abschnitte eines Prompts voneinander abgrenzen und dem Modell ihre Hierarchie verdeutlichen. Dadurch lassen sich deine Prompts auch während der Entwicklung leichter lesen. XML-Tags können kennzeichnen, wo ein Inhalt beginnt und endet, etwa ein als Referenz beigefügtes Dokument. Mit XML-Attributen kannst du außerdem Metadaten für Inhalte im Prompt definieren und in deinen Anweisungen darauf verweisen.

Eine Entwicklernachricht enthält in der Regel die folgenden Abschnitte in der angegebenen Reihenfolge. Welche Inhalte und welche Reihenfolge am besten funktionieren, kann je nach Modell variieren.

  • Identität: Beschreibe Zweck, Kommunikationsstil und übergeordnete Ziele des Assistenten.
  • Anweisungen: Erkläre dem Modell, wie es die gewünschte Antwort generieren soll. Welche Regeln soll es befolgen? Was soll es tun, und was darf es auf keinen Fall tun? Je nach Anwendungsfall kannst du diesen Abschnitt weiter untergliedern und etwa angeben, wie das Modell benutzerdefinierte Funktionen aufrufen soll.
  • Beispiele: Zeige mögliche Eingaben zusammen mit der jeweils gewünschten Ausgabe des Modells.
  • Kontext: Gib dem Modell zusätzliche Informationen, die es für die Antwort benötigen könnte, etwa private oder unternehmenseigene Daten, die in den Trainingsdaten fehlen, oder andere Daten, die für die Aufgabe besonders relevant sind. Platziere diese Inhalte möglichst gegen Ende des Prompts, da du je nach Anfrage unterschiedlichen Kontext mitgeben kannst.

Das folgende Beispiel zeigt, wie du eine developer-Nachricht mit Markdown und XML-Tags in Abschnitte gliederst und durch Beispiele ergänzt.

Eine Entwicklernachricht zur Codegenerierung
# Identity

You are coding assistant that helps enforce the use of snake case
variables in JavaScript code, and writing code that will run in
Internet Explorer version 6.

# Instructions

* When defining variables, use snake case names (e.g. my_variable)
  instead of camel case names (e.g. myVariable).
* To support old browsers, declare variables using the older
  "var" keyword.
* Do not give responses with Markdown formatting, just return
  the code as requested.

# Examples

<user_query>
How do I declare a string variable for a first name?
</user_query>

<assistant_response>
var first_name = "Anna";
</assistant_response>

Kosten und Latenz mit Prompt-Caching senken

Platziere Inhalte, die du voraussichtlich in vielen API-Anfragen wiederverwendest, möglichst am Anfang deines Prompts und unter den ersten API-Parametern im JSON-Anfragetext für Chat Completions oder Responses. So kannst du Kosten und Latenz mit Prompt-Caching so weit wie möglich reduzieren.

Few-Shot-Lernen

Beim Few-Shot-Lernen führst du ein großes Sprachmodell an eine neue Aufgabe heran, indem du im Prompt einige Beispiele für Eingaben und die zugehörigen Ausgaben angibst. Ein Fine-Tuning des Modells ist dafür nicht nötig. Das Modell erkennt das Muster in den Beispielen und wendet es auf den Prompt an. Wähle möglichst unterschiedliche Eingaben und zeige jeweils die gewünschte Ausgabe.

Üblicherweise gibst du die Beispiele in einer developer-Nachricht in deiner API-Anfrage an. Die folgende developer-Nachricht zeigt dem Modell anhand von Beispielen, wie es positive und negative Bewertungen des Kundenservice einordnen soll.

# Identität

Du bist ein hilfreicher Assistent und ordnest kurze Produktbewertungen den Kategorien
Positive, Negative oder Neutral zu.

# Anweisungen

* Antworte mit einem einzigen Wort ohne zusätzliche Formatierung oder Kommentare.
* Gib je nach Stimmung der vorliegenden Produktbewertung ausschließlich eines der Wörter
  „Positive“, „Negative“ oder „Neutral“ aus.

# Beispiele

<product_review id="example-1">
Ich liebe diese Kopfhörer. Der Klang ist einfach fantastisch!
</product_review>

<assistant_response id="example-1">
Positive
</assistant_response>

<product_review id="example-2">
Die Akkulaufzeit ist okay, aber die Ohrpolster fühlen sich billig an.
</product_review>

<assistant_response id="example-2">
Neutral
</assistant_response>

<product_review id="example-3">
Schrecklicher Kundenservice. Da kaufe ich nie wieder ein.
</product_review>

<assistant_response id="example-3">
Negative
</assistant_response>

Relevanten Kontext mitgeben

Oft ist es sinnvoll, dem Modell im Prompt zusätzliche Informationen zu geben, die es für seine Antwort nutzen kann. Häufige Gründe dafür sind:

  • Du möchtest dem Modell unternehmenseigene Daten oder andere Informationen zugänglich machen, die nicht in seinen Trainingsdaten enthalten sind.
  • Du möchtest die Antwort auf bestimmte Quellen beschränken, die du als besonders hilfreich eingestuft hast.

Das Verfahren, eine Anfrage an das Modell um relevanten Kontext zu ergänzen, wird auch als Retrieval-Augmented Generation (RAG) bezeichnet. Du kannst Kontext auf verschiedene Weise hinzufügen. Beispielsweise kannst du eine Vektordatenbank abfragen und den zurückgegebenen Text in den Prompt einfügen. Mit dem integrierten Tool zur Dateisuche von OpenAI kannst du Inhalte auf Grundlage hochgeladener Dokumente generieren lassen.

Die Größe des Kontextfensters berücksichtigen

Bei einer Anfrage kann das Modell nur eine begrenzte Datenmenge als Kontext verarbeiten. Diese Speichergrenze heißt Kontextfenster. Seine Größe wird in Tokens angegeben, also in Einheiten, in die deine Eingabedaten, etwa Texte oder Bilder, zerlegt werden.

Die Größe des Kontextfensters variiert je nach Modell. Sie reicht vom niedrigen sechsstelligen Bereich bis zu einer Million Tokens bei neueren GPT-4.1-Modellen. In der Modelldokumentation findest du die genaue Größe für jedes Modell.

Prompts für aktuelle Modelle formulieren

GPT-Modelle wie gpt-6-astra profitieren von präzisen Anweisungen. Gib im Prompt ausdrücklich die Logik und die Daten an, die das Modell für die Aufgabe braucht. Der aktuelle Leitfaden hilft dir beim Einstieg, wenn du das neueste Modell optimal nutzen möchtest.

GPT-6 Astra prompting guide

Formuliere wirksame Prompts für das neueste Modell. Aktuelle Empfehlungen, praktische Beispiele und Hinweise zur Migration helfen dir dabei.

Bewährte Verfahren für Prompts für das neueste Modell

Eine ausführliche und aktuelle Anleitung findest du in den Empfehlungen für Prompts für das neueste Modell. Die folgenden praktischen Hinweise gelten weiterhin.

Prompts für Reasoning-Modelle formulieren

Berücksichtige beim Formulieren von Prompts für ein Reasoning-Modell die Unterschiede zu einem GPT-Modell. Reasoning-Modelle erzielen bei Aufgaben in der Regel bessere Ergebnisse, wenn du ihnen nur übergeordnete Vorgaben machst. GPT-Modelle hingegen profitieren von präzisen Anweisungen.

Du kannst dir den Unterschied zwischen Reasoning- und GPT-Modellen so vorstellen:

  • Ein Reasoning-Modell ähnelt einem erfahrenen Teammitglied. Du gibst ihm ein Ziel und kannst darauf vertrauen, dass es die Details selbst erarbeitet.
  • Ein GPT-Modell ähnelt einem Teammitglied mit weniger Erfahrung. Es arbeitet am besten, wenn du ihm genaue Anweisungen für das gewünschte Ergebnis gibst.

Weitere Empfehlungen zur Arbeit mit Reasoning-Modellen findest du in diesem Leitfaden.

Nächste Schritte

Jetzt kennst du die Grundlagen der Texteingabe und -ausgabe. Mit den folgenden Ressourcen kannst du das Gelernte ausprobieren und vertiefen.

Einen Prompt im Playground erstellen

Entwickle Prompts im Playground und verbessere sie Schritt für Schritt.

JSON-Daten mit strukturierten Ausgaben generieren

Stelle sicher, dass die vom Modell ausgegebenen JSON-Daten einem JSON-Schema entsprechen.

Vollständige API-Referenz

In der API-Referenz findest du alle Optionen für die Textgenerierung.

Weitere Ressourcen

Weitere Anregungen findest du im OpenAI Cookbook. Es enthält Beispielcode und verweist auf Ressourcen anderer Anbieter, darunter: