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

KeyError: 'cauta_comanda'

Pe scurt

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

Greșit
PYTHON
TOOLS = [{"name": "cauta_comanda", ...}]
FUNCTII = {"cauta_status": cauta_status}
rez = FUNCTII[b.name](**b.input)
Corect
PYTHON
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

Greșit
PYTHON
TOOLS = [TOOL_CAUTA, TOOL_ANULEAZA]
FUNCTII = {"cauta_comanda": cauta_comanda}
Corect
PYTHON
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

Greșit
PYTHON
rez = FUNCTII[b.name](**b.input)
Corect
PYTHON
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ă tu

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.

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

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_result cu is_error: True, nu lăsa programul să cadă.
  • Scrie un test simplu care verifică că fiecare tool din TOOLS are 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

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