Salt la conținut

Apelul de instrumente (tool calls)

IntermediarLectură: 2 min

Ca să poată acționa asupra lumii fizice sau digitale, un model de limbaj trebuie să știe ce instrumente are la dispoziție și cum le poate apela. Această capacitate se numește apel de instrumente (tool calling sau function calling) și este pasul de acțiune din procesul harnașamentului.

Când trimite promptul către model, harnașamentul include și lista instrumentelor disponibile, descrise prin scheme JSON. Fiecare instrument are un nume unic, o descriere clară a ce face și o listă strictă de parametri tipizați.

{
"name": "replace_file_content",
"description": "Înlocuiește un bloc continuu de text dintr-un fișier existent cu un conținut nou.",
"parameters": {
"type": "object",
"properties": {
"filePath": { "type": "string", "description": "Calea absolută a fișierului." },
"targetContent": { "type": "string", "description": "Textul exact care trebuie înlocuit." },
"replacementContent": { "type": "string", "description": "Noul conținut." }
},
"required": ["filePath", "targetContent", "replacementContent"]
}
}

Când decide că trebuie să facă ceva, modelul nu mai scrie text obișnuit, ci întoarce un bloc structurat care spune ce instrument a ales și cu ce argumente exacte.

{
"tool_call": {
"name": "replace_file_content",
"arguments": {
"filePath": "/proiect/src/auth.ts",
"targetContent": "const isValid = token.length > 0;",
"replacementContent": "const isValid = Boolean(token && token.length >= 32);"
}
}
}

Modelul nu execută singur acțiunea. Harnașamentul citește blocul, rulează instrumentul și îi trimite modelului rezultatul, care devine observația de la pasul următor.

Mesajele unui apel de instrumentHarnașamentul îi trimite modelului promptul împreună cu schemele JSON ale instrumentelor. Apoi se repetă: modelul întoarce un apel cu numele instrumentului și argumentele, harnașamentul îl validează și rulează instrumentul, instrumentul întoarce un rezultat sau un mesaj de eroare, iar harnașamentul îl pune în context, ca observație nouă pentru model.ModelHarnașamentInstrument (mediu)Se repetăpromptul + schemele JSONapel: nume + argumente (JSON)execuție, după validarerezultat sau mesaj de eroareobservație nouă în context
Modelul doar descrie apelul. Harnașamentul îl validează, rulează instrumentul și pune rezultatul, inclusiv o eventuală eroare, înapoi în context, iar modelul decide pe această bază pasul următor.

Într-un mediu agentic pentru programare, instrumentele de bază se împart în patru categorii mari.

  • Inspecție și explorare: căutarea în cod (grep, ripgrep), listarea directoarelor, citirea fișierelor și a definițiilor de simboluri.
  • Modificare de stare: crearea și rescrierea fișierelor sau editarea atomică prin diferențe de text (diffs).
  • Execuție și validare: rularea comenzilor în terminal, a testelor automate, a linterelor și a compilatoarelor.
  • Interacțiune: cereri de confirmare sau întrebări cu variante de răspuns pentru utilizator (ask_question).

Cel mai mare avantaj al apelului de instrumente într-un harnașament automat este autorepararea (self-healing). Când un programator scrie cod greșit, compilatorul îi arată o eroare, iar programatorul o citește și o repară. Un sistem agentic face la fel.

  1. Agentul modifică o funcție într-un fișier sursă.
  2. Harnașamentul rulează automat verificatorul de tipuri sau testele.
  3. Testul eșuează cu mesajul TypeError: Cannot read property of undefined.
  4. Harnașamentul pune mesajul de eroare și fișierul în cauză direct în contextul agentului.
  5. Agentul înțelege eroarea, găsește linia cu problema, face o nouă modificare și rulează din nou testul.

Pentru că poate reacționa la erori reale, modelul nu mai trebuie să nimerească totul din prima încercare.