Konversations-Nachrichten-Builder

Chat-Completion-Nachrichtenarrays mit visuellem rollenbasierten Editor erstellen und testen

~/message-builder
Hinzufügen:
#1
#2

Ausgabe-JSON(0 ({count} Nachrichten))

[]

Was ist ein Konversations-Nachrichten-Builder?

Ein Konversations-Nachrichten-Builder ist ein visuelles Werkzeug zum Erstellen der Nachrichtenarrays, die von KI-Chat-Completion-APIs verwendet werden. Wenn Sie die Chat Completions API von OpenAI, die Messages API von Anthropic oder die Gemini API von Google aufrufen, senden Sie ein geordnetes Array von Nachrichten — jede mit einer Rolle (System, Benutzer oder Assistent) und Inhalt. Dieses Werkzeug ermöglicht es Ihnen, diese Arrays visuell zu erstellen, statt JSON von Hand zu schreiben.

Das manuelle Schreiben von Nachrichtenarrays ist mühsam und fehleranfällig, besonders bei Konversationen mit mehreren Durchgängen, Few-Shot-Prompting-Setups oder komplexen System-Prompts. Ein fehlendes Komma, nicht übereinstimmende Anführungszeichen oder falsche Rollennamen führen zu API-Fehlern, die schwer zu debuggen sein können. Unser Builder bietet Ihnen eine visuelle Oberfläche mit rollenbasierter Farbkodierung, Neuanordnung und Echtzeit-JSON-Ausgabe.

Das Werkzeug unterstützt sowohl das OpenAI/Google-Format (System-Nachrichten im Array) als auch das Anthropic-Format (System-Prompt getrennt von Nachrichten). Wechseln Sie mit einem einzigen Klick zwischen den Formaten und kopieren Sie das einsatzbereite JSON direkt in Ihren Code.

So verwenden Sie den Nachrichten-Builder

Ein Nachrichtenarray erstellen Sie in wenigen Klicks:

  1. Nachrichten hinzufügen — Klicken Sie auf die Schaltflächen «+ System», «+ Benutzer» oder «+ Assistent», um Nachrichten hinzuzufügen. Jede Rolle ist farbkodiert: Lila für System, Blau für Benutzer, Grün für Assistent.
  2. Inhalt schreiben — Geben Sie Ihren Nachrichteninhalt in jedes Textfeld ein oder fügen Sie ihn ein. Die JSON-Ausgabe aktualisiert sich automatisch während der Eingabe.
  3. Nachrichten umsortieren — Verwenden Sie die Auf-/Ab-Pfeiltasten, um die Nachrichtenreihenfolge zu ändern. Sie können auch die Rolle einer Nachricht über das Dropdown-Menü ändern.
  4. Ausgabeformat wählen — Wählen Sie «OpenAI / Google» oder «Anthropic» aus dem Format-Dropdown. Bei Anthropic werden System-Nachrichten automatisch in ein separates Feld extrahiert.
  5. JSON kopieren — Klicken Sie auf «JSON kopieren», um die formatierte Ausgabe in Ihre Zwischenablage zu kopieren, bereit zum Einfügen in Ihren Code oder Ihr API-Testwerkzeug.

Nachrichtenrollen verstehen

Jede Nachricht in einem Chat-Completion-Array hat eine bestimmte Rolle, die dem Modell mitteilt, wie es sie interpretieren soll:

Systemrolle

Die System-Nachricht legt das allgemeine Verhalten und die Einschränkungen für die KI fest. Sie wirkt als dauerhafte Anweisungen, die jede Antwort beeinflussen. Häufige System-Prompts umfassen Persona-Definitionen («Sie sind ein Senior-Entwickler»), Ausgabeformatanforderungen («Antworten Sie immer in JSON»), Sicherheitseinschränkungen («Geben Sie niemals medizinischen Rat») oder Domänenkontext. Die System-Nachricht ist typischerweise die erste Nachricht im Array.

Benutzerrolle

Benutzernachrichten repräsentieren die Eingabe des menschlichen Benutzers. Das sind die Fragen, Anweisungen oder Daten, die das Modell verarbeiten soll. Bei Konversationen mit mehreren Durchgängen wechseln sich Benutzer- und Assistentennachrichten ab, um einen Konversationsverlauf zu erstellen.

Assistentenrolle

Assistentennachrichten repräsentieren vorherige Antworten des KI-Modells. Das Einbeziehen von Assistentennachrichten im Array ermöglicht es Ihnen, einen Konversationsverlauf bereitzustellen oder Few-Shot-Prompting zu implementieren — bei dem Sie dem Modell Beispiele gewünschter Eingabe-/Ausgabepaare zeigen, bevor Sie Ihre eigentliche Frage stellen.

Häufige Anwendungsfälle

  • Few-Shot-Prompting — Konversationsbeispiele erstellen, bei denen Benutzernachrichten Eingaben und Assistentennachrichten gewünschte Ausgaben zeigen, um dem Modell das Muster beizubringen.
  • System-Prompt-Tests — Schnell verschiedene System-Prompts prototypisieren und sehen, wie sie mit Benutzernachrichten im finalen JSON kombiniert werden.
  • API-Tests — Nachrichtenarrays für Werkzeuge wie Postman, curl oder API-Spielwiesen generieren, ohne JSON manuell zu formatieren.
  • Anbieterübergreifende Migration — Nachrichtenarrays zwischen OpenAI- und Anthropic-Formaten konvertieren, wenn Sie den Anbieter wechseln.
  • Dokumentation — Beispielkonversationen für API-Dokumentation oder Team-Onboarding-Materialien erstellen.

Häufig gestellte Fragen

Was ist ein Chat-Completion-Nachrichtenarray?

Ein Chat-Completion-Nachrichtenarray ist das Eingabeformat, das von KI-APIs wie OpenAI, Anthropic und Google verwendet wird. Es ist eine geordnete Liste von Nachrichten, jede mit einer «role» (System, Benutzer oder Assistent) und «content» (dem Nachrichtentext). Das Modell verwendet diesen Konversationsverlauf, um kontextuell angemessene Antworten zu generieren.

Was ist der Unterschied zwischen OpenAI- und Anthropic-Nachrichtenformaten?

OpenAI fügt System-Nachrichten direkt in das Nachrichtenarray mit role: "system" ein. Anthropic trennt den System-Prompt in einen dedizierten "system"-Parameter außerhalb des Nachrichtenarrays, und das Nachrichtenarray enthält nur die Rollen "user" und "assistant". Unser Builder übernimmt diese Konvertierung automatisch, wenn Sie das Ausgabeformat wechseln.

Was macht die System-Nachricht?

Die System-Nachricht legt das Verhalten, die Persönlichkeit und die Einschränkungen für das KI-Modell fest. Sie wird vor der Konversation verarbeitet und wirkt als dauerhafte Anweisungen. Häufige Verwendungen umfassen die Definition der Assistentenrolle («Sie sind ein Kundenservice-Mitarbeiter»), das Festlegen von Ausgabeformatanforderungen oder das Etablieren von Sicherheitsrichtlinien. Nicht jeder API-Aufruf benötigt eine System-Nachricht, aber für Produktionsanwendungen wird sie empfohlen.

Warum ist die Nachrichtenreihenfolge wichtig?

Die Nachrichtenreihenfolge definiert den Konversationsfluss. Modelle verarbeiten Nachrichten sequenziell, und die Reihenfolge beeinflusst, wie das Modell den Kontext interpretiert. System-Nachrichten sollten zuerst kommen, gefolgt von abwechselnden Benutzer- und Assistentennachrichten. Nachrichten in falscher Reihenfolge (z. B. zwei Benutzernachrichten hintereinander ohne Assistentenantwort) können das Modell verwirren oder bei einigen Anbietern API-Fehler auslösen.

Kann ich diesen Builder für Konversationen mit mehreren Durchgängen verwenden?

Ja. Der Builder unterstützt unbegrenzt viele Nachrichten und ist damit ideal für die Erstellung von Konversationsverläufen mit mehreren Durchgängen. Sie können Benutzer- und Assistentennachrichten in abwechselnder Reihenfolge hinzufügen, um eine vollständige Konversation zu simulieren, und dann das resultierende JSON in Ihren API-Aufrufen oder zum Testen von Prompt-Ketten verwenden.

Verwandte Werkzeuge

Entdecken Sie weitere Werkzeuge für die Entwicklung mit KI-APIs:

Verwandte Werkzeuge

Tool-/Funktionsdefinitions-Linter

Validieren und prüfen Sie Ihre KI-Function-Calling-Definitionen für OpenAI, Anthropic, Google und Cohere Formate

JSON-Schema-Generator für KI

JSON-Schemas aus Beispieldaten generieren, optimiert für KI-Function-Calling und strukturierte Ausgaben

Prompt-Format-Konverter

Prompts zwischen OpenAI, Anthropic Claude, Google Gemini und anderen KI-Anbieterformaten konvertieren