anthropic.BadRequestError: Error code: 400 - tools.0.input_schema: Field required
Definiția tool-ului trimisă la Claude nu are câmpul `input_schema`. De obicei e o definiție în format OpenAI (`parameters` sau `{"type": "function", "function": {...}}`): la Claude, tool-ul are `name`, `description` și `input_schema`, o schemă JSON de tip `object`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul are trei părți: tools.0 = primul tool din listă (numărarea începe de la 0), input_schema = câmpul care lipsește, Field required = câmpul e obligatoriu. API-ul validează forma fiecărui tool înainte să ruleze modelul.
Formatul diferă între furnizori. Claude: {"name": ..., "description": ..., "input_schema": {"type": "object", "properties": {...}, "required": [...]}}. OpenAI Responses: {"type": "function", "name": ..., "description": ..., "parameters": {...}}. Chat Completions: {"type": "function", "function": {"name": ..., "parameters": {...}}}. Când muți un tool de la un furnizor la altul sau copiezi o definiție dintr-un exemplu, e ușor să rămână parameters în loc de input_schema.
Erori înrudite din aceeași validare: tools.0.name: String should match pattern '^[a-zA-Z0-9_-]{1,64}$' (numele are spații sau diacritice) și tools.0.input_schema.type: Input should be 'object' (schema nu e de tip object).
De ce apare: cauzele frecvente
1Definiție în format OpenAI trimisă la Claude
TOOLS = [{"name": "verifica_stoc", "description": "Stocul unui produs.",
"parameters": {"type": "object", "properties": {"produs": {"type": "string"}}}}]TOOLS = [{"name": "verifica_stoc", "description": "Stocul unui produs.",
"input_schema": {"type": "object", "properties": {"produs": {"type": "string"}}}}]La Claude, schema argumentelor se numește input_schema. Restul definiției rămâne la fel.
2Formatul Chat Completions, cu function în interior
TOOLS = [{"type": "function", "function": {"name": "verifica_stoc", "parameters": SCHEMA}}]TOOLS = [{"name": "verifica_stoc", "description": "Stocul unui produs.", "input_schema": SCHEMA}]Claude nu folosește învelișul type/function: câmpurile tool-ului stau direct în dicționar.
3Nume de tool cu spații sau diacritice
{"name": "verifică stoc", "input_schema": SCHEMA}{"name": "verifica_stoc", "input_schema": SCHEMA}Numele acceptă doar litere fără diacritice, cifre, _ și -; altfel primești eroarea de pattern pe tools.0.name.
Repară eroarea, direct în pagină
Codul de mai jos dă BadRequestError: ... tools.0.input_schema: Field required: definiția tool-ului a fost copiată dintr-un exemplu OpenAI. Repară definiția ca să respecte formatul Claude (name, description, input_schema). Programul afișează stop_reason: ... și Tool cerut: <nume> <input>.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
TOOLS = [{
"name": "programare_libera",
"description": "Întoarce primul interval liber la clinică pentru o specialitate.",
"parameters": {
"type": "object",
"properties": {"specialitate": {"type": "string"}},
"required": ["specialitate"],
},
}]
r = client.messages.create(
model=MODEL,
max_tokens=300,
tools=TOOLS,
messages=[{"role": "user", "content": "Când am loc la dermatologie?"}],
)
print("stop_reason:", r.stop_reason)
for b in r.content:
if b.type == "tool_use":
print("Tool cerut:", b.name, b.input)stop_reason: tool_use
Tool cerut: programare_libera {'specialitate': 'dermatologie'}Indiciu
La Claude, schema argumentelor stă în input_schema, nu în parameters.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
TOOLS = [{
"name": "programare_libera",
"description": "Întoarce primul interval liber la clinică pentru o specialitate.",
"input_schema": {
"type": "object",
"properties": {"specialitate": {"type": "string"}},
"required": ["specialitate"],
},
}]
r = client.messages.create(
model=MODEL,
max_tokens=300,
tools=TOOLS,
messages=[{"role": "user", "content": "Când am loc la dermatologie?"}],
)
print("stop_reason:", r.stop_reason)
for b in r.content:
if b.type == "tool_use":
print("Tool cerut:", b.name, b.input)De ce merge
API-ul Claude caută schema argumentelor în câmpul input_schema și refuză tool-ul fără el. Schema însăși (tip object, proprietăți, câmpuri obligatorii) era deja corectă; doar numele câmpului diferă între furnizori. Cu definiția reparată, modelul poate cere tool-ul, iar răspunsul are stop_reason: tool_use.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - invalid_request_error: tools.0.input_schema: Field requiredtools.0.name: String should match pattern '^[a-zA-Z0-9_-]{1,64}$'tools.0.input_schema.type: Input should be 'object'
Cum o eviți pe viitor
- Ține definițiile tool-urilor într-un singur loc și, dacă folosești ambii furnizori, scrie o funcție care convertește din formatul tău în cel al fiecăruia.
- Scrie schemele cu
"type": "object",propertiesșirequired; adaugăadditionalProperties: falsedacă foloseștistrict. - Folosește nume de tool-uri în
snake_case, fără diacritice.
Întrebări frecvente
Ce înseamnă tools.0?
Poziția tool-ului în lista tools, numărată de la 0. Dacă ai mai multe tool-uri, numărul îți arată exact care definiție e greșită.
Trebuie description neapărat?
Nu e obligatorie, dar e foarte importantă: din descriere înțelege modelul când și cum să folosească tool-ul. O descriere clară reduce apelurile greșite.
Erori înrudite
anthropic.BadRequestError: Error code: 400 - messages.2: `tool_use` ids were found without `tool_result` blocks immediately after: toolu_01A09q90qw90lq917835lq9. Each `tool_use` block must have a corresponding `tool_result` block in the next message. Modelul a cerut un tool (bloc `tool_use`), iar mesajul următor din conversație nu conține rezultatul lui. Imediat după mesajul `assistant` cu `tool_use`, trimite un mesaj `user` cu un bloc `{"type": "tool_result", "tool_use_id": bloc.id, "content": "..."}` pentru fiecare apel. AttributeError: 'ToolUseBlock' object has no attribute 'text' Ai citit `raspuns.content[0].text`, dar primul bloc nu e text: modelul a cerut un tool (`stop_reason == "tool_use"`), iar blocurile `tool_use` au `name` și `input`, nu `text`. Verifică `bloc.type` înainte să citești câmpurile și tratează apelul de tool. TypeError: verifica_stoc() got an unexpected keyword argument 'marime' Ai apelat funcția tool-ului cu argumentele modelului (`functie(**bloc.input)`), iar modelul a trimis un argument pe care funcția nu îl are. Fă funcția să accepte toate proprietățile din schemă (cu valori implicite pentru cele opționale) și validează argumentele înainte de apel. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
