...
Eroare Aplicații AI cu LLM · Tool use și function calling

anthropic.BadRequestError: Error code: 400 - tools.0.input_schema: Field required

Pe scurt

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

Greșit
PYTHON
TOOLS = [{"name": "verifica_stoc", "description": "Stocul unui produs.",
          "parameters": {"type": "object", "properties": {"produs": {"type": "string"}}}}]
Corect
PYTHON
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

Greșit
PYTHON
TOOLS = [{"type": "function", "function": {"name": "verifica_stoc", "parameters": SCHEMA}}]
Corect
PYTHON
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

Greșit
PYTHON
{"name": "verifică stoc", "input_schema": SCHEMA}
Corect
PYTHON
{"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ă tu

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>.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
stop_reason: tool_use
Tool cerut: programare_libera {'specialitate': 'dermatologie'}
Indiciu

La Claude, schema argumentelor stă în input_schema, nu în parameters.

Alte forme ale mesajului

  • anthropic.BadRequestError: Error code: 400 - invalid_request_error: tools.0.input_schema: Field required
  • tools.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 și required; adaugă additionalProperties: false dacă folosești strict.
  • 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

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.