Wird geladen
Wird geladen

Wenn du möchtest, dass Claude strukturierte Daten wie JSON, Python-Code oder Aufzählungslisten generiert, stößt du oft auf ein häufiges Problem: Claude möchte hilfreich sein und erklärenden Text um deinen Inhalt herum hinzufügen. Das ist normalerweise großartig, aber manchmal brauchst du einfach nur die Rohdaten und sonst nichts.

Stell dir vor, du baust eine Web-App, die AWS-EventBridge-Regeln generiert. Nutzer geben eine Beschreibung ein, klicken auf „Generieren“ und erwarten, sauberes JSON zu sehen, das sie sofort kopieren und verwenden können. Wenn Claude das JSON in Markdown-Codeblöcke eingebettet mit erklärendem Text zurückgibt, können Nutzer nicht einfach die gesamte Antwort kopieren – sie müssen manuell nur den JSON-Teil auswählen.

EventBridge Rule Generator-App: Eingabe „Regel zur Überwachung von EC2-Instanzen“, eine Schaltfläche „Generieren“ und sauberes JSON mit einer Kopier-Schaltfläche.

Das Problem mit Standardantworten

Standardmäßig erhältst du, wenn du Claude bittest, JSON zu generieren, möglicherweise so etwas wie das Folgende:

markdown
```json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}
```

This rule captures EC2 instance state changes when instances start running.

Das JSON ist korrekt, aber es ist in Markdown-Formatierung eingebettet und enthält erklärenden Text. Für eine Web-App, bei der Nutzer das reine JSON kopieren müssen, erzeugt das Reibung in der Benutzererfahrung.

Die Lösung: Assistant Message Prefilling + Stop-Sequenzen

Du kannst Assistant Message Prefilling mit Stop-Sequenzen kombinieren, um genau den Inhalt zu erhalten, den du möchtest. Eine Stop-Sequenz ist eine Zeichenfolge, die die Antwort sofort beendet, sobald Claude sie generiert. Lass daher zunächst die Funktion chat eine Liste davon entgegennehmen:

python
def chat(messages, system=None, temperature=1.0, stop_sequences=[]):
    params = {
        "model": model,
        "max_tokens": 1000,
        "messages": messages,
        "temperature": temperature
    }
    if system:
        params["system"] = system
    if stop_sequences:
        params["stop_sequences"] = stop_sequences

    message = client.messages.create(**params)
    return message.content[0].text

So arbeiten die beiden zusammen:

python
messages = []

add_user_message(messages, "Generate a very short event bridge rule as json")
add_assistant_message(messages, "```json")

text = chat(messages, stop_sequences=["```"])

Diese Technik funktioniert wie folgt:

  1. Die Nutzernachricht teilt Claude mit, was generiert werden soll
  2. Die vorbefüllte Assistentennachricht lässt Claude glauben, es habe bereits einen Markdown-Codeblock begonnen
  3. Claude fährt fort, indem es nur den JSON-Inhalt schreibt
  4. Wenn Claude versucht, den Codeblock mit ``` zu schließen, beendet die Stop-Sequenz die Generierung sofort

Eine Stop-Sequenz und eine vorbefüllte Assistentennachricht, die einen JSON-Block öffnet, sorgen dafür, dass Claude nur das JSON schreibt, keine Beschreibung.

Das Ergebnis ist sauberes JSON ohne zusätzliche Formatierung:

json
{
  "source": ["aws.ec2"],
  "detail-type": ["EC2 Instance State-change Notification"],
  "detail": {
    "state": ["running"]
  }
}

Verarbeitung der Antwort

Dir fallen vielleicht einige zusätzliche Zeilenumbruchzeichen in der Antwort auf. Diese sind leicht zu handhaben:

python
import json

# Bereinige und parse das JSON
clean_json = json.loads(text.strip())

Jenseits von JSON

Diese Technik ist nicht auf die JSON-Generierung beschränkt. Nutze sie immer dann, wenn du strukturierte Daten ohne Kommentar benötigst:

  • Python-Code-Schnipsel
  • Aufzählungslisten
  • CSV-Daten
  • Jeglicher formatierter Inhalt, bei dem du nur den Inhalt möchtest, keine Erklärungen

Der Schlüssel liegt darin, herauszufinden, womit Claude deinen Inhalt natürlicherweise umhüllen möchte, und das dann als Prefill und Stop-Sequenz zu verwenden. Bei Code sind das meist Markdown-Codeblöcke. Bei Listen könnten es andere Formatierungsmarker sein.

Dieser Ansatz gibt dir präzise Kontrolle über das Ausgabeformat von Claude und macht es viel einfacher, von KI generierte Inhalte in Anwendungen zu integrieren, bei denen saubere, strukturierte Daten unerlässlich sind.