Fogalomtár › Agentek

eszközdefiníció

angolul: tool definition / tool schema

Az eszközdefiníció rövid, gép által is olvasható leírás arról, mire való egy eszköz, mikor érdemes használni, és milyen adatokat kell megadni hozzá.

Érthetően

Egy nyelvi modell önmagában csak szöveget állít elő, a külvilágban semmit nem tud elvégezni. Ahhoz, hogy naptárba írjon, keressen a weben vagy lekérdezzen egy adatbázist, eszközöket kap. Az eszközdefiníció az a „használati útmutató”, amelyből az agent megtudja, hogy az adott eszköz létezik, mire jó, és hogyan kell meghívni.

Olyan ez, mint egy hivatali űrlap a fejlécével együtt. A fejléc megmondja, milyen ügyben kell kitölteni, a rovatok pedig azt, milyen adatot kérnek: név, dátum, összeg, és melyik kötelező. Az agent ezt az űrlapot tölti ki, a tényleges ügyintézést pedig egy másik program végzi el.

A definíció jellemzően három részből áll: az eszköz neve, egy hétköznapi nyelven írt leírás, és a bemeneti adatok pontos szerkezete, vagyis a séma. A leírásból dönti el az agent, hogy mikor nyúljon az eszközhöz. A sémából tudja, milyen mezőket kell kitöltenie, a körülötte futó program pedig ugyanezzel ellenőrizheti, hogy a kitöltés formailag rendben van-e.

Abban más, mint egy szokásos programozói dokumentáció, hogy itt az olvasó maga a modell. Ha a leírás homályos, az agent rossz eszközt választ vagy rosszul tölti ki a mezőket, még akkor is, ha maga az eszköz hibátlan.

Hogyan működik

1. A fejlesztő minden eszközhöz megírja a definíciót: nevet ad neki, leírja, mire való, és felsorolja a paramétereket típussal együtt (például „város: szöveg, kötelező”).
2. A rendszer ezeket a definíciókat a kérdéseddel együtt, minden körben átadja a modellnek, így az agent látja, milyen eszközök közül választhat. Ha nagyon sok az eszköz, előfordul, hogy a rendszer csak az éppen szükségesek leírását tölti be.
3. Amikor az agent úgy ítéli meg, hogy egy eszközre szükség van, nem szabad szöveggel válaszol, hanem a séma szerint kitöltött, strukturált kérést állít elő: melyik eszközt hívja, és milyen értékekkel.
4. A körülötte futó program ellenőrzi, hogy a kérés megfelel-e a sémának, lefuttatja az eszközt, majd az eredményt visszaadja a modellnek.
5. Az agent az eredmény alapján folytatja: válaszol neked, vagy újabb eszközt hív, amíg a feladat el nem készül.

Példa a mindennapokból

Kit érint

Gyakori félreértés

Korlátok és kockázatok

• A séma csak a formát ellenőrzi: egy szabályosan kitöltött kérés is tartalmazhat rossz adatot, például téves dátumot vagy más ügyfél azonosítóját.
• Minden definíció helyet foglal a modell munkamemóriájában, ezért túl sok vagy túl hosszú eszközleírás lassítja, drágítja és bizonytalanabbá teszi az agent munkáját.
• Ismeretlen forrásból származó eszköz leírásába rejtett utasítást is lehet csempészni, amely az agentet nem kívánt lépésekre veszi rá, ezért csak megbízható eszközt érdemes bekötni.
• A definíció nem korlátozza a jogosultságokat: hogy az eszköz ténylegesen mit törölhet vagy küldhet el, azt a mögötte futó rendszerben kell beállítani.

Hasonló, de nem ugyanaz

• eszközhívás – Az eszközdefiníció az üres űrlap, az eszközhívás pedig az a pillanat, amikor az agent kitöltve beadja.
• API – Az API a programok közötti tényleges csatlakozási pont, az eszközdefiníció pedig ennek a modell számára érthető, leegyszerűsített leírása.
• rendszerprompt – A rendszerprompt az agent általános viselkedését és szerepét szabja meg, az eszközdefiníció egy-egy konkrét eszköz használatát írja le.

Kapcsolódó fogalmak

Röviden a története

A mai forma 2023-ban terjedt el, amikor az OpenAI bevezette a függvényhívást, amelyben a fejlesztők JSON-sémával írhatták le a modell számára elérhető függvényeket. Az Anthropic 2024 novemberében közzétett Model Context Protocolja egységes, szolgáltatók között hordozható formát adott az eszközök leírásának. A protokoll 2025 végén a Linux Foundation keretében működő Agentic AI Foundation gondozásába került, így már nem egyetlen cég szabványa.

Hol tart most

2026 végén gyakorlatilag minden nagy modellszolgáltató és agentkeretrendszer névből, leírásból és JSON-sémából álló eszközdefiníciókkal dolgozik. A figyelem a jó leírások megírására, a sok eszköz hatékony kezelésére és a megbízhatatlan eszközök kiszűrésére irányul.

Állapot: 2026. november

Más nevei

eszközdefiníció · eszközleírás · eszközséma · tool definition · tool schema · function definition · function schema · tool specification

Források

• Model Context Protocol – hivatalos dokumentáció
• JSON Schema – hivatalos oldal
• Wikipedia: Model Context Protocol

A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.