Tool functions

📝 Lernnotizen: Implementierung von Tool-Funktionen

Ziel: Implementierung des ersten Tools zur Abfrage des aktuellen Datums und der Uhrzeit.

Grundlagen der Tool-Funktion:

• Definition: Eine Tool-Funktion ist eine Python-Funktion, die automatisch ausgeführt wird, wenn Claude zusätzliche Informationen benötigt, um dem Benutzer zu helfen.
• Fokus: Beim Lernen wird bewusst auf die Nutzung bestehender Hilfsfunktionen verzichtet, um sich voll auf die Tool-Implementierung zu konzentrieren.

Best Practices für Tool-Funktionen:

• Argumentierung: Verwenden Sie gut benannte und beschreibende Argumente.
• Validierung: Validieren Sie alle Eingaben. Bei ungültigen Eingaben muss sofort ein Fehler geworfen werden (z. B. wenn ein Ort fehlt oder ein String leer ist).
• Fehlermeldungen: Fehler müssen aussagekräftig sein. Claude nutzt diese Meldungen, um den Fehler zu erkennen und den Tool-Aufruf selbst zu korrigieren und erneut zu versuchen.

Implementierung: get current date time

• Funktionsziel: Abrufen und Formatieren des aktuellen Datums/der Uhrzeit.
• Parameter:
• date format: Ein optionales Argument, das das gewünschte Format definiert (z. B. %Y-%m-%d).
• Logik:
• Die Funktion nutzt datetime. now() und strftime(), um das aktuelle Datum im angegebenen Format zurückzugeben.
• Verbesserung/Validierung:
• Es sollte eine Validierung implementiert werden, um sicherzustellen, dass das date format nicht leer ist.
• Wenn die Validierung fehlschlägt, wird ein spezifischer Fehler geworfen (z. B. "date format cannot be empty").

Takeaways

• Tool-Funktionen sind Python-Funktionen, die automatisch ausgeführt werden, wenn Claude externe Informationen benötigt.
• Best Practices verlangen gut benannte Argumente und die strikte Validierung aller Eingaben.
• Fehler müssen aussagekräftig sein, da Claude diese Meldungen nutzt, um den Tool-Aufruf selbst zu korrigieren und erneut zu versuchen.
• Die Implementierung der Datumsabfrage nutzt datetime. now() und strftime(), um das Datum im gewünschten Format zu formatieren.
• Es ist zwingend erforderlich, Eingaben zu validieren und bei ungültigen Parametern sofort einen spezifischen Fehler zu werfen.