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

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.

Pe scurt

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

Greșit
PYTHON
mesaje.append({"role": "assistant", "content": r.content})
mesaje.append({"role": "user", "content": f"Stoc: {stoc}"})
Corect
PYTHON
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

Greșit
PYTHON
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)}]
Corect
PYTHON
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

Greșit
PYTHON
for b in tool_uri:
    mesaje.append({"role": "user", "content": [{"type": "tool_result", "tool_use_id": b.id, "content": executa(b)}]})
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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}].

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.content ca mesaj assistant, apoi toate tool_result-urile într-un singur mesaj user.
  • 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

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