Wird geladen

Umgang mit Nachrichtenblöcken

Lektion 247 Min.
Wird geladen

Wenn du mit der Tool-Funktionalität von Claude arbeitest, wirst du auf eine neue Art von Antwortstruktur stoßen, die sich von den einfachen Textantworten unterscheidet, die du bisher gesehen hast. Anstatt nur einen einzelnen Textblock zurückzubekommen, kann Claude nun mehrteilige Nachrichten zurückgeben, die sowohl Text als auch Informationen zur Tool-Nutzung enthalten.

Tool-fähige API-Aufrufe durchführen

Damit Claude Tools verwenden kann, musst du einen tools-Parameter in deinen API-Aufruf einbeziehen. So strukturierst du die Anfrage:

python
messages = []
messages.append({
    "role": "user",
    "content": "What is the exact time, formatted as HH:MM:SS?"
})

response = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=messages,
    tools=[get_current_datetime_schema],
)

Der tools-Parameter nimmt eine Liste von JSON-Schemas entgegen, die die verfügbaren Funktionen beschreiben, die Claude aufrufen kann.

Mehrteilige Nachrichten verstehen

Wenn Claude sich entscheidet, ein Tool zu verwenden, gibt es eine Assistant-Nachricht mit mehreren Blöcken in der Content-Liste zurück. Das ist eine bedeutende Veränderung gegenüber den einfachen, reinen Textantworten, mit denen du bisher gearbeitet hast.

Der Text Block und ToolUse Block einer Assistant-Nachricht mit Eingabe date_format "%H:%M:%S"; Blöcke werden auch "parts" genannt.

Eine mehrteilige Nachricht enthält typischerweise:

  • Text Block - Menschenlesbarer Text, der erklärt, was Claude gerade tut (etwa "Ich kann dir helfen, die aktuelle Uhrzeit herauszufinden. Lass mich diese Information für dich finden")
  • ToolUse Block - Anweisungen für deinen Code darüber, welches Tool aufgerufen werden soll und welche Parameter verwendet werden sollen

Der ToolUse-Block enthält:

  • Eine ID zur Nachverfolgung des Tool-Aufrufs
  • Den Namen der aufzurufenden Funktion (wie "get_current_datetime")
  • Eingabeparameter, formatiert als Dictionary
  • Die Typbezeichnung "tool_use"

Gesprächsverlauf mit mehrteiligen Nachrichten verwalten

Denk daran, dass Claude den Gesprächsverlauf nicht speichert - du musst ihn manuell verwalten. Wenn du mit Tool-Antworten arbeitest, musst du die gesamte Content-Struktur bewahren, einschließlich aller Blöcke.

So hängst du eine mehrteilige Assistant-Nachricht korrekt an deinen Gesprächsverlauf an:

messages.append({
    "role": "assistant",
    "content": response.content
})

Dies bewahrt sowohl den Textblock als auch den ToolUse-Block, was entscheidend ist, um den Gesprächskontext bei nachfolgenden API-Aufrufen aufrechtzuerhalten.

Der vollständige Ablauf der Tool-Nutzung

Notebook-Zelle mit add_user_message und add_assistant_message, die "role"- und "content"-Dictionaries hinzufügen, sowie eine chat-Funktion.

Der Ablauf der Tool-Nutzung folgt diesem Muster:

  1. Sende die Nutzernachricht zusammen mit dem Tool-Schema an Claude
  2. Erhalte eine Assistant-Nachricht mit einem Text Block und einem ToolUse Block
  3. Extrahiere die Tool-Informationen und führe die eigentliche Funktion aus
  4. Sende das Tool-Ergebnis zusammen mit dem vollständigen Gesprächsverlauf zurück an Claude
  5. Erhalte die endgültige Antwort von Claude

Jeder Schritt erfordert einen sorgfältigen Umgang mit der Nachrichtenstruktur, um sicherzustellen, dass Claude den vollständigen Kontext hat, den es benötigt, um genaue Antworten zu liefern.

Hilfsfunktionen aktualisieren

Wenn du bisher Hilfsfunktionen wie add_user_message() und add_assistant_message() verwendet hast, musst du sie aktualisieren, damit sie mehrteilige Inhalte verarbeiten können. Die aktuellen Versionen unterstützen wahrscheinlich nur einzelne Textblöcke, aber jetzt müssen sie die komplexeren Content-Strukturen berücksichtigen, die ToolUse Blocks enthalten.

Dieser Umgang mit mehrteiligen Nachrichten ist essenziell für den Aufbau robuster Anwendungen, die die Tool-Fähigkeiten von Claude nahtlos integrieren können, während der ordnungsgemäße Gesprächsfluss erhalten bleibt.