OpenAI
Diese Seite wurde maschinell übersetzt. Den Originalartikel auf Englisch ansehen.

Migration von Completions zu Chat Completions in der OpenAI-API

So migrierst du von der alten OpenAI Completions API zu Chat Completions

Aktualisiert: 14 hours ago

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 interaktivere und dynamischere Gespräche mit unseren Modellen kannst du Nachrichten im Chat-Format verwenden statt des bisherigen Prompt-Stils für Completions.

So funktioniert es:

  • Statt einen einzelnen Prompt-String zu senden, übergibst du als Eingabe eine Liste von Nachrichtenobjekten.

  • Jede Nachricht hat eine role und in der Regel content.

  • Häufige Rollen sind system, user, assistant, developer und tool. Tool-Nachrichten werden für Tool- oder Funktionsergebnisse verwendet und müssen zu Tool-Aufrufen des Assistenten passen. Aus Gründen der Abwärtskompatibilität können Funktionsnachrichten weiterhin akzeptiert und serverseitig in Tool-Nachrichten umgewandelt werden. Developer-Nachrichten können je nach Modellunterstützung neu zugeordnet werden.

  • content enthält den Nachrichtentext der jeweiligen Rolle.

  • Die Systemanweisung kann übergeordnete Vorgaben für das Gespräch festlegen.

  • Die Nachrichten werden in der Reihenfolge verarbeitet, in der sie in der Liste erscheinen, und der Assistent antwortet entsprechend.

Selbst einfache Completions-Anfragen lassen sich über Chat Completions bearbeiten, wie du unten siehst:

| Früher | Jetzt | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'role':'user', 'content':'tell me a joke'}] |

Heute ist es einfacher denn je, mit dem Modell im Dialog zu bleiben: Erweitere einfach die Nachrichtenliste der Unterhaltung.

'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.

War dieser Artikel hilfreich?