Koristite Qt AI Assistant

Qt AI Assistant je pomoćnik za kodiranje. Kada je povezan s velikim jezičnim modelom (LLM), automatski dovršava vaš kod, daje stručne savjete za kodiranje, predlaže ispravke koda, kao i piše testne slučajeve i dokumentaciju koda.

Qt AI Assistant dostupan je za odabrane vlasnike komercijalnih licenci za Qt razvoj. Za više informacija o licenciranju odaberite Compare u odjeljku Qt pricing.

Da biste naučili osnove Qt AI Assistant-a, pohađajte tečaj Qt Academy: Getting Started With Qt AI Assistant.

Qt AI Assistant trenutno je eksperimentalan i pokreće ga generativna umjetna inteligencija. Provjerite sve prijedloge kako biste bili sigurni da su prikladni za upotrebu u vašem projektu.

Instalirajte Qt AI Assistant

Za učitavanje ekstenzije Qt AI Assistant s weba:

1. Extensions Idite u način rada Qt AI Assistant.

   

2. Odaberite Use external repository.
3. Odaberite AI Assistant.
4. Odaberite Install.

Omogućite isticanje sintakse koda u prozoru za razgovor

Da biste omogućili isticanje sintakse koda u prozoru za razgovor, idite na Preferences > Text Editor > Generic Highlighter, a zatim odaberite Download Definitions.

Za više informacija pogledajte Preuzimanje definicija isticanja.

Instalirajte i koristite Ollamu

Za korištenje LLM-ova koji se pokreću lokalno na vašem računalu s proširenjem Qt AI Assistant, instalirajte Ollamu. Možete pokretati modele dostupne u odabiru Ollame, kao i prilagođene modele koje dodate u Ollamu.

Pokrenite modele na Ollami

Za pokretanje modela unesite:

ollama run <model-name>

Na primjer:

ollama run codellama:7b-code

Podržani modeli iz Ollame

Možete koristiti sljedeće modele izravno iz Ollame:

• codellama:7b-code
• deepseek-coder-v2:lite
• gpt-oss:20b
• theqtcompany/codellama-7b-qml
• theqtcompany/codellama-13b-qml

Prilagođeni modeli

Za prilagođene modele slijedite specifične upute za instalaciju za taj način. Možete koristiti sljedeće prilagođene modele:

• codellama:7b-code-qml
• codellama:13b-code-qml

Povežite se s LLM-om

Možete se povezati na sljedeće LLM-ove:

• Code Llama 13B QML (za Qt 6, pokrenuto u oblačnom okruženju po vašem izboru)
• Code Llama 13B (za Qt 5, pokrenuto u oblačnom okruženju po vašem izboru)
• Codestral (koji pruža Mistral)
• Claude 4.0 Sonnet (koji pruža Anthropic, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj Anthropic račun.
• Claude 4.5 Sonnet (Anthropic, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj Anthropic račun.
• GPT 5 (provideira OpenAI, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj OpenAI račun.
• DeepSeek V3.2 (osigurao DeepSeek)
• Code Llama 13B QML putem Ollame (radi lokalno na vašem računalu)
• Code Llama 7B QML putem Ollame (radi lokalno na vašem računalu)
• Code Llama 7B putem Ollame (radi lokalno na vašem računalu)

Za povezivanje s LLM-om:

1. Idite na Preferences > AI Assistant > General.

   

2. U LLM odaberite LLM.
3. U Authentication token unesite API ključ za autentifikaciju za LLM.

Za povezivanje na više LLM-ova i prebacivanje između njih za različite slučajeve upotrebe:

1. Idite na Preferences > AI Assistant > Advanced.

   

2. Odaberite LLM za svaki konfigurabilni slučaj upotrebe.
3. U Model Configuration unesite API token za autentifikaciju i URL poslužitelja svakog LLM-a. Za više informacija o tome gdje pronaći podatke za pristup pogledajte dokumentaciju pružatelja trećih strana za LLM.

Automatsko dovršavanje koda

Qt AI Assistant može vam pomoći pri pisanju koda predlažući što sljedeće upisati. On potiče LLM da generira prijedlog koda kada prestanete tipkati.

Za prihvaćanje cijele sugestije pritisnite tipku Tab.

Za prihvaćanje dijelova prijedloga odaberite Alt+Desno.

Da biste odbacili prijedlog, pritisnite Esc ili se pomaknite na drugu poziciju u uređivaču koda.

Za interakciju s Qt AI Assistantom pomoću miša, pređite mišem preko prijedloga.

Kada pređete mišem preko prijedloga, možete prihvatiti dijelove predloženog isječka koda riječ po riječ ili redak po redak.

Za zatvaranje trake za dopunu koda pritisnite tipku Esc ili premjestite kurzor na drugu poziciju.

Za odabir modela za dopunu koda idite na Preferences > AI Assistant > General.

U General u također možete globalno uključiti ili isključiti automatsko dovršavanje koda za sve projekte. Qt AI Assistant troši značajan broj tokena iz LLM-a. Kako biste smanjili troškove, isključite značajku automatskog dovršavanja kada nije potrebna i koristite prečace na tipkovnici za dovršavanje koda.

Dovršite kod s tipkovnice

Za ručno pokretanje prijedloga koda odaberite Ctrl+'.

Unesite upite i pametne naredbe

U prozoru ugrađenog upita u uređivaču teksta možete zatražiti od asistenta da izvrši vaše zahtjeve na ljudskom jeziku, postaviti pitanja ili izvršiti pametne naredbe. Za otvaranje chata odaberite Ctrl+Shift+A. Alternativno, za otvaranje prozora ugrađenog upita možete odabrati kôd i zatim odabrati .

Za zatvaranje prozora inline prompta odaberite Esc ili .

Da biste iz prozora za upite u kodu otišli na postavke Qt AI Assistant, odaberite (Preferences). Tamo možete postaviti model koji ćete koristiti za upite i pregled kodova.

Zatražite prijedloge na ljudskom jeziku

Da biste zatražili prijedloge na ljudskom jeziku, unesite svoje zahtjeve u polje za unos. Ako ste označili kod, AI asistent ga dodaje kao kontekst upitu. Qt AI Assistant prikazuje prijedlog koji možete kopirati u međuspremnik odabirom gumba Copy u prozoru ugrađenog upita.

Zatražite pregled koda

Za pregled koda s Qt AI Assistantom:

1. Istaknite kôd u uređivaču koda.
2. Otvorite prozor za upite u liniji.
3. Odaberite pametnu naredbu /review.

Qt AI Assistant pregledava kod i predlaže poboljšanja. Koristi QML Lint za pregled QML koda ako je Enable QML linter uključen u Preferences > AI Assistant > General.

Zatražite testne slučajeve u sintaksi Qt Test

Za pisanje testnih slučajeva s Qt AI Assistantom:

1. Istaknite kôd u uređivaču kôda.
2. Otvorite prozor ugrađenog prompta.
3. Odaberite pametnu naredbu /qtest.

Qt AI Assistant generira testni slučaj u Qt Test formatu koji možete kopirati i zalijepiti u svoj Qt projekt za testiranje.

Za pokretanje generiranog Qt Test slučajeva, konfigurirajte svoje datoteke CMakeLists.txt i main.cpp.

Konfigurirajte glavni projekt CMakeLists.txt

1. Definirajte svoj modul i kao biblioteku i kao QML modul. Vrijednost URI-ja određuje naziv uvoza koji se koristi u TestCase skriptama:

   qt_add_library({module_name} STATIC)
   qt_add_qml_module({module_name}
       URI {module_name}
       VERSION 1.0
       QML_FILES
               Main.qml
   )

2. Dodajte automatski generirani dodatak u biblioteke poveznica vaše ciljne aplikacije. Naziv dodatka slijedi obrazac <naziv_modula>plugin:

   target_link_libraries({project}
       PRIVATE Qt6::Quick {module_nameplugin}
   )

3. Dodajte QML_IMPORT_PATH na kraj datoteke kako biste osigurali da QML-motor može pronaći vaš modul:

   set(QML_IMPORT_PATH ${CMAKE_BINARY_DIR} CACHE STRING "" FORCE)

Konfigurirajte projekt za testiranje CMakeLists.txt

Povežite dodatak sa svojom testnom odredišnom točkom (test_directory):

target_link_libraries({test_directory} PRIVATE Qt${QT_VERSION_MAJOR}::QuickTest {module_nameplugin})

Konfigurirajte glavni projekt main.cpp

Za učitavanje vaše QML komponente iz registriranog modula upotrijebite loadFromModule():

engine.loadFromModule("{module_name}", "Main");

Konfigurirajte vanjske testne projekte

Ako je testni projekt izvan glavnog projekta:

1. Dodajte glavni projekt kao poddirektorij u testni projekt CMakeLists.txt:

   add_subdirectory(../{main_project_directory} ${CMAKE_BINARY_DIR}/{main_project_directory})

2. Postavite putanju za uvoz QML-a kako bi Qt mogao pronaći modul:

   set_target_properties({test_directory} PROPERTIES
       QT_QML_IMPORT_PATH "${CMAKE_BINARY_DIR}/{main_project_directory}"
   )

Ponovno izgradite projekte.

Zatražite dokumentaciju koda u Markdown formatu

Za izradu dokumentacije koda:

1. Istaknite kôd u uređivaču kôda.
2. Otvorite prozor ugrađenog naredbenog retka.
3. Odaberite pametnu naredbu /doc.

Qt AI Assistant generira dokumentaciju koda u formatu koji možete kopirati i zalijepiti u svoju datoteku dokumentacije.

Zatražite ispravak koda

Da biste zatražili ispravak koda:

1. Istaknite kod u uređivaču koda.
2. Otvorite prozor ugrađenog prompta.
3. Odaberite pametnu naredbu " /fix ".
4. Po želji primijenite promjene na kod.

Qt AI Assistant predlaže ispravak koji možete primijeniti na svoj kod.

Zatražite objašnjenje koda

Zahtjev za objašnjenje postojećeg koda:

1. Istaknite kod u uređivaču koda.
2. Otvorite prozor inline prompta.
3. Odaberite pametnu naredbu " /explain ".

Qt AI Assistant pruža objašnjenje označenog koda.

Dodajte komentare u liniji

Za dodavanje inline komentara postojećem kodu pomoću Qt AI Assistant:

1. Istaknite kôd u uređivaču kôda.
2. Otvorite prozor za inline upite.
3. Odaberite pametnu naredbu " /inlinecomments ".
4. Po želji primijenite komentare na svoj kod.

Qt AI Assistant dodaje komentare u kodu koje možete primijeniti na svoj kod.