Salt la conținutul principal
Română— Alege o limbă
Meniu

Introducere în apelarea de funcții

Lecția 1 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. De ce apelarea de funcții schimbă totul
  2. Arhitectura LLM + Instrumente
  3. Care modele Mistral suportă apelarea de funcții?
  4. Cazuri de utilizare tipice
  5. Ce veți învăța în acest curs
  6. Puncte cheie

Actualizare 2 noiembrie 2026 — Modele. Mistral Large 3 (mistral-large-2512) și Mistral Medium 3.5 au fost depreciate la 31 octombrie 2026 și vor fi retrase la 30 aprilie 2027. Succesorul lor desemnat, Mistral Large 4 (mistral-large-4), se află în previzualizare publică din 6 octombrie. Exemplele din acest curs utilizează aliasul mistral-large-latest, care indică în prezent către Mistral Large 3 conform specificației oficiale (verificat la 3 noiembrie 2026). În mod similar, mistral-medium-latest indică către Mistral Medium 3.5. Aceste aliasuri vor rămâne valabile până la 30 aprilie 2027. Pentru noile proiecte, testați mistral-large-4, succesorul lor desemnat.

De ce apelarea de funcții schimbă totul

Modelele lingvistice de mari dimensiuni, precum cele de la Mistral AI, excelează în înțelegerea și generarea de text. În lumea reală, acest lucru este rareori suficient. Răspunsul la întrebarea „Unde este comanda mea?“ necesită interogarea unei baze de date. Confirmarea unei plăți implică verificarea sau chiar declanșarea unei tranzacții. Programarea unei întâlniri necesită citirea unui calendar. Apelarea de funcții este mecanismul care permite unui LLM să treacă granița dintre text și acțiune.

Procesul implică trei pași. Modelul decide că trebuie să apeleze o funcție externă, generează argumentele necesare în format JSON și apoi lasă codul dumneavoastră să execute funcția și să returneze rezultatul. În niciun moment modelul nu accesează direct sistemele dumneavoastră: dumneavoastră păstrați controlul total.

Arhitectura LLM + Instrumente

Totul se bazează pe o separare strictă a responsabilităților. Merită să enunțăm acest lucru cu precizie, deoarece restul cursului se construiește pe această fundație. Modelul înțelege cererea utilizatorului, selectează funcția potrivită și redactează argumentele. Codul dumneavoastră, și doar codul dumneavoastră, execută efectiv acea funcție, accesează datele și returnează rezultatul. Modelul preia apoi din nou controlul pentru a transforma acel rezultat brut într-un răspuns natural.

Avantajul este semnificativ: modelul nu are niciodată acces direct la sistemele dumneavoastră și nu poate executa cod arbitrar. Acesta exprimă simplu o intenție — „Aș dori să apelez această funcție cu acești parametri“ — iar aplicația dumneavoastră decide ce să facă cu ea. O cerere de ștergere a unui cont poate fi astfel refuzată, înregistrată în jurnal sau supusă unei confirmări înainte ca orice execuție să aibă loc.

# Vizualizare simplificată a fluxului
user = "Care este starea comenzii #4521?"

# 1. Modelul analizează și decide
# → "Trebuie să apelez get_order_status cu order_id=4521"

# 2. Codul dumneavoastră execută
result = get_order_status(order_id=4521)
# → {"status": "shipped", "tracking": "FR123456789"}

# 3. Modelul formulează răspunsul
# → "Comanda dumneavoastră #4521 a fost expediată. Iată numărul de urmărire: FR123456789."

Observați calea datelor în acest exemplu: numărul de urmărire FR123456789 nu există nicăieri în cunoștințele modelului. Acesta provine din sistemul dumneavoastră, trece prin mesajul de rezultat și ajunge într-o propoziție pe care utilizatorul o poate citi. Exact acest lucru face posibilă apelarea de funcții.

Care modele Mistral suportă apelarea de funcții?

Toate modelele principale Mistral suportă această funcționalitate. Printre modelele de uz general, aveți Mistral Large 3, Medium 3.5, Small 4 și Ministral 3 în cele trei dimensiuni ale sale (14B, 8B, 3B). În categoria specializată, Devstral 2.0, Devstral Small 2 și Codestral expun, de asemenea, această capacitate. Magistral Medium și Small o ofereau, de asemenea, dar această familie este acum depreciată: capacitățile de raționament sunt acum integrate în Mistral Small 4 și Medium 3.5.

Alegerea dumneavoastră depinde de cazul de utilizare. Pentru apeluri de funcții complexe cu mulți parametri și compromisuri subtile între multiple instrumente, Mistral Large 3 rămâne cel mai fiabil. Pentru cazuri de producție simple, cu throughput ridicat — un asistent care interoghează două sau trei funcții bine definite de mii de ori pe zi — Mistral Small 4 oferă un raport cost-performanță excelent.

Cazuri de utilizare tipice

Aplicațiile sunt mai diverse decât par la prima vedere. Un asistent conversațional conectat la o bază de date CRM, ERP sau de tichete răspunde la întrebări de consultare: modelul citește, dar nu modifică nimic. Automatizarea merge mai departe prin declanșarea fluxurilor de lucru — trimiterea unui e-mail, crearea unei sarcini, actualizarea unui statut — și, prin urmare, implică o responsabilitate mult mai mare din partea codului. În căutarea augmentată (RAG), apelarea de funcții mută decizia: în loc să interogați sistematic o bază de date vectoriale, lăsați modelul să decidă când și cum să o facă, evitând injectarea unui context inutil.

Două cazuri de utilizare mai ambițioase completează imaginea. Agenții autonomi înlănțuie multiple apeluri de funcții pentru a îndeplini o sarcină complexă, fiecare rezultat ghidând următorul apel. În final, interfețele naturale permit unui utilizator să piloteze o întreagă aplicație prin conversație, fără a fi nevoie să învețe vreodată unde se află un buton specific.

Ce veți învăța în acest curs

Cursul constă în paisprezece lecții și urmează o progresie deliberat liniară. Veți începe cu conceptele fundamentale: procesul în cinci pași și schemele JSON care descriu funcțiile dumneavoastră. Veți trece apoi la implementarea în Python — scrierea, apelarea, executarea și înlănțuirea funcțiilor cu SDK-ul Mistral. Al treilea bloc acoperă funcționalitățile avansate: apeluri paralele, opțiuni tool_choice, gestionarea erorilor și securitatea. Cursul se încheie cu cazuri de utilizare din lumea reală — un tracker de plăți, un CRM automatizat — și cele mai bune practici pentru producție.

La finalul acestui curs, veți fi capabil să proiectați, să implementați și să implementați în producție un sistem robust de apelare de funcții cu API-ul Mistral.

Puncte cheie

  • Apelarea de funcții permite modelului să solicite executarea unei funcții fără a o executa el însuși
  • Arhitectura se bazează pe o separare strictă: modelul generează argumentele, codul dumneavoastră execută
  • Toate modelele principale Mistral suportă această funcționalitate
  • Apelarea de funcții este blocul de construcție pentru agenții AI și automatizarea conversațională