Wird geladen
Wird geladen

Beim Erstellen von KI-Anwendungen mit Claude musst du ihm oft Zugriff auf Echtzeitinformationen oder die Möglichkeit 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 Benutzern zu helfen.

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

Das Bild oben zeigt drei wesentliche Tools, die wir implementieren werden: das Abrufen des aktuellen Datums/der aktuellen Uhrzeit, das Hinzufügen einer Dauer zu Daten und das Einrichten 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 feststellt, dass es zusätzliche Informationen benötigt, um eine Aufgabe abzuschließen. Wenn ein Benutzer zum Beispiel fragt "Wie spät ist es?", würde Claude dein Datum/Uhrzeit-Tool aufrufen, um die aktuelle Uhrzeit zu erhalten.

Die get_weather-Funktion: 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 liefert - das sind wichtige Best Practices, die wir befolgen werden.

Best Practices für Tool-Funktionen

Beachte beim Schreiben von Tool-Funktionen die folgenden Richtlinien:

  • Verwende beschreibende Namen: Sowohl dein Funktionsname als auch die Parameternamen sollten klar ihren Zweck angeben
  • Validiere Eingaben: Überprüfe immer, ob erforderliche Parameter vorhanden und gültig sind
  • Liefere aussagekräftige Fehlermeldungen: Wenn Claude einen Fehler erhält, könnte es versuchen, deine Funktion erneut mit korrigierten Parametern aufzurufen

Die Fehlerbehandlung ist besonders wichtig, weil Claude aus Fehlern lernen kann. Wenn du eine klare Fehlermeldung wie "Standort darf nicht leer sein" zurückgibst, könnte Claude den Funktionsaufruf mit einem korrekten Standortwert erneut versuchen.

Erstellen deiner ersten Tool-Funktion

Lass uns eine Funktion erstellen, um das aktuelle Datum und die aktuelle Uhrzeit zu erhalten. Diese Funktion akzeptiert einen Formatstring, um zu steuern, wie das Datum erscheint:

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)

Der Standard-Formatstring "%Y-%m-%d %H:%M:%S" erzeugt eine Ausgabe wie "2024-03-15 14:30:45". Du kannst dies anpassen, indem du unterschiedliche Formatstrings übergibst:

python
# Nur die Uhrzeit abrufen
get_current_datetime("%H:%M")  # Returns "14:30"

# Ein anderes Datumsformat abrufen  
get_current_datetime("%B %d, %Y")  # Returns "March 15, 2024"

Eingabevalidierung

Die Validierungsprüfung if not date_format: stellt sicher, dass wir nicht versuchen, ein Datum mit einem leeren String zu formatieren. Obwohl Claude diesen Fehler selten macht, hilft das Bereitstellen klarer Fehlermeldungen der KI zu verstehen, was schiefgelaufen ist und wie es behoben werden kann.

Wenn Claude auf einen Fehler stößt, sieht es die genaue Fehlermeldung. Diese Feedback-Schleife ermöglicht es Claude, seinen Ansatz anzupassen und es mit korrigierten Parametern erneut zu versuchen.

Nächste Schritte

Diese Tool-Funktion ist nur der erste Schritt. Als Nächstes musst du ein JSON-Schema erstellen, das diese Funktion für Claude beschreibt, und sie dann in dein Chat-System integrieren. Die Funktion selbst ist einfaches Python - die Komplexität liegt darin, sie richtig mit Claudes Tool-Aufrufsystem zu verbinden.