Google AI Studio pa kod: nga prompt-i te prototipi i kontrollueshëm

Për të përdorur Google AI Studio, hap një bisedë në Playground, shkruaj detyrën për Gemini dhe shtyp Run. Më pas rregullo System instructions dhe parametrat te Run settings; për rezultat me fusha të përcaktuara përdor Structured output, ndërsa për fakte të jashtme aktivizo grounding. Udhëzuesi i Google AI Studio përshkruan këto kontrolle dhe butonin Get code, me të cilin prompt-i i provuar kalohet te kodi për Gemini API.

Shembulli i kushtëzuar në vijim është një mjet që përmbledh njoftime aktivitetesh në shqip. Do të përdorim një njoftim të sajuar për një punëtori në bibliotekë, nga kërkesa fillestare deri te fushat JSON dhe kodi. Teksti i provës nuk ka emra pjesëmarrësish, adresa emaili apo të dhëna të tjera personale.

Nis me detyrën dhe udhëzimin e sistemit

Në Playground hap një bisedë të re. Në fushën e mesazhit shkruaj: «Përmblidh në shqip këtë njoftim: Biblioteka e qytetit organizon të martën, në orën 17:00, një punëtori falas për shkrim krijues». Shtyp Run. Përgjigjja e parë të jep një pikë krahasimi për ndryshimet që do të bësh më pas; kontrollo nëse ajo ruan aktivitetin, vendin, ditën dhe orën e dhënë.

Te Run settings vendos në System instructions: «Je asistent që përmbledh njoftime publike aktivitetesh në shqip. Shkruaj qartë, ruaj vetëm faktet e tekstit hyrës dhe mos shpik adresë, datë kalendarike apo kushte regjistrimi». Ekzekuto sërish të njëjtin njoftim. Ky udhëzim përcakton sjelljen që kërkon për çdo njoftim, ndërsa mesazhi në bisedë përmban rastin që po përpunohet.

Vëre nëse përgjigjja e ruan «të martën» si ditë të javës. Nga ai formulim nuk mund të nxirret një datë kalendarike, as vendndodhja e saktë e bibliotekës. Nëse modeli shton njërën prej tyre, bëje ndalimin më të qartë në udhëzimin e sistemit dhe provo të njëjtën hyrje përsëri. Kështu ndryshon një kontroll në një kohë dhe sheh çfarë ndikimi ka.

Shto një shembull; përdor temperaturën për larmi

Udhëzimi i sistemit cakton rregullin, por një çift hyrje–dalje i tregon modelit edhe formën e dëshiruar. Shto në kërkesë një njoftim tjetër të sajuar dhe përmbledhjen përkatëse, pastaj vendos njoftimin e bibliotekës si hyrjen e re. Për shembull: «Hyrje: Qendra kulturore mban një lexim publik të premten në orën 18:00. Dalje: Lexim publik në qendrën kulturore, të premten në orën 18:00». Ky është një shembull orientues, jo një aktivitet real.

Laboratori Google Skills përdor një shembull të tillë me një hyrje dhe një dalje, si edhe kontrollin Temperature: temperatura më e ulët e bën përgjigjen më të parashikueshme, ndërsa më e larta lejon më shumë larmi. Për përmbledhjen e bibliotekës, mbaj të pandryshuar modelin dhe kërkesën, provo temperaturë të ulët dhe pastaj rrite. Krahaso formulimet, por kontrollo veçmas nëse faktet e njoftimit kanë mbetur të sakta.

Temperatura nuk është komandë për ta kthyer përgjigjen në të dhëna me fusha fikse. Edhe kur formulimi bëhet më i qëndrueshëm, një program mund ta ketë të vështirë të ndajë titullin nga ora brenda një paragrafi të lirë. Për atë përdorim duhet të përcaktosh formatin e daljes.

Ktheje përmbledhjen në JSON të strukturuar

Te Tools aktivizo Structured output dhe kërko një objekt JSON me fushat «titulli», «vendi», «dita», «ora» dhe «pershkrimi». Për njoftimin e sajuar, dalja e synuar mund të jetë: {"titulli":"Punëtori për shkrim krijues","vendi":"Biblioteka e qytetit","dita":"e martë","ora":"17:00","pershkrimi":"Punëtori falas për shkrim krijues"}. Këto vlera vijnë vetëm nga hyrja e shembullit; ato nuk përshkruajnë një aktivitet të konfirmuar.

Këtu ndryshon kërkesa ndaj rezultatit. Shembulli hyrje–dalje i sugjeron modelit një mënyrë përgjigjeje, kurse Structured output shërben për të kërkuar format të strukturuar që mund të lexohet nga një aplikacion. Megjithatë, një objekt JSON i formuar siç duhet mund të përmbajë ende një vlerë të pasaktë. Krahaso secilën fushë me njoftimin hyrës, sidomos nëse modeli e ka kthyer «e martë» në një datë të caktuar ose ka shtuar një adresë.

Vendos edhe çfarë duhet të ndodhë kur njoftimi nuk jep një fushë. Për një hyrje pa orar, kërko që fusha «ora» të mbetet bosh sipas rregullit që zgjedh për aplikacionin, në vend që modeli ta hamendësojë. Kjo e bën daljen më të përdorshme për kodin që do ta marrë, sepse mungesa e informacionit dallohet nga një orar i dhënë.

Aktivizo grounding vetëm për pyetje që kërkojnë burime

Teksti i sajuar i bibliotekës mjafton për detyrën e përmbledhjes: faktet që duhen nxjerrë janë brenda tij. Nëse pyetja bëhet «Cili është orari aktual i bibliotekës?» ose «A ka ajo një aktivitet të ri?», modeli ka nevojë për informacion të jashtëm. Për atë provë, aktivizo Grounding with Google Search dhe kontrollo burimet e shfaqura përpara se ta trajtosh një orar apo njoftim si fakt.

Grounding ndryshon nga Structured output: i pari sjell informacion nga kërkimi, i dyti përcakton formën e përgjigjes. Në ushtrimin e Google Skills, këto veçori provohen veçmas, duke çaktivizuar njërën para aktivizimit të tjetrës. Ndiq të njëjtën rrjedhë për shembullin e bibliotekës: përmbajtjen e njoftimit ktheje në JSON në një provë, ndërsa pyetjen për informacion aktual bëje në një provë tjetër me grounding. Kështu është e qartë çfarë i dhe vetë modelit dhe çfarë erdhi nga kërkimi.

Merr kodin dhe mbro çelësin API

Kur udhëzimi, shembulli dhe formati i daljes përputhen me detyrën, zgjidh Get code dhe gjuhën e programimit. Kodi është pikënisja për ta përdorur prompt-in përmes Gemini API. Në prototip ruaj të njëjtin udhëzim sistemi, të njëjtën hyrje prove dhe rregullat e formatit; përndryshe, një përgjigje e ndryshme mund të vijë nga ndryshimi i kërkesës, jo nga kalimi në kod.

Thirrja e Gemini API kërkon autentikim. Udhëzimet e Google për çelësat API rekomandojnë përdorimin e variablave të mjedisit, ndalojnë vendosjen e çelësit në Git dhe këshillojnë që aplikacionet publike web ose mobile t’i bëjnë thirrjet përmes serverit. Mos e fut çelësin në prompt apo në kodin që u dërgohet përdoruesve. Përpara se njoftimi i sajuar të zëvendësohet me hyrje reale, hiq të dhënat personale që nuk nevojiten për titullin, vendin, ditën, orën dhe përshkrimin.

Lexoni gjithashtu:

• Prompt injection te agjentët AI: lejet e kufizuara vlejnë më shumë se filtri
• Oferta e punës kërkon para? Tre kontrolle para se të përgjigjesh
• Google Meet apo Zoom falas: 20 minuta ndryshojnë zgjedhjen