A leírás maga a felület
Egy hagyományos API-nál a dokumentáció embernek szól, és ha rossz, a fejlesztő rákérdez. Az MCP-nél a leírás a modellnek szól, és a modell nem kérdez rá. Csendben rosszul dönt.
Ezért az eszközleírás nem melléktermék, hanem maga a felület. Ugyanannyi figyelmet érdemel, mint a működés.
Gyenge leírás
- Ügyfélkeresés
- Lekérdezi az adatokat
- Paraméter: query
- Nincs megírva, mikor ne használd
Jó leírás
- Ügyfél keresése név vagy adószám alapján
- Legfeljebb tíz találatot ad vissza relevancia szerint
- Paraméter: keresőkifejezés, legalább három karakter
- Ne használd, ha már ismered az ügyfél azonosítóját
Mit tartalmazzon egy jó leírás
Mit csinál, egy mondatban. Cselekvő igével, konkrétan.
Mikor használja a modell. Ez a legfontosabb sor, és ez hiányzik a leggyakrabban.
Mikor ne használja. Ha van közeli testvéreszköz, itt kell elhatárolni tőle, különben a modell felváltva fogja őket választani.
Mit ad vissza. Formátum és nagyságrend, hogy a modell tudja, mire számítson.
Mi történik hiba esetén. Hogy legyen terve a folytatásra, ne álljon meg.
Ha két eszköz leírása alapján te magad sem tudnád eldönteni, melyiket kellene használni egy adott helyzetben, akkor a modell sem fogja tudni. Ilyenkor vagy élesítsd a határt köztük, vagy vond össze őket eggyé.
A paraméterek
Minden paraméternek legyen beszédes neve és típusa, és ahol értelmes, ott kötött értékkészlete. Egy szabad szöveges státusz mező helyett sorold fel a lehetséges értékeket, mert akkor a modell nem talál ki újat.
A kötelező paramétereket tartsd minimálison. Minden kötelező mező egy újabb esély a hibára, és a modellnek ki kell találnia valamit, ha nem tudja. Az alapértelmezés jobb, mint a kényszer.
Ha egy paraméter veszélyes, például egy törlés hatókörét szabja meg, akkor legyen szűk és kifejezett. A csendes alapértelmezés itt a legrosszabb választás.
Workshop
AI Transformation Day
Egésznapos, vezetőknek szóló program. Feltérképezzük, hol tart a szervezet, mi az első reális lépés, és milyen belső feltételek szükségesek a sikerhez. A nap végén konkrét, prioritizált cselekvési lista.
Érdekel a program →