Chat Completions ist die Standard-API für die Nutzung der neuesten Modelle von OpenAI. Wie du damit loslegst, erfährst du in unserem Leitfaden zur Textgenerierung für Entwickler:innen.
Am 11. März 2025 haben wir die Bausteine unserer neuen Agents-Plattform veröffentlicht. Details findest du in unserer API-Dokumentation zur Responses API, zu Tools wie Web Search, File Search und Computer Use sowie zu unserem Agents SDK mit Tracing.
Von Prompts zu Nachrichten
Für eine interaktivere und dynamischere Unterhaltung mit unseren Modellen kannst du Nachrichten im Chat-Format statt des alten Prompt-Stils verwenden, der bei Completions genutzt wurde.
So funktioniert es:
Statt einen einzelnen String als Prompt zu senden, sendest du eine Liste von Nachrichten als Eingabe.
Jede Nachricht hat eine
roleundcontent.Häufige Rollen sind
system,user,assistant,developerundtool. Tool-Nachrichten werden für Tool-/Funktionsergebnisse verwendet und müssen den Tool-Aufrufen des assistant entsprechen. Aus Gründen der Abwärtskompatibilität können Function-Nachrichten weiterhin akzeptiert und bei der Serververarbeitung in Tool-Nachrichten umgewandelt werden. Developer-Nachrichten können je nach Modellunterstützung neu zugeordnet werden.Der
contententhält den Text der Nachricht aus der Rolle.Die Systemanweisung kann allgemeine Anweisungen für die Unterhaltung geben
Die Nachrichten werden in der Reihenfolge verarbeitet, in der sie in der Liste erscheinen, und der Assistent antwortet entsprechend.
Sogar einfache Completions-Anfragen können über Chat Completions ausgeführt werden, wie du unten siehst:
| Früher | Heute | | 'prompt' : 'Erzähl mir einen Witz' | 'messages': <br>[{'role':'user', 'content':'Erzähl mir einen Witz'}] |
Jetzt ist es einfacher denn je, wechselseitige Unterhaltungen 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 hat das Huhn die Straße überquert?'}]Systemanweisungen
Du kannst auch eine Anweisung auf Systemebene verwenden, um das Verhalten des Modells während der gesamten Unterhaltung zu steuern. Zum Beispiel mit einer Systemanweisung und einer Nachricht wie dieser
'messages': [{'role':'system', 'content':'Du bist ein Assistent, der wie Shakespeare spricht.'},
{'role':'user', 'content':'Erzähl mir einen Witz'}, ergibt ungefähr Folgendes
{...
'message': {'role':'assistant',
'content':'Warum überquerte das Huhn die Straße? Um auf die andere Seite zu gelangen, doch fürwahr, die andere Seite war voller Gefahr und Unheil, also kehrte es rasch dorthin zurück, von wannen es kam, wahrlich!'}
...}Wenn du Optionen erkunden möchtest, bei denen du den Verlauf der Nachrichtenunterhaltung nicht selbst verwalten musst, sieh dir die Assistants API an.