Wird geladen
Wird geladen

Beim Erstellen von KI-Anwendungen mit Claude musst du ihm oft Zugriff auf Echtzeitinformationen oder die Fähigkeit geben, Aktionen auszuführen. Hier kommen Tool-Funktionen ins Spiel - das sind Python-Funktionen, die Claude aufrufen kann, wenn es zusätzliche Daten benötigt, um Nutzern zu helfen.

Claude muss das aktuelle Datum und die Uhrzeit kennen, ist nicht perfekt bei der Addition von Datum und Uhrzeit, und wir brauchen eine Möglichkeit, eine Erinnerung festzulegen.

Das obige Bild zeigt drei essenzielle Tools, die wir implementieren werden: das Abrufen des aktuellen Datums/der Uhrzeit, das Hinzufügen einer Dauer zu Daten und das Festlegen von Erinnerungen. Beginnen wir mit dem ersten.

Was sind Tool-Funktionen?

Eine Tool-Funktion ist eine einfache Python-Funktion, die automatisch ausgeführt wird, wenn Claude entscheidet, dass es zusätzliche Informationen benötigt, um einem Nutzer zu helfen. Wenn zum Beispiel jemand fragt "Wie spät ist es?", würde Claude dein Datum/Uhrzeit-Tool aufrufen, um die aktuelle Zeit zu erhalten.

Die Funktion get_weather: Sie löst einen ValueError aus, wenn der Standort leer ist, ruft dann eine Wetter-API auf und gibt JSON zurück.

Hier ist ein Beispiel für eine Wetter-Tool-Funktion. Beachte, wie sie Eingaben validiert und klare Fehlermeldungen bereitstellt - das sind wichtige Best Practices.

Best Practices für Tool-Funktionen

Befolge beim Schreiben von Tool-Funktionen diese Richtlinien:

  • Verwende aussagekräftige Namen: Sowohl dein Funktionsname als auch die Parameternamen sollten ihren Zweck klar erkennen lassen
  • Validiere Eingaben: Überprüfe, dass erforderliche Parameter nicht leer oder ungültig sind, und löse Fehler aus, wenn dies der Fall ist
  • Stelle aussagekräftige Fehlermeldungen bereit: Claude kann Fehlermeldungen sehen und den Funktionsaufruf möglicherweise mit korrigierten Parametern wiederholen

Die Validierung ist besonders wichtig, weil Claude aus Fehlern lernt. Wenn du einen klaren Fehler wie "Location cannot be empty" auslöst, versucht Claude möglicherweise, die Funktion erneut mit einem korrekten Standortwert aufzurufen.

Erstellen deiner ersten Tool-Funktion

Lass uns eine Funktion erstellen, um das aktuelle Datum und die Uhrzeit abzurufen. Diese Funktion akzeptiert einen Datumsformat-Parameter, damit Claude die Zeit in verschiedenen Formaten anfordern kann:

python
from datetime import datetime

def get_current_datetime(date_format="%Y-%m-%d %H:%M:%S"):
    if not date_format:
        raise ValueError("date_format cannot be empty")
    return datetime.now().strftime(date_format)

Diese Funktion verwendet Pythons datetime-Modul, um die aktuelle Zeit abzurufen und sie entsprechend der angegebenen Formatzeichenfolge zu formatieren. Das Standardformat liefert uns Jahr-Monat-Tag Stunde:Minute:Sekunde.

Du kannst sie mit verschiedenen Formaten testen:

python
# Standardformat: "2024-01-15 14:30:25"
get_current_datetime()

# Nur Stunde und Minute: "14:30"
get_current_datetime("%H:%M")

Die Validierungsprüfung stellt sicher, dass Claude keine leere Zeichenfolge für das Datumsformat übergeben kann. Obwohl dieser spezifische Fehler unwahrscheinlich ist, demonstriert er das Muster, Eingaben zu validieren und hilfreiche Fehlermeldungen bereitzustellen, aus denen Claude lernen kann.

Nächste Schritte

Das Erstellen der Funktion ist nur der erste Schritt. Als Nächstes musst du ein JSON-Schema schreiben, das die Funktion für Claude beschreibt, und sie dann in dein Chat-System integrieren. Dieser Tool-Funktionsansatz gibt Claude leistungsstarke Fähigkeiten, während dein Code organisiert und wartbar bleibt.