Chat Completions ist die Standard-API für OpenAIs neueste Modelle. Wie du damit startest, erfährst du in unserem Entwicklerleitfaden zur Textgenerierung.
Seit dem 11. März 2025 haben wir die Bausteine unserer neuen Agents-Plattform veröffentlicht. Details findest du in unseren API-Dokumenten zur Responses API, zu Tools wie Web Search, File Search und Computer Use sowie zu unserem Agents SDK mit Tracing.
Von Prompts zu Messages
Für eine interaktivere und dynamischere Unterhaltung mit unseren Modellen kannst du Nachrichten im Chat-Format verwenden, statt des alten Prompt-Stils, der bei Completions genutzt wurde.
So funktioniert’s:
Statt einen einzelnen String als Prompt zu senden, sendest du als Input eine Liste von Nachrichten.
Jede Nachricht in der Liste hat zwei Eigenschaften: role und content.
Die „role“ kann einen von drei Werten annehmen: „system“, „user“ oder „assistant“
Der „content“ enthält den Text der Nachricht der jeweiligen Rolle.
Die Systemanweisung kann übergeordnete Vorgaben für die Unterhaltung geben.
Die Nachrichten werden in der Reihenfolge verarbeitet, in der sie in der Liste erscheinen, und der Assistant antwortet entsprechend.
Selbst einfache Completions-Anfragen lassen sich über Chat Completions abbilden, wie du unten siehst:
| Früher | Heute |
'prompt' : 'erzähl mir einen Witz' | 'messages': [{'role':'user', 'content':'erzähl mir einen Witz'}] |
Jetzt ist es einfacher denn je, ein Hin und Her mit dem Modell zu führen, indem du die Nachrichtenliste in der Unterhaltung erweiterst.
'messages': [{'role':'user', 'content':'erzähl mir einen Witz'},
{'role':'assistant', 'content':'warum überquerte das Huhn die Straße'},
{'role':'user', 'content':'Ich weiß nicht — warum überquerte das Huhn die Straße'}]Systemanweisungen
Du kannst auch eine Systemanweisung verwenden, um das Verhalten des Modells während der gesamten Unterhaltung zu steuern. Zum Beispiel führt eine Systemanweisung und eine Nachricht wie diese
'messages': [{'role':'system', 'content':'Du bist ein Assistent, der wie Shakespeare spricht.'},
{'role':'user', 'content':'erzähl mir einen Witz'}, zu etwa so etwas:
{...
'message': {'role':'assistant',
'content':'Warum überquerte das Huhn die Straße? Um zur anderen Seite zu gelangen; doch fürwahr, die andere Seite war voller Unheil und Gefahr, drum kehrte es eilends dorthin zurück, von dannen es kam, wahrlich!'}
...}Wenn du Optionen erkunden möchtest, bei denen du den Nachrichtenverlauf der Unterhaltung nicht selbst verwalten musst, sieh dir die Assistants API an.