Agentul care folosește unelte MCP
MCP îi pune agentului la dispoziție capabilități cu contracte explicite.
Ce vei învăța
- Explici: modelul propune, unealta execută
- Aplici ideea într-un exemplu: Agentul care folosește unelte MCP
- Recunoști limitele și verifici rezultatul exercițiului
MCP îi pune agentului la dispoziție capabilități cu contracte explicite. Selectează numai uneltele necesare sarcinii.
Pașii se referă la funcționalități identificate în codul aplicației. Validarea pe o instanță live nu a fost efectuată pentru acest material; verifică documentația și opțiunile din versiunea ta.
Cum funcționează, pas cu pas
Modelul propune, unealta execută
Tool calling produce o cerere de apel cu nume și argumente. Aplicația validează schema, drepturile și limitele înainte să execute. Rezultatul se întoarce în context pentru pasul următor. De exemplu, get_product_stock primește un SKU și returnează o cantitate; descrierea sa trebuie să precizeze că nu rezervă produse. Distinge rezultat gol, eroare de validare, lipsă de acces și timeout. JSON valid nu dovedește că argumentele sunt corecte sau că operația este autorizată. Pentru efecte externe verifică și riscul de repetare.
Host, client și server
MCP este un protocol de conectare între aplicații AI și capabilități externe. Host-ul găzduiește experiența, clientul gestionează legătura, iar serverul expune tools, resources sau prompts în funcție de suport. Tools execută operații; resources oferă conținut adresabil; prompts oferă șabloane. Nu orice server le implementează pe toate. Transportul mută mesajele, autentificarea identifică apelantul, iar autorizarea decide ce poate accesa. Revizia protocolului și extensiile suportate trebuie verificate la ambele capete. Compatibilitatea nu se deduce doar din eticheta „MCP”.
Accesul se verifică înainte de folosire
Permisiunile trebuie aplicate în server și în stratul de date. Nu lăsa modelul să decidă dacă un utilizator poate vedea un document. Filtrează sursele înainte să intre în context, nu după generarea răspunsului. Folosește chei cu acces minim, nu le pune în prompturi, capturi sau cod din browser și rotește-le dacă sunt expuse. O listă de domenii permise pentru widget nu înlocuiește autentificarea API. Autentificarea arată cine ești; autorizarea arată ce operații și date poți folosi. Testează și accesul refuzat.
Harta vizuală
Urmărește săgețile continue pentru fluxul principal. Săgețile albastre punctate furnizează date sau context; cele roz punctate arată feedback sau rezultate care revin. Culorile și formele disting modelele, stocările, deciziile și rezultatele. Pe ecrane mici, derulează orizontal pentru a urmări întreaga diagramă.
Un exemplu complet
Conectezi serverul demonstrativ, descoperi tools și selectezi get_product_stock pentru agent. SKU-ul absent produce clarificare, nu căutarea arbitrară a tuturor comenzilor.
Încearcă tu
- Activează o unealtă read-only și testează SKU valid, lipsă și acces refuzat.
- Notează intrarea, sursa și rezultatul așteptat înainte să rulezi experimentul. Folosește doar datele fictive din exemplu.
- Urmărește etapele din diagramă. La fiecare pas scrie ce informație primește și ce produce; nu confunda rezultatul intermediar cu rezultatul final.
- Repetă cazul după eliminarea unei informații necesare sau după o intrare ambiguă. Verifică dacă sistemul cere clarificare, se oprește sau inventează.
- Compară cu soluția comentată. Păstrează configurația, data, rezultatul și o explicație pentru orice diferență. Schimbă un singur lucru și retestează.
Soluție comentată
Apelul citește stocul SKU-ului permis și tratează lipsa accesului drept eroare, nu stoc zero. Pentru a considera exercițiul reușit, poți arăta legătura dintre intrare, etapele parcurse și rezultat. Dacă lipsesc date, un răspuns prudent este mai util decât o completare inventată. Nu compara doar stilul: verifică și condițiile, sursele și operațiile efectuate.
Când merită și ce poate merge prost
Descrierea tool-ului nu este un control de securitate. Alege această abordare când îmbunătățește o nevoie măsurată. Păstrează o variantă simplă ca referință și compară rezultatele pe aceleași intrări. Un singur exemplu reușit nu stabilește fiabilitatea în toate situațiile.
Verifică ce ai înțeles
Cine execută apelul propus de model?
Aplicația sau serviciul gazdă, după validare. Modelul nu primește automat acces nelimitat.
Un server cu tools oferă automat resources și prompts?
Nu. Capabilitățile sunt opționale și trebuie descoperite și verificate.
Ce rezultat trebuie să obții în acest exercițiu?
Apelul citește stocul SKU-ului permis și tratează lipsa accesului drept eroare, nu stoc zero.
Cuvinte de ținut minte
- Tool calling: Cerere structurată de folosire a unei capabilități externe.
- MCP server: Serviciu care expune capabilități prin Model Context Protocol.
- Autorizare / Authorization: Verificarea dreptului la o operație sau resursă.
Surse și următorul pas
Pentru pregătire: A03 — Agentul cu acces la cunoștințe