Parimad tavad ja levinud vead
Sellel lehel
Uuendatud 3. novembril 2026. Põhineb xAI API dokumentatsioonil:
max_completion_tokenspiirab ainult nähtavat vastust; arutlusplokid (reasoning tokens) sellesse ei kuulu jareasoning_effortkontrollib nende hulka. Allikas: Chat Completions.
Kokkuvõte ja ohutuspiirangud
See viimane tund käsitleb Grokiga vihjete (promptide) koostamisel olulisemaid parimaid tavasid ja levinumaid vigu. Vaata seda kui kontrollnimekirja, mida kasutada iga kord, kui lood või täiustad vihjet.
Parimad tavad
1. Struktureeri oma vihjed süstemaatiliselt
Eralda alati kontekst, ülesanne ja piirangud. Mudelil on raske tõlgendada tekstiplokki, mis on segamini, võrreldes vihjega, mis on jaotatud selgeteks lõikudeks.
2. Kasuta süsteemsõnumit püsivate juhiste jaoks
Pane kõik, mis peab kehtima igas vahetuses (keel, vorming, toon, piirangud), süsteemsõnumisse. Olukorrapõhised juhised pane kasutaja sõnumitesse.
3. Paku näiteid kirjelduste asemel
Kui väljundvorming on keeruline, on üks näide väärt tuhandet sõna kirjeldust. Mõne näitega vihjastamine (few-shot prompting) on peaaegu alati tõhusam kui oodatava vormingu üksikasjalik selgitus.
4. Sobita mudel ülesandega
- Lihtne ja kiire ülesanne:
grok-4.3võigrok-build-0.1(koodi jaoks) - Keeruline arutlusülesanne:
grok-4.20-0309-reasoningsuure jõupingutusega - Pildianalüüs:
grok-4.5detailseadistusega (madal/kõrge)
5. Kohanda temperatuuri eesmärgi järgi
- Ekstraheerimine, klassifitseerimine, faktiline: temperatuur 0 kuni 0,3
- Professionaalne kirjutamine, kokkuvõte: temperatuur 0,4 kuni 0,7
- Ideede genereerimine, loovus: temperatuur 0,8 kuni 1,5
6. Testi kasutades parameetrit seed
Kahe vihjevariandi objektiivseks võrdlemiseks kasuta sama seemet (seed). See kõrvaldab juhuslikkusest tingitud varieeruvuse ja võimaldab mõõta sinu muudatuse mõju.
7. Loo vihjete teek
Hoia oma parimaid vihjeid kasutusjuhtumite järgi organiseeritud teegis. Hea vihje on investeering: selle väärtus kasvab iga uuestikasutamisega.
Levinud vead
Viga 1: Ebamäärased vihjed
Mudel ei loe mõtteid. Mida täpsem oled, seda parem on tulemus.
Viga 2: Arutlusmudelite piirangute eiramine
Groki arutlusmudelid ei toeta teatud parameetreid: frequency_penalty, presence_penalty ja stop põhjustavad vea. Lubada keerukate ülesannete jaoks aegumistähtaeg 3600 sekundit.
Viga 3: Ajaloo muutmine vestluse käigus
Groki API on olekuta (stateless). Ajaloo muutmine rikub järelduste vahemälu ja halvendab jõudlust.
Viga 4: Temperatuuri ja top_p samaaegne kasutamine
Temperatuuri ja top_p samaaegne muutmine annab ettearvamatuid tulemusi. Vali kas üks või teine.
Viga 5: Arutlusplokkide eiramine eelarves
Arutlusmudelitel liidetakse arutlusplokid (reasoning tokens) nähtavale vastusele ja neid arveldatakse väljundi hinnaga, kuid max_completion_tokens ei piira neid: see piirab ainult nähtavat vastust. Selle kulu kontrollimiseks määra arutluse jõupingutus (reasoning_effort) ja jälgi kasutuses reasoning_tokens.
Viga 6: Väljundvormingu määramata jätmine
Ilma vormingujuhisteta valib mudel enda arvates sobiva vormingu. Määra alati oodatav vorming.
Viga 7: Liiga palju ebaolulist konteksti
xAI dokumentatsioon soovitab sõnaselgelt jätta ebaoluline teave kontekstist välja.
Viga 8: Ajaloo salvestamine koos piltidega
Kasuta päringutes, mis sisaldavad pilte, väärtust store: false, et vältida vigu.
Kursuse kokkuvõte
Nende 14 tunni jooksul õppisid sa:
- Struktureerima oma vihjeid selguse, konteksti ja vorminguga (tunnid 1–4)
- Kasutama kaugeleulatuvaid tehnikaid: mõned näited (few-shot), mõtteahel, süsteemijuhised, iteratsioon, multimoodus (tunnid 5–9)
- Rakendama vihjestamist reaalsetes näidetes: kirjutamine, analüüs, kood (tunnid 10–12)
- Looma ekspertvihjeid, järgides metoodilist protsessi (tund 13)
Vihjete koostamine on oskus, mis paraneb harjutamisega. Iga täiustatud vihje rikastab sinu kogemust ja taaskasutatavate mallide teeki.
Peamised punktid
- Struktureeri oma vihjed alati eraldiseisvateks lõikudeks
- Sobita mudel ja parameetrid iga ülesandega
- Paku näiteid pikkade kirjelduste asemel
- Vältida klassikalisi vigu: kokkusobimatud parameetrid, muudetud ajalugu, liigne kontekst
- Dokumenteeri ja kasuta uuesti oma parimaid vihjeid
- Vihjete koostamine on iteratiivne: testi, diagnoosi, kohanda
Testi oma teadmisi
Pärast ekspertide töötuba viimane kontroll Groki vihjestamise tehnikate kohta.
1. Mis on süsteemi roll võrreldes kasutaja ja assistendi rollidega?
Vastus: Süsteemi roll määrab vestluse püsiva raamistiku – identiteet, reeglid, vorming –, samas kui kasutaja esitab päringuid ja assistent annab vastuseid: rakendusjuhised ei tohi seguneda dialoogiga.
2. Millal langetada temperatuuri?
Vastus: Faktiliste ülesannete, ekstraheerimise ja koodi puhul, kus varieeruvus on viga; tõsta seda loovuse jaoks – seade sõltub sellest, kui kalliks läheb erinev vastus ühest käivitusest teise.
3. Mida annab mõtteahel (chain of thought)?
Vastus: Arutlusülesannetes vähendab sammude küsimine enne järeldust oluliselt vigu – mudel lahti harutab protsessi, selle asemel et hüpata tõenäolisele vastusele.
4. Kuidas vihjestada multimooduses (tekst + pilt)?
Vastus: Raamistades analüüsi nagu teksti: täpne küsimus, kriteeriumid, väljundvorming – pilt on andmed, vihje jääb meetodiks.
5. Nimeta kaks levinud viga, mida vältida.
Vastus: Struktueerimata ja vorminguta üldised päringud ning iteratsiooni puudumine – esimese väljundi aktsepteerimine selle täiustamise asemel; kursuse parimad tavad on täpselt vastupidised.
Selge raamistik, kohandatud seaded, iteratsioonid: tehnikad taanduvad kolmele liigutusele – töötuba lasi sul neid harjutada, sinu projektid lõikavad vilja.