Tool functions

Studiennotizen: Implementierung von Tools

**I. Grundkonzepte und Vorbereitung**

• Ziel: Implementierung des ersten Tools zur Abfrage der aktuellen Uhrzeit und des Datums.
• Arbeitsumgebung: Nutzung des Notebook "001 Tools" als Basis.
• Fokus: Direkte Implementierung der Tool-Aufrufe, um die bestehenden Hilfsfunktionen (z. B. add user message) zu umgehen und den Lernprozess zu fokussieren.

**II. Definition einer 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.
• Best Practices für Tool-Funktionen:
• Benennung: Verwenden Sie gut benannte und beschreibende Argumente.
• Validierung: Validieren Sie alle Eingaben und werfen Sie bei fehlerhaften Daten sofort einen Fehler (Error) aus.
• Fehlermeldungen: Die Fehlermeldung muss aussagekräftig sein, damit Claude den Fehler versteht und den Tool-Aufruf korrigieren kann (z. B. durch erneuten Versuch mit korrigierten Parametern).

**III. Implementierungsbeispiel: Aktuelles Datum/Uhrzeit**

• Funktionsname: get current date time
• Argument: date format (mit einem Standardwert).
• Logik:
• Die Funktion nutzt das date format, um die aktuelle Zeit (datetime. now()) zu formatieren.
• Verbesserung/Validierung: Fügen Sie eine Prüfung hinzu, ob das Argument date format leer ist (if not date format).
• Fehlerbehandlung: Bei leeren Eingaben muss ein ValueError mit einer klaren Meldung geworfen werden (z. B. "date format cannot be empty").
• Zweck der Validierung: Die Fehlermeldung dient als Signal an Claude, um den Tool-Aufruf zu verbessern und eine gültige Eingabe zu liefern.

Takeaways

• Eine Tool-Funktion ist eine Python-Funktion, die automatisch ausgeführt wird, wenn Claude zusätzliche Informationen benötigt.
• Best Practices erfordern gut benannte Argumente, strenge Validierung der Eingaben und aussagekräftige Fehlermeldungen.
• Die Validierung von Eingaben (z. B. Prüfung auf Leere) ist essenziell, um Fehler frühzeitig zu erkennen.
• Fehlermeldungen (z. B. ein ValueError) dienen als Signal an Claude, um den Tool-Aufruf zu korrigieren und eine gültige Eingabe zu liefern.