Utilizzo rigoroso degli strumenti

Impostando strict: true su una definizione di strumento, viene utilizzato il campionamento vincolato dalla grammatica per garantire che gli input degli strumenti di Claude corrispondano al tuo schema JSON. Questa pagina spiega perché la modalità rigorosa è importante per gli agenti, come abilitarla e i casi d'uso comuni. Per il sottoinsieme di schema JSON supportato, vedi Limitazioni dello schema JSON. Per la guida allo schema non rigoroso, vedi Definisci strumenti.

L'utilizzo rigoroso degli strumenti convalida i parametri dello strumento, assicurando che Claude chiami le tue funzioni con argomenti correttamente tipizzati. Usa l'utilizzo rigoroso degli strumenti quando hai bisogno di:

• Convalidare i parametri dello strumento
• Costruire flussi di lavoro agentici
• Garantire chiamate di funzioni type-safe
• Gestire strumenti complessi con proprietà annidate

Perché l'utilizzo rigoroso degli strumenti è importante per gli agenti

La costruzione di sistemi agentici affidabili richiede una conformità dello schema garantita. Senza la modalità rigorosa, Claude potrebbe restituire tipi incompatibili ("2" invece di 2) o campi obbligatori mancanti, interrompendo le tue funzioni e causando errori di runtime.

L'utilizzo rigoroso degli strumenti garantisce parametri type-safe:

• Le funzioni ricevono argomenti correttamente tipizzati ogni volta
• Non è necessario convalidare e riprovare le chiamate degli strumenti
• Agenti pronti per la produzione che funzionano in modo coerente su larga scala

Ad esempio, supponiamo che un sistema di prenotazione abbia bisogno di passengers: int. Senza la modalità rigorosa, Claude potrebbe fornire passengers: "two" o passengers: "2". Con strict: true, la risposta conterrà sempre passengers: 2.

Avvio rapido

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "strict": True,  # Enable strict mode
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'",
                    },
                },
                "required": ["location"],
                "additionalProperties": False,
            },
        }
    ],
)
print(response.content)

Formato della risposta: Blocchi di utilizzo dello strumento con input convalidati in response.content[x].input

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

Garanzie:

• L'input dello strumento segue rigorosamente l'input_schema
• Il name dello strumento è sempre valido (da strumenti forniti o strumenti del server)

Come funziona

Casi d'uso comuni

Conservazione dei dati

L'uso rigoroso degli strumenti compila le definizioni di input_schema degli strumenti in grammatiche utilizzando la stessa pipeline degli output strutturati. Gli schemi degli strumenti vengono temporaneamente memorizzati nella cache per un massimo di 24 ore dall'ultimo utilizzo. I prompt e le risposte non vengono conservati oltre la risposta dell'API.

L'uso rigoroso degli strumenti è idoneo per HIPAA, ma le PHI non devono essere incluse nelle definizioni dello schema degli strumenti. L'API memorizza nella cache gli schemi compilati separatamente dal contenuto dei messaggi, e questi schemi memorizzati nella cache non ricevono le stesse protezioni PHI dei prompt e delle risposte. Non includere PHI nei nomi delle proprietà di input_schema, nei valori di enum, nei valori di const o nelle espressioni regolari di pattern. Le PHI devono apparire solo nel contenuto dei messaggi (prompt e risposte), dove sono protette dalle garanzie di sicurezza HIPAA.

Per l'idoneità ZDR e HIPAA in tutte le funzionalità, vedi Conservazione dell'API e dei dati.