KeyError: 'cauta_comanda'
Modelul a cerut un tool după numele din definiția lui (block.name), iar dicționarul tău de funcții nu are cheia aceea, de obicei din cauza unui nume scris diferit. Folosește aceleași nume în tools și în dispecer și tratează numele necunoscute cu un tool_result cu is_error: True.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o aplicație cu tool use, codul tău primește de la model un bloc tool_use cu name și input, apoi caută funcția potrivită, de obicei într-un dicționar: FUNCTII[b.name](**b.input). Dacă numele cerut nu e cheie în dicționar, Python ridică KeyError cu numele între ghilimele.
Modelul folosește exact numele din lista tools trimisă în cerere. Deci problema e aproape mereu în codul tău: ai redenumit funcția sau tool-ul doar într-un loc, ai o greșeală de literă ori ai oferit modelului un tool pe care dispecerul nu îl cunoaște.
Compară numele din mesaj cu cheile dicționarului și cu câmpul name din definițiile tool-urilor.
De ce apare: cauzele frecvente
1Nume diferit în definiție și în dispecer
TOOLS = [{"name": "cauta_comanda", ...}]
FUNCTII = {"cauta_status": cauta_status}
rez = FUNCTII[b.name](**b.input)TOOLS = [{"name": "cauta_comanda", ...}]
FUNCTII = {"cauta_comanda": cauta_comanda}
rez = FUNCTII[b.name](**b.input)Cheia din dicționar trebuie să fie identică cu name din definiția tool-ului.
2Tool oferit modelului, dar neimplementat
TOOLS = [TOOL_CAUTA, TOOL_ANULEAZA]
FUNCTII = {"cauta_comanda": cauta_comanda}TOOLS = [TOOL_CAUTA]
FUNCTII = {"cauta_comanda": cauta_comanda}Oferă modelului doar tool-urile pe care le poți executa.
3Niciun plan pentru un nume necunoscut
rez = FUNCTII[b.name](**b.input)functie = FUNCTII.get(b.name)
if functie is None:
rezultate.append({"type": "tool_result", "tool_use_id": b.id,
"content": "Tool necunoscut: " + b.name, "is_error": True})Cu is_error: True, modelul află că tool-ul nu există și poate răspunde altfel, iar programul nu se oprește.
Repară eroarea, direct în pagină
Asistentul unui magazin oferă modelului tool-ul cauta_comanda, dar dispecerul FUNCTII îl are sub alt nume, iar programul cade cu KeyError: 'cauta_comanda'. Repară cheia din dispecer și, pentru orice nume necunoscut, trimite un tool_result cu is_error: True. Programul afișează răspunsul final.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
COMENZI = {1042: "în livrare, ajunge mâine"}
def cauta_comanda(id):
return COMENZI.get(id, "nu există")
TOOLS = [{
"name": "cauta_comanda",
"description": "Caută statusul unei comenzi după numărul ei.",
"input_schema": {"type": "object", "properties": {"id": {"type": "integer"}}, "required": ["id"]},
}]
FUNCTII = {"cauta_status": cauta_comanda}
mesaje = [{"role": "user", "content": "Unde e comanda 1042?"}]
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
while r.stop_reason == "tool_use":
mesaje.append({"role": "assistant", "content": r.content})
rezultate = []
for b in r.content:
if b.type == "tool_use":
rez = FUNCTII[b.name](**b.input)
rezultate.append({"type": "tool_result", "tool_use_id": b.id, "content": str(rez)})
mesaje.append({"role": "user", "content": rezultate})
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
print(r.content[0].text)Comanda 1042 este în livrare, ajunge mâine.
Indiciu
Cheia din FUNCTII trebuie să fie exact cauta_comanda; pentru nume necunoscute folosește FUNCTII.get(b.name).
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
COMENZI = {1042: "în livrare, ajunge mâine"}
def cauta_comanda(id):
return COMENZI.get(id, "nu există")
TOOLS = [{
"name": "cauta_comanda",
"description": "Caută statusul unei comenzi după numărul ei.",
"input_schema": {"type": "object", "properties": {"id": {"type": "integer"}}, "required": ["id"]},
}]
FUNCTII = {"cauta_comanda": cauta_comanda}
mesaje = [{"role": "user", "content": "Unde e comanda 1042?"}]
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
while r.stop_reason == "tool_use":
mesaje.append({"role": "assistant", "content": r.content})
rezultate = []
for b in r.content:
if b.type == "tool_use":
functie = FUNCTII.get(b.name)
if functie is None:
rezultate.append({"type": "tool_result", "tool_use_id": b.id,
"content": "Tool necunoscut: " + b.name, "is_error": True})
continue
rez = functie(**b.input)
rezultate.append({"type": "tool_result", "tool_use_id": b.id, "content": str(rez)})
mesaje.append({"role": "user", "content": rezultate})
r = client.messages.create(model=MODEL, max_tokens=300, tools=TOOLS, messages=mesaje)
print(r.content[0].text)De ce merge
Modelul cere tool-ul după name din TOOLS, deci dispecerul trebuie să aibă exact acea cheie. După reparație, FUNCTII.get(b.name) găsește funcția, iar rezultatul ajunge înapoi la model într-un tool_result. Ramura cu is_error: True acoperă un nume necunoscut fără să oprească programul: modelul primește eroarea și poate răspunde clientului.
Alte forme ale mesajului
KeyError: 'calculeaza_tva'KeyError: 'get_weather'
Cum o eviți pe viitor
- Construiește dispecerul din aceeași sursă ca definițiile, de exemplu
FUNCTII = {t["name"]: f for t, f in PERECHI}. - La orice tool necunoscut, trimite înapoi un
tool_resultcuis_error: True, nu lăsa programul să cadă. - Scrie un test simplu care verifică că fiecare tool din
TOOLSare o funcție în dispecer.
Întrebări frecvente
Poate modelul să inventeze un tool care nu există?
Rar, pentru că alege din lista trimisă în cerere. Dar un nume necunoscut poate apărea când tool-urile se schimbă între cereri sau când istoricul vine dintr-o sesiune veche, deci tratează cazul oricum.
De ce nu folosesc if/elif pe numele tool-ului?
Merge pentru două-trei tool-uri. Un dicționar de funcții rămâne curat și când ai zece, iar FUNCTII.get(nume) tratează simplu cazul necunoscut.
Erori înrudite
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. 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. TypeError: verifica_stoc() argument after ** must be a mapping, not str La OpenAI, argumentele unui function call vin ca text JSON (apel.arguments este un str), iar ** cere un dicționar. Parsează-le întâi: functie(**json.loads(apel.arguments)). La Claude, bloc.input e deja dicționar. Î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.
