Modul 4 · 20 min

Tools & Function Calling

Cum „acționează” un model în lume: file system, web, API-uri.

Vei învăța

Înțelegi ce e un tool și de ce contează
Recunoști pattern-ul „loop tool-call → rezultat → continuă”
Auzi prima dată de MCP și știi la ce e bun

Un model fără tools e un creier într-un borcan: gândește, dar nu poate face nimic. Tools-urile sunt mâinile lui — funcții pe care le poate apela ca să citească fișiere, să caute pe web, să trimită emailuri, să interogheze baze de date.

Cum funcționează concret

Tu (sau platforma) descrii modelului ce tools sunt disponibile, ce input acceptă fiecare și ce output întoarce. Modelul, când are nevoie, „cere” să apelezi un tool. Platforma execută, întoarce rezultatul. Modelul continuă cu rezultatul în context.

   USER:  „Câți useri activi am avut săptămâna trecută?"
     │
     ▼
   MODEL: „Am nevoie de tool. Apelează query_db cu ..."
     │
     ▼
   PLATFORMĂ: execută query_db → întoarce { count: 1247 }
     │
     ▼
   MODEL: „Am avut 1247 useri activi săptămâna trecută."
     │
     ▼
   USER: vede răspunsul

Modelul nu execută tool-ul direct. Cere platformei să-l execute, apoi continuă cu rezultatul.

Exemple de tools tipice

read_file / write_file — citește sau scrie un fișier local.
web_search — caută pe Google/Bing și întoarce rezultate.
run_code — execută un snippet Python/JS și întoarce output-ul.
send_slack — trimite un mesaj într-un canal.
query_jira — caută tickete după filtre.

Definiția unui tool — schema

Fiecare tool e descris cu o schemă: nume, descriere, parametri (cu tipuri). Modelul folosește descrierea ca să decidă DACĂ și CÂND să apeleze tool-ul.

{
  "name": "query_jira",
  "description": "Caută tickete în Jira după filtre. Folosește când userul cere status, listă tickete, sau detalii despre cineva.",
  "input_schema": {
    "type": "object",
    "properties": {
      "project": { "type": "string", "description": "Cheia proiectului, ex. PROJ" },
      "status":  { "type": "string", "enum": ["open", "in_progress", "done"] },
      "assignee": { "type": "string", "description": "Email-ul asignatului" }
    },
    "required": ["project"]
  }
}

MCP — un standard pentru tools

MCP (Model Context Protocol) e un standard introdus de Anthropic prin care orice tool își descrie singur capabilitățile, iar orice agent AI le poate folosi fără cod custom. Practic: instalezi un „MCP server” pentru Slack, Google Drive, Linear etc., și agentul tău AI învață automat cum să le folosească.

Mini-check

Modelul tău AI primește întrebarea „care e prețul ETH acum?”. El nu are acces la web în mod implicit. Ce-i lipsește?

Selectează un răspuns.