Wird geladen

Tool-Funktionen ausführen

Lektion 2510 Min.
Wird geladen

Wenn Claude mit einer Tool-Nutzungsanfrage antwortet, muss dein Server das angeforderte Tool tatsächlich ausführen und die Ergebnisse zurücksenden. Dieser Schritt umfasst das Extrahieren der Tool-Nutzungs-Teile aus Claudes Antwort, das Ausführen der entsprechenden Funktionen und die korrekte Formatierung der Ergebnisse.

Umgang mit mehreren Tool-Anfragen

Claude kann mehrere Tool-Nutzungs-Teile in einer einzigen Antwort senden. Dein Code muss diese Möglichkeit defensiv behandeln. Eine Assistentennachricht kann einen Text-Teil enthalten, gefolgt von einem, zwei oder sogar noch mehr Tool-Nutzungs-Teilen.

Teile der Assistentennachricht: ein „Text“-Teil, der anbietet, die aktuelle Uhrzeit zu ermitteln, und ein „toolUse“-Teil für get_current_datetime.

Der Ablauf funktioniert folgendermaßen: Claude sendet eine Anfrage mit JSON-Schema, erhält einen Tool-Nutzungs-Teil, dann führt dein Server das Tool aus und sendet einen Tool-Ergebnis-Teil zurück, damit Claude eine endgültige Antwort liefern kann.

Unser Server sendet Claude die Benutzernachricht „Wie spät ist es?“, den Assistenten-Text- und Tool-Nutzungs-Teil, dann einen Tool-Ergebnis-Teil.

Extrahieren der Tool-Nutzungs-Teile

Erstelle zunächst eine Funktion, um alle aus einer Chat-Anfrage zurückgegebenen Teile zu verarbeiten:

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]

Diese Comprehension filtert die Liste der Teile so, dass nur Dictionaries enthalten sind, die einen „toolUse“-Schlüssel enthalten, und ignoriert dabei Text-Teile.

Ausführen der eigentlichen Tools

Erstelle eine Hilfsfunktion, um das angeforderte Tool auszuführen:

python
def run_tool(tool_name, tool_input):
    if tool_name == "get_current_datetime":
        return get_current_datetime(**tool_input)
    else:
        raise Exception(f"Unknown tool name: {tool_name}")

Das entscheidende Detail hier ist die Verwendung von **tool_input, um das Dictionary der Argumente in deine Tool-Funktion zu splatten. Claude gibt Argumente immer als Dictionary-Objekt zurück, daher musst du es korrekt entpacken.

Erstellen von Tool-Ergebnis-Teilen

Nachdem du ein Tool ausgeführt hast, musst du die Antwort als Tool-Ergebnis-Teil formatieren:

Eine Liste von Assistentennachrichteninhalten mit einem Text-Teil und zwei „toolUse“-Teilen, für get_current_datetime und other_tool.

Tool-Ergebnis-Teile erfordern drei Schlüsseleigenschaften:

  • toolUseId - Muss mit der ID des ursprünglichen Tool-Nutzungs-Teils übereinstimmen
  • content - Die Ausgabe deines Tools, als String serialisiert
  • status - Entweder „success“ oder „error“

Tool-Nutzungs-IDs verstehen

Das System der Tool-Nutzungs-IDs wird wichtig, wenn Claude mehrere Tools parallel anfordert. Wenn Claude beispielsweise ein Taschenrechner-Tool zweimal ausführen möchte:

Claude sendet die Taschenrechner-Tool-Nutzungen ab3 für 10 + 10 und po9 für 30 + 30; unser Server gibt po9-Ausgabe 60 und ab3-Ausgabe 20 zurück. Claude sendet die Taschenrechner-Tool-Nutzungen ab3 für 10 + 10 und po9 für 30 + 30; unser Server gibt po9-Ausgabe 60 und ab3-Ausgabe 20 zurück.

Jede Tool-Nutzung erhält eine eindeutige ID (wie „ab3“ und „po9“), und deine Tool-Ergebnisse müssen die passenden IDs enthalten, damit Claude weiß, welches Ergebnis zu welcher Anfrage gehört.

Fehlerbehandlung

Umschließe deine Tool-Ausführung mit try-catch-Blöcken. Claude geht intelligent mit Tool-Fehlern um und passt seinen Ansatz möglicherweise an, wenn du korrekte Fehlerinformationen zurückgibst:

python
try:
    tool_output = run_tool(tool_name, tool_input)
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": json.dumps(tool_output)}],
            "status": "success"
        }
    }
except Exception as e:
    tool_result_part = {
        "toolResult": {
            "toolUseId": tool_use_id,
            "content": [{"text": f"Error: {e}"}],
            "status": "error"
        }
    }

Vollständige Implementierung

Hier ist die vollständige Funktion, die Tool-Anfragen verarbeitet und formatierte Ergebnisse zurückgibt:

python
def run_tools(parts):
    tool_requests = [part for part in parts if "toolUse" in part]
    tool_result_parts = []
    
    for tool_request in tool_requests:
        tool_use_id = tool_request["toolUse"]["toolUseId"]
        tool_name = tool_request["toolUse"]["name"]
        tool_input = tool_request["toolUse"]["input"]
        
        try:
            tool_output = run_tool(tool_name, tool_input)
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": json.dumps(tool_output)}],
                    "status": "success"
                }
            }
        except Exception as e:
            tool_result_part = {
                "toolResult": {
                    "toolUseId": tool_use_id,
                    "content": [{"text": f"Error: {e}"}],
                    "status": "error"
                }
            }
        
        tool_result_parts.append(tool_result_part)
    
    return tool_result_parts

Sobald du die Tool-Ergebnis-Teile hast, kannst du sie in deiner nächsten Chat-Anfrage an Claude zurücksenden und so den Tool-Nutzungs-Zyklus abschließen.