Tool-Nutzung mit Claude

Claude ist in der Lage, mit Tools und Funktionen zu interagieren, wodurch Sie Claudes Fähigkeiten erweitern können, um eine größere Vielfalt von Aufgaben zu erfüllen.

Hier ist ein Beispiel dafür, wie Sie Claude Tools über die Messages API zur Verfügung stellen:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

Wie Tool-Nutzung funktioniert

Claude unterstützt zwei Arten von Tools:

1. Client-Tools: Tools, die auf Ihren Systemen ausgeführt werden, dazu gehören:

   • Benutzerdefinierte Tools, die Sie erstellen und implementieren
   • Von Anthropic definierte Tools wie Computer-Nutzung und Text-Editor, die eine Client-Implementierung erfordern

2. Server-Tools: Tools, die auf Anthropics Servern ausgeführt werden, wie die Web-Suche und Web-Abruf Tools. Diese Tools müssen in der API-Anfrage spezifiziert werden, erfordern aber keine Implementierung Ihrerseits.

Client-Tools

Integrieren Sie Client-Tools mit Claude in diesen Schritten:

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

Server-Tools

Server-Tools folgen einem anderen Workflow:

Tool-Nutzungsbeispiele

Hier sind einige Code-Beispiele, die verschiedene Tool-Nutzungsmuster und -techniken demonstrieren. Der Kürze halber sind die Tools einfache Tools, und die Tool-Beschreibungen sind kürzer als ideal wäre, um die beste Leistung zu gewährleisten.

Preisgestaltung

Tool use requests are priced based on:

1. The total number of input tokens sent to the model (including in the tools parameter)
2. The number of output tokens generated
3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

The additional tokens from tool use come from:

• The tools parameter in API requests (tool names, descriptions, and schemas)
• tool_use content blocks in API requests and responses
• tool_result content blocks in API requests

When you use tools, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

These token counts are added to your normal input and output tokens to calculate the total cost of a request.

Beziehen Sie sich auf unsere Modellübersichtstabelle für aktuelle Preise pro Modell.

Wenn Sie eine Tool-Nutzungsanfrage senden, gibt die Antwort, genau wie bei jeder anderen API-Anfrage, sowohl Eingabe- als auch Ausgabe-Token-Zählungen als Teil der gemeldeten usage-Metriken aus.

Nächste Schritte

Erkunden Sie unser Repository mit sofort implementierbaren Tool-Nutzungs-Code-Beispielen in unseren Kochbüchern: