Claude ist in der Lage, mit externen clientseitigen Tools und Funktionen zu interagieren, wodurch Sie Claude mit Ihren eigenen benutzerdefinierten Tools ausstatten können, um eine größere Vielfalt an Aufgaben auszuführen.

Lernen Sie alles, was Sie für die Beherrschung der Tool-Nutzung mit Claude benötigen, in unserem neuen umfassenden Tool-Nutzungskurs! Bitte teilen Sie weiterhin Ihre Ideen und Vorschläge über dieses Formular mit.

Hier ist ein Beispiel, wie man Tools für Claude über die Messages API bereitstellt:

​
Wie die Tool-Nutzung funktioniert

Integrieren Sie externe Tools mit Claude in diesen Schritten:

1

Stellen Sie Claude Tools und eine Benutzeranfrage zur Verfügung

  • Definieren Sie Tools mit Namen, Beschreibungen und Eingabeschemata in Ihrer API-Anfrage.
  • Fügen Sie eine Benutzeranfrage hinzu, die diese Tools benötigen könnte, z.B. “Wie ist das Wetter in San Francisco?”
2

Claude entscheidet sich für die Verwendung eines Tools

  • Claude bewertet, ob Tools bei der Beantwortung der Benutzeranfrage helfen können.
  • Falls ja, erstellt Claude eine korrekt formatierte Tool-Nutzungsanfrage.
  • Die API-Antwort hat einen stop_reason von tool_use, der Claudes Absicht signalisiert.
3

Extrahieren Sie die Tool-Eingabe, führen Sie Code aus und geben Sie Ergebnisse zurück

  • Extrahieren Sie auf Ihrer Seite den Tool-Namen und die Eingabe aus Claudes Anfrage.
  • Führen Sie den eigentlichen Tool-Code clientseitig aus.
  • Setzen Sie das Gespräch mit einer neuen user-Nachricht fort, die einen tool_result Inhaltsblock enthält.
4

Claude verwendet das Tool-Ergebnis zur Formulierung einer Antwort

  • Claude analysiert die Tool-Ergebnisse, um seine endgültige Antwort auf die ursprüngliche Benutzeranfrage zu erstellen.

Hinweis: Schritte 3 und 4 sind optional. Für einige Workflows könnte Claudes Tool-Nutzungsanfrage (Schritt 2) alles sein, was Sie benötigen, ohne Ergebnisse an Claude zurückzusenden.

Tools werden vom Benutzer bereitgestellt

Es ist wichtig zu beachten, dass Claude keinen Zugriff auf eingebaute serverseitige Tools hat. Alle Tools müssen explizit von Ihnen, dem Benutzer, in jeder API-Anfrage bereitgestellt werden. Dies gibt Ihnen volle Kontrolle und Flexibilität über die Tools, die Claude verwenden kann.

Die Computernutzung (Beta) Funktionalität ist eine Ausnahme - sie führt Tools ein, die von Anthropic bereitgestellt, aber von Ihnen, dem Benutzer, implementiert werden.

​
Wie man die Tool-Nutzung implementiert

​
Auswahl eines Modells

Verwenden Sie im Allgemeinen Claude 3.5 Sonnet oder Claude 3 Opus für komplexe Tools und mehrdeutige Anfragen; sie handhaben mehrere Tools besser und suchen bei Bedarf nach Klärung.

Verwenden Sie Claude 3.5 Haiku oder Claude 3 Haiku für einfache Tools, beachten Sie aber, dass sie fehlende Parameter ableiten können.

​
Spezifizierung von Tools

Tools werden im tools Top-Level-Parameter der API-Anfrage spezifiziert. Jede Tool-Definition enthält:

ParameterBeschreibung
nameDer Name des Tools. Muss dem Regex ^[a-zA-Z0-9_-]{1,64}$ entsprechen.
descriptionEine detaillierte Klartextbeschreibung dessen, was das Tool tut, wann es verwendet werden sollte und wie es sich verhält.
input_schemaEin JSON Schema Objekt, das die erwarteten Parameter für das Tool definiert.

​
Tool-Nutzungs-Systemprompt

Wenn Sie die Anthropic API mit dem tools Parameter aufrufen, erstellen wir einen speziellen Systemprompt aus den Tool-Definitionen, der Tool-Konfiguration und jedem benutzerspezifischen Systemprompt. Der erstellte Prompt ist darauf ausgelegt, das Modell anzuweisen, das angegebene Tool(s) zu verwenden und den notwendigen Kontext für das ordnungsgemäße Funktionieren des Tools bereitzustellen:

In dieser Umgebung haben Sie Zugriff auf eine Reihe von Tools, die Sie zur Beantwortung der Frage des Benutzers verwenden können.
{{ FORMATIERUNGSANWEISUNGEN }}
String- und Skalar-Parameter sollten wie angegeben spezifiziert werden, während Listen und Objekte das JSON-Format verwenden sollten. Beachten Sie, dass Leerzeichen für String-Werte nicht entfernt werden. Die Ausgabe muss kein gültiges XML sein und wird mit regulären Ausdrücken geparst.
Hier sind die verfügbaren Funktionen im JSONSchema-Format:
{{ TOOL-DEFINITIONEN IM JSON-SCHEMA }}
{{ BENUTZER-SYSTEMPROMPT }}
{{ TOOL-KONFIGURATION }}

[Fortsetzung folgt…]

Was this page helpful?

VisionComputernutzung (Beta)