Uso estrito de ferramentas

Definir strict: true em uma definição de ferramenta garante que as entradas de ferramentas do Claude correspondam ao seu JSON Schema, restringindo a amostragem de tokens do modelo a saídas válidas segundo o schema (uma técnica chamada "grammar-constrained sampling", ou amostragem restrita por gramática). Esta página aborda por que o modo estrito é importante para agentes, como habilitá-lo e casos de uso comuns. Para o subconjunto de JSON Schema suportado, consulte Limitações do JSON Schema. Para orientações sobre schemas não estritos, consulte Definir ferramentas.

O uso estrito de ferramentas valida os parâmetros das ferramentas, garantindo que Claude chame suas funções com argumentos de tipos corretos. Use o uso estrito de ferramentas quando você precisar:

• Validar parâmetros de ferramentas
• Construir fluxos de trabalho agênticos
• Garantir chamadas de função com segurança de tipos
• Lidar com ferramentas complexas com propriedades aninhadas



Por que o uso estrito de ferramentas é importante para agentes

Construir sistemas agênticos confiáveis requer conformidade garantida com o schema. Sem o modo estrito, Claude pode retornar tipos incompatíveis ("2" em vez de 2) ou omitir campos obrigatórios, quebrando suas funções e causando erros em tempo de execução.

O uso estrito de ferramentas garante parâmetros com segurança de tipos:

• As funções recebem argumentos de tipos corretos todas as vezes
• Não há necessidade de validar e repetir chamadas de ferramentas
• Agentes prontos para produção que funcionam de forma consistente em escala

Por exemplo, suponha que um sistema de reservas precise de passengers: int. Sem o modo estrito, Claude pode fornecer passengers: "two" ou passengers: "2". Com strict: true, a resposta sempre contém passengers: 2.



Início rápido

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    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 da resposta: Blocos de tool use com entradas validadas em response.content[x].input

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

Garantias:

• O input da ferramenta segue estritamente o input_schema
• O name da ferramenta é sempre válido (das ferramentas fornecidas ou ferramentas de servidor)



Como funciona



Casos de uso comuns



Retenção de dados

O uso estrito de ferramentas compila as definições de input_schema das ferramentas em gramáticas usando o mesmo pipeline das saídas estruturadas. Os schemas de ferramentas são armazenados temporariamente em cache por até 24 horas desde o último uso. Prompts e respostas não são retidos além da resposta da API.

O uso estrito de ferramentas é elegível para HIPAA, mas PHI não deve ser incluído nas definições de schema de ferramentas. A API armazena em cache os schemas compilados separadamente do conteúdo das mensagens, e esses schemas em cache não recebem as mesmas proteções de PHI que os prompts e respostas. Não inclua PHI em nomes de propriedades do input_schema, valores de enum, valores de const ou expressões regulares de pattern. PHI deve aparecer apenas no conteúdo das mensagens (prompts e respostas), onde é protegido pelas salvaguardas da HIPAA.

Para elegibilidade de ZDR e HIPAA em todos os recursos, consulte API e retenção de dados.



Próximos passos