Strikte Werkzeugnutzung

Das Setzen von strict: true auf einer Werkzeugdefinition verwendet grammatikgestütztes Sampling, um zu garantieren, dass Claude's Werkzeugeingaben Ihrem JSON-Schema entsprechen. Diese Seite behandelt, warum der strikte Modus für Agenten wichtig ist, wie man ihn aktiviert, und häufige Anwendungsfälle. Für die unterstützte JSON-Schema-Teilmenge siehe JSON-Schema-Einschränkungen. Für Anleitung zu nicht-striktem Schema siehe Werkzeuge definieren.

Strikte Werkzeugnutzung validiert Werkzeugparameter und stellt sicher, dass Claude Ihre Funktionen mit korrekt typisierten Argumenten aufruft. Verwenden Sie strikte Werkzeugnutzung, wenn Sie Folgendes benötigen:

• Werkzeugparameter validieren
• Agentenworkflows erstellen
• Typsichere Funktionsaufrufe sicherstellen
• Komplexe Werkzeuge mit verschachtelten Eigenschaften handhaben

Warum strikte Werkzeugnutzung für Agenten wichtig ist

Der Aufbau zuverlässiger Agentensysteme erfordert garantierte Schema-Konformität. Ohne strikten Modus könnte Claude inkompatible Typen zurückgeben ("2" statt 2) oder erforderliche Felder vermissen, was Ihre Funktionen beschädigt und Laufzeitfehler verursacht.

Strikte Werkzeugnutzung garantiert typsichere Parameter:

• Funktionen erhalten jedes Mal korrekt typisierte Argumente
• Keine Notwendigkeit, Werkzeugaufrufe zu validieren und erneut zu versuchen
• Produktionsreife Agenten, die konsistent in großem Maßstab funktionieren

Angenommen, ein Buchungssystem benötigt passengers: int. Ohne strikten Modus könnte Claude passengers: "two" oder passengers: "2" bereitstellen. Mit strict: true enthält die Antwort immer passengers: 2.

Schnellstart

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-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "What is the weather in San Francisco?"}
    ],
    "tools": [{
      "name": "get_weather",
      "description": "Get the current weather in a given location",
      "strict": true,
      "input_schema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "The city and state, e.g. San Francisco, CA"
          },
          "unit": {
            "type": "string",
            "enum": ["celsius", "fahrenheit"]
          }
        },
        "required": ["location"],
        "additionalProperties": false
      }
    }]
  }'

Antwortformat: Werkzeugnutzungsblöcke mit validierten Eingaben in response.content[x].input

{
  "type": "tool_use",
  "name": "get_weather",
  "input": {
    "location": "San Francisco, CA"
  }
}

Garantien:

• Werkzeug input folgt streng dem input_schema
• Werkzeug name ist immer gültig (von bereitgestellten Werkzeugen oder Server-Werkzeugen)

Wie es funktioniert

Häufige Anwendungsfälle

Datenspeicherung

Die strikte Tool-Nutzung kompiliert Tool-input_schema-Definitionen in Grammatiken unter Verwendung derselben Pipeline wie strukturierte Ausgaben. Tool-Schemas werden temporär für bis zu 24 Stunden seit der letzten Verwendung zwischengespeichert. Prompts und Antworten werden nicht über die API-Antwort hinaus beibehalten.

Die strikte Tool-Nutzung ist HIPAA-berechtigt, aber PHI darf nicht in Tool-Schema-Definitionen enthalten sein. Die API speichert kompilierte Schemas separat vom Nachrichteninhalt, und diese zwischengespeicherten Schemas erhalten nicht denselben PHI-Schutz wie Prompts und Antworten. Fügen Sie PHI nicht in input_schema-Eigenschaftsnamen, enum-Werte, const-Werte oder pattern-Regex-Ausdrücke ein. PHI sollte nur in Nachrichteninhalten (Prompts und Antworten) erscheinen, wo es unter HIPAA-Schutzmaßnahmen geschützt ist.

Für ZDR- und HIPAA-Berechtigung über alle Funktionen hinweg siehe API und Datenspeicherung.