Verwendung des Werkzeugs

Bei Anthropic Claude Modellen können Sie ein Tool angeben, mit dem das Modell eine Nachricht beantworten kann. Sie könnten beispielsweise ein Tool angeben, mit dem der beliebteste Song eines Radiosenders abgerufen wird. Wenn der Benutzer die Nachricht weitergibt Was ist der beliebteste Song auf WZPZ? , stellt das Modell fest, dass das von Ihnen angegebene Tool bei der Beantwortung der Frage helfen kann. In seiner Antwort fordert das Modell Sie auf, das Werkzeug in seinem Namen auszuführen. Anschließend führen Sie das Werkzeug aus und übergeben das Werkzeugergebnis an das Modell, das dann eine Antwort für die ursprüngliche Meldung generiert. Weitere Informationen finden Sie in der Anthropic Claude Dokumentation unter Verwendung von Tools (Funktionsaufruf).

Sie geben die Tools an, die Sie einem Modell vor Ort zur Verfügung stellen möchten. tools Das folgende Beispiel bezieht sich auf ein Tool, das die beliebtesten Songs eines Radiosenders abruft.

[
    {
        "name": "top_song",
        "description": "Get the most popular song played on a radio station.",
        "input_schema": {
            "type": "object",
            "properties": {
                "sign": {
                    "type": "string",
                    "description": "The call sign for the radio station for which you want the most popular song. Example calls signs are WZPZ and WKRP."
                }
            },
            "required": [
                "sign"
            ]
        }
    }
]

Wenn das Modell ein Werkzeug benötigt, um eine Antwort auf eine Nachricht zu generieren, gibt es Informationen über das angeforderte Werkzeug und die Eingabe für das Werkzeug im content Nachrichtenfeld zurück. Außerdem wird der Grund für den Stopp der Antwort auf festgelegttool_use.

{
    "id": "msg_bdrk_01USsY5m3XRUF4FCppHP8KBx",
    "type": "message",
    "role": "assistant",
    "model": "claude-3-sonnet-20240229",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 375,
        "output_tokens": 36
    },
    "content": [
        {
            "type": "tool_use",
            "id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy",
            "name": "top_song",
            "input": {
                "sign": "WZPZ"
            }
        }
    ],
    "stop_reason": "tool_use"
}

In Ihrem Code rufen Sie das Tool im Namen des Tools auf. Anschließend übergeben Sie das Tool result (tool_result) in einer Benutzermeldung an das Modell.

{
    "role": "user",
    "content": [
        {
            "type": "tool_result",
            "tool_use_id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy",
            "content": "Elemental Hotel"
        }
    ]
}

In seiner Antwort verwendet das Modell das Werkzeugergebnis, um eine Antwort für die ursprüngliche Nachricht zu generieren.

{
    "id": "msg_bdrk_012AaqvTiKuUSc6WadhUkDLP",
    "type": "message",
    "role": "assistant",
    "model": "claude-3-sonnet-20240229",
    "content": [
        {
            "type": "text",
            "text": "According to the tool, the most popular song played on radio station WZPZ is \"Elemental Hotel\"."
        }
    ],
    "stop_reason": "end_turn"
}

Feinkörniges Tool-Streaming

Feinkörniges Tool-Streaming ist eine Anthropic Claude Modellfunktion, die mitClaude Sonnet 4.5,Claude Haiku 4.5, Claude Sonnet 4 und 4 verfügbar ist. Claude Opus Mit feinkörnigem Tool-Streaming können Claude Entwickler Parameter für die Verwendung von Tools ohne Pufferung oder JSON-Validierung streamen, wodurch die Latenz beim Empfang großer Parameter reduziert wird.

Um diese Funktion zu nutzen, fügen Sie einfach den Header fine-grained-tool-streaming-2025-05-14 zu einer Anfrage zur Verwendung eines Tools hinzu.

Hier ist ein Beispiel dafür, wie der feinkörnige Tool-Streaming-Header spezifiziert werden kann:

{
  "anthropic_version": "bedrock-2023-05-31",
  "max_tokens": 1024,
  "anthropic_beta": ["fine-grained-tool-streaming-2025-05-14"],
  "messages": [
    {
      "role": "user",
      "content": "Can you write a long poem and make a file called poem.txt?"
    }
  ],
  "tools": [
    {
      "name": "make_file",
      "description": "Write text to a file",
      "input_schema": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string",
            "description": "The filename to write text to"
          },
          "lines_of_text": {
            "type": "array",
            "description": "An array of lines of text to write to the file"
          }
        },
        "required": [
          "filename",
          "lines_of_text"
        ]
      }
    }
  ]
}

In diesem Beispiel ermöglicht das feinkörnige Tool-Streaming Claude, die Zeilen eines langen Gedichts make_file ohne Zwischenspeicherung in den Tool-Aufruf zu streamen, um zu überprüfen, ob es sich bei dem Parameter um einen gültigen JSON-Wert handelt. lines_of_text Das bedeutet, dass Sie den Parameter-Stream sehen können, sobald er eingeht, ohne darauf warten zu müssen, dass der gesamte Parameter gepuffert und validiert ist.

Bei detailliertem Tool-Streaming beginnen die Chunks, die das Tool verwenden, schneller zu streamen. Sie sind oft länger und enthalten weniger Wortumbrüche. Dies ist auf Unterschiede im Chunking-Verhalten zurückzuführen.

Zum Beispiel ohne feinkörniges Streaming (Verzögerung von 15 Sekunden):

Chunk 1: '{"'
Chunk 2: 'query": "Ty'
Chunk 3: 'peScri'
Chunk 4: 'pt 5.0 5.1 '
Chunk 5: '5.2 5'
Chunk 6: '.3'
Chunk 8: ' new f'
Chunk 9: 'eatur'
...

Mit feinkörnigem Streaming (3 Sekunden Verzögerung):

Chunk 1: '{"query": "TypeScript 5.0 5.1 5.2 5.3'
Chunk 2: ' new features comparison'

Computernutzung (Beta)

Computernutzung ist eine Anthropic Claude Modellfunktion (in der Betaversion), die mit Claude 3.5 Sonnet v2,Claude Sonnet 4.5, Claude Haiku 4.5 Claude 3.7 SonnetClaude Sonnet 4, und Claude Opus 4 verfügbar ist. ClaudeKann Ihnen bei der Computernutzung helfen, Aufgaben durch grundlegende GUI-Aktionen zu automatisieren.

Die API zur Computernutzung bietet mehrere vordefinierte Tools zur Computernutzung, die Sie verwenden können. Sie können dann eine Aufforderung mit Ihrer Anfrage erstellen, z. B. „Senden Sie Ben eine E-Mail mit den Notizen von meinem letzten Treffen“ und einen Screenshot (falls erforderlich). Die Antwort enthält eine Liste von tool_use Aktionen im JSON-Format (z. B. scroll_down, left_button_press, Screenshot). Ihr Code führt die Computeraktionen aus und stellt einen Claude Screenshot zur Verfügung, der die Ausgaben zeigt (falls angefordert).

Seit der Veröffentlichung von Claude 3.5 v2 wurde der Parameter tools aktualisiert, sodass er polymorphe Werkzeugtypen akzeptiert. Eine tool.type Eigenschaft wurde hinzugefügt, um sie zu unterscheiden. typeist optional. Wenn es weggelassen wird, wird davon ausgegangen, dass es sich bei dem Werkzeug um ein benutzerdefiniertes Werkzeug handelt (bisher der einzige unterstützte Werkzeugtyp). Um auf die Computernutzung zuzugreifen, müssen Sie den anthropic_beta Parameter mit einer entsprechenden Aufzählung verwenden, deren Wert von der verwendeten Modellversion abhängt. Weitere Informationen können Sie der folgenden Tabelle entnehmen.

Nur Anfragen, die mit diesem Parameter und Enum gestellt werden, können die Computer-Use-Tools verwenden. Es kann wie folgt angegeben werden:"anthropic_beta": ["computer-use-2025-01-24"].

Weitere Informationen finden Sie in der Dokumentation unter Computernutzung (Beta). Anthropic

Im Folgenden finden Sie ein Antwortbeispiel, bei dem davon ausgegangen wird, dass die Anfrage einen Screenshot Ihres Desktops mit einem Firefox-Symbol enthielt.

{
    "id": "msg_123",
    "type": "message",
    "role": "assistant",
    "model": "anthropic.claude-3-5-sonnet-20241022-v2:0",
    "content": [
        {
            "type": "text",
            "text": "I see the Firefox icon. Let me click on it and then navigate to a weather website."
        },
        {
            "type": "tool_use",
            "id": "toolu_123",
            "name": "computer",
            "input": {
                "action": "mouse_move",
                "coordinate": [
                    708,
                    736
                ]
            }
        },
        {
            "type": "tool_use",
            "id": "toolu_234",
            "name": "computer",
            "input": {
                "action": "left_click"
            }
        }
    ],
    "stop_reason": "tool_use",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 3391,
        "output_tokens": 132
    }
}

Anthropicdefinierte Tools

Anthropicbietet eine Reihe von Tools, mit denen bestimmte Claude Modelle Computer effektiv nutzen können. Bei der Angabe eines Anthropic definierten Tools sind die tool_schema Felder description und nicht erforderlich oder zulässig. AnthropicDefinierte Werkzeuge werden durch definiertAnthropic, aber Sie müssen die Ergebnisse des Tools explizit auswerten und tool_results zu zurückkehrenClaude. Wie bei jedem Werkzeug führt das Modell das Werkzeug nicht automatisch aus. Jedes Anthropic definierte Tool hat Versionen, die für bestimmte Modelle Claude 3.5 Sonnet (neu) optimiert sind, undClaude 3.7 Sonnet:

{ 
    "type": "text_editor_20250124", 
    "name": "str_replace_based_edit_tool" 
}

{ 
    "type": "computer_20250124", 
    "name": "computer" 
}

{ 
    "type": "text_editor_20250124", 
    "name": "str_replace_editor"
}

{ 
    "type": "bash_20250124", 
    "name": "bash" 
}

{ 
    "type": "text_editor_20241022", 
    "name": "str_replace_editor"
}

{ 
    "type": "bash_20241022", 
    "name": "bash"
}

{ 
    "type": "computer_20241022", 
    "name": "computer"
}

Das type Feld identifiziert das Werkzeug und seine Parameter zu Validierungszwecken. Das name Feld ist der Werkzeugname, der dem Modell zur Verfügung gestellt wird.

Wenn Sie das Modell auffordern möchten, eines dieser Werkzeuge zu verwenden, können Sie das Werkzeug explizit anhand des name Felds referenzieren. Das name Feld muss innerhalb der Werkzeugliste eindeutig sein. Sie können ein Werkzeug nicht mit demselben Werkzeug definieren name wie ein Anthropic definiertes Werkzeug in demselben API-Aufruf.

Automatisches Löschen von Toolaufrufen (Beta)

Claude Sonnet 4.5 unterstützt eine neue Beta-Funktion, mit der alte Ergebnisse der Werkzeugnutzung automatisch gelöscht werden, wenn Sie sich den Token-Grenzwerten nähern, was ein effizienteres Kontextmanagement in Szenarien mit mehreren Turn-Tools ermöglicht. Um das Löschen der Toolnutzung zu verwenden, müssen Sie der Liste der Beta-Header context-management-2025-06-27 den Anforderungsparameter anthropic_beta hinzufügen. Sie müssen auch die Verwendung von angeben clear_tool_uses_20250919 und aus den folgenden Konfigurationsoptionen auswählen.

Dies sind die verfügbaren Steuerelemente für die clear_tool_uses_20250919 Kontextmanagement-Strategie. Alle sind optional oder haben Standardwerte:

Wenn Sie Claude Sonnet 4.5 mit automatischem Löschen von Toolaufrufen verwenden, enthält die Antwort zusätzliche Informationen zur Kontextverwaltung:

{
    "id": "msg_013Zva2CMHLNnXjNJJKqJ2EF",
    "type": "message",
    "role": "assistant",
    "content": [...],
    ...
    "usage": {...},
    "context_management": {
        "applied_edits": [
            {
                "type": "clear_tool_uses_20250919",
                "cleared_tool_uses": 8,  # Number of tool use/result pairs that were cleared
                "cleared_input_tokens": 50000  # Total number of input tokens removed from the prompt
            }
        ]
    }
}

Speichertool (Beta)

Claude Sonnet 4.5 beinhaltet ein neues Speichertool, das Kunden die Möglichkeit bietet, den Speicher für alle Konversationen zu verwalten. Mit dieser Funktion können Kunden Claude ermöglichen, Informationen außerhalb des Kontextfensters abzurufen, indem sie Zugriff auf ein lokales Verzeichnis gewähren. Diese Funktion wird als Beta-Funktion verfügbar sein. Um diese Funktion nutzen zu können, müssen Sie den context-management-2025-06-27 Beta-Header verwenden.

Werkzeugdefinition:

{
  "type": "memory_20250818",
  "name": "memory"
}

Beispiel für eine Anfrage:

{
    "max_tokens": 2048,
    "anthropic_version": "bedrock-2023-05-31",
    "anthropic_beta": ["context-management-2025-06-27"],
    "tools": [{
        "type": "memory_20250818",
        "name": "memory"
    }],
    "messages": [
        {
            "role": "user",
            "content": [{"type": "text", "text": "Remember that my favorite color is blue and I work at Amazon?"}]
        }
    ]
}

Beispiel für eine Antwort:

{
    "id": "msg_vrtx_014mQ5ficCRB6PEa5k5sKqHd",
    "type": "message",
    "role": "assistant",
    "model": "claude-sonnet-4-20250514",
    "content": [
        {
            "type": "text",
            "text": "I'll start by checking your memory directory and then record this important information about you."
        },
        {
            "type": "tool_use",
            "id": "toolu_vrtx_01EU1UrCDigyPMRntr3VYvUB",
            "name": "memory",
            "input": {
                "command": "view",
                "path": "/memories"
            }
        }
    ],
    "stop_reason": "tool_use",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 1403,
        "cache_creation_input_tokens": 0,
        "cache_read_input_tokens": 0,
        "output_tokens": 87
    },
    "context_management": {
        "applied_edits": []
    }
}

Überlegungen zu den Kosten für den Einsatz von Tools

Die Preise für Anfragen zur Nutzung von Tools basieren auf den folgenden Faktoren:

Tools haben denselben Preis wie alle anderen Claude API-Anfragen, enthalten jedoch zusätzliche Token pro Anfrage. Die zusätzlichen Token, die sich aus der Nutzung des Tools ergeben, stammen aus den folgenden Quellen:

Wenn Sie Tools verwenden, enthalten die Anthropic Modelle automatisch eine spezielle Systemaufforderung, die die Verwendung von Tools ermöglicht. Die Anzahl der für jedes Modell erforderlichen Werkzeugnutzungstoken ist in der folgenden Tabelle aufgeführt. In dieser Tabelle sind die zuvor beschriebenen zusätzlichen Token nicht enthalten. Beachten Sie, dass in dieser Tabelle davon ausgegangen wird, dass mindestens ein Tool bereitgestellt wird. Wenn keine Tools bereitgestellt werden, werden bei der Toolauswahl „Keine“ 0 zusätzliche System-Prompt-Token verwendet.