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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În bucla de tool use, după un răspuns cu stop_reason == "tool_use", conversația trebuie să continue într-un mod precis: mesajul assistant cu blocurile tool_use (exact cum au venit), apoi un mesaj user care conține câte un tool_result pentru fiecare tool_use, legat prin tool_use_id. Mesajul erorii arată poziția (messages.2) și id-urile rămase fără rezultat.
Cauzele frecvente: rezultatul e trimis ca text simplu („Stocul este 5”) în loc de bloc tool_result; modelul a cerut două tool-uri în paralel și ai trimis rezultatul doar pentru unul; ai pus rezultatele în două mesaje separate; sau ai adăugat un mesaj nou al utilizatorului între cerere și rezultat.
Eroarea inversă, unexpected tool_use_id found in tool_result blocks, înseamnă că ai trimis un rezultat cu un id care nu apare în mesajul anterior (de obicei un id greșit sau mesajul assistant lipsă).
De ce apare: cauzele frecvente
1Rezultatul trimis ca text simplu
mesaje.append({"role": "assistant", "content": r.content})
mesaje.append({"role": "user", "content": f"Stoc: {stoc}"})mesaje.append({"role": "assistant", "content": r.content})
mesaje.append({"role": "user", "content": [
{"type": "tool_result", "tool_use_id": bloc.id, "content": f"Stoc: {stoc}"}]})API-ul leagă rezultatul de cerere prin tool_use_id. Un text simplu nu are această legătură.
2Rezultat doar pentru primul dintre mai multe tool-uri
bloc = [b for b in r.content if b.type == "tool_use"][0]
rezultate = [{"type": "tool_result", "tool_use_id": bloc.id, "content": executa(bloc)}]rezultate = [{"type": "tool_result", "tool_use_id": b.id, "content": executa(b)}
for b in r.content if b.type == "tool_use"]
mesaje.append({"role": "user", "content": rezultate})Modelul poate cere mai multe tool-uri deodată; fiecare tool_use are nevoie de rezultatul lui, toate în același mesaj.
3Rezultatele împărțite în mai multe mesaje
for b in tool_uri:
mesaje.append({"role": "user", "content": [{"type": "tool_result", "tool_use_id": b.id, "content": executa(b)}]})mesaje.append({"role": "user", "content": [
{"type": "tool_result", "tool_use_id": b.id, "content": executa(b)} for b in tool_uri]})Toate rezultatele merg într-un singur mesaj user, imediat după cererea modelului.
Repară eroarea, direct în pagină
Asistentul de stoc de mai jos primește o eroare 400 la al doilea apel: tool_use ids were found without tool_result blocks immediately after. Repară mesajul trimis după rularea tool-ului: în loc de text simplu, trimite un bloc tool_result cu tool_use_id egal cu id-ul blocului tool_use. Programul afișează răspunsul final al modelului.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
TOOLS = [{
"name": "verifica_stoc",
"description": "Întoarce câte bucăți sunt în stoc dintr-un produs.",
"input_schema": {"type": "object", "properties": {"produs": {"type": "string"}}, "required": ["produs"]},
}]
STOC = {"bicicleta de oras": 4}
def verifica_stoc(produs):
return f"{STOC.get(produs, 0)} bucăți în stoc"
mesaje = [{"role": "user", "content": "Mai aveți bicicleta de oras?"}]
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
bloc = next(b for b in r.content if b.type == "tool_use")
rezultat = verifica_stoc(**bloc.input)
mesaje.append({"role": "assistant", "content": r.content})
mesaje.append({"role": "user", "content": rezultat})
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
print(r.content[0].text)Da, mai avem bicicleta de oraș: 4 bucăți în stoc.
Indiciu
Conținutul mesajului user devine o listă: [{"type": "tool_result", "tool_use_id": bloc.id, "content": rezultat}].
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
TOOLS = [{
"name": "verifica_stoc",
"description": "Întoarce câte bucăți sunt în stoc dintr-un produs.",
"input_schema": {"type": "object", "properties": {"produs": {"type": "string"}}, "required": ["produs"]},
}]
STOC = {"bicicleta de oras": 4}
def verifica_stoc(produs):
return f"{STOC.get(produs, 0)} bucăți în stoc"
mesaje = [{"role": "user", "content": "Mai aveți bicicleta de oras?"}]
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
bloc = next(b for b in r.content if b.type == "tool_use")
rezultat = verifica_stoc(**bloc.input)
mesaje.append({"role": "assistant", "content": r.content})
mesaje.append({"role": "user", "content": [
{"type": "tool_result", "tool_use_id": bloc.id, "content": rezultat},
]})
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
print(r.content[0].text)De ce merge
Când modelul cere un tool, API-ul așteaptă ca mesajul următor să conțină rezultatul acelei cereri, identificat prin tool_use_id. Un text simplu nu spune la ce cerere răspunde, deci API-ul refuză conversația. Cu blocul tool_result, modelul primește stocul, îl leagă de apelul lui și formulează răspunsul final pentru client.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - messages.1.content.0: unexpected `tool_use_id` found in `tool_result` blocks: toolu_01A09q90qw90lq917835lq9. Each `tool_result` block must have a corresponding `tool_use` block in the previous message.
Cum o eviți pe viitor
- Scrie bucla de tool use o singură dată și refolosește-o: adaugi
r.contentca mesajassistant, apoi toatetool_result-urile într-un singur mesajuser. - Construiește rezultatele parcurgând toate blocurile
tool_use, nu doar primul. - Când tool-ul eșuează, trimite tot un
tool_result, cu"is_error": Trueși mesajul erorii.
Întrebări frecvente
Pot pune text lângă tool_result în același mesaj?
Da, după blocurile tool_result poți adăuga un bloc text, dar rezultatele trebuie să fie primele în mesaj.
Ce trimit dacă tool-ul a dat eroare?
Tot un tool_result cu același tool_use_id, cu "is_error": True și un text care explică problema. Modelul poate atunci să reformuleze sau să-i spună utilizatorului ce s-a întâmplat.
Erori înrudite
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. openai.BadRequestError: Error code: 400 - No tool call found for function call output with call_id call_abc123. Ai trimis la OpenAI un `function_call_output`, dar în `input` nu există apelul de funcție (`function_call`) cu același `call_id`. Înainte să adaugi rezultatele, adaugă în listă item-urile din răspunsul modelului: `intrari += r.output`. 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`. Î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.
