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 Qt developer licenci. 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. Idite na Extensions.

   

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 Postavke > 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 (pruža Anthropic, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj Anthropic račun: console.anthropic.com)
• Claude 4.5 Sonnet (pruža Anthropic, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj Anthropic račun: console.anthropic.com)
• GPT 5 (dostavlja OpenAI, imajte na umu da morate imati konfiguriran način plaćanja temeljen na tokenima za svoj OpenAI račun: platform.openai.com)
• DeepSeek V3.2 (pruža 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 Postavke > AI Assistant > General.

   

2. Odaberite LLM za svaki konfigurabilni slučaj upotrebe.
3. Idite na Advanced.

   

4. Unesite token za autentifikaciju API-ja i URL poslužitelja svakog LLM-a. Za više informacija o tome gdje pronaći podatke za pristup pogledajte dokumentaciju pružatelja LLM-a treće strane.

Automatsko dovršavanje koda

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

Za prihvaćanje cijelog prijedloga odaberite tipku Tab.

Da biste prihvatili dijelove prijedloga, pritisnite 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 Postavke > 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 koda 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 za unutarredne upite odaberite Esc ili .

Da biste iz prozora s upitima u kodu otišli na postavke Qt AI Assistant, odaberite . Tamo možete postaviti model koji ćete koristiti za upite i preglede koda.

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 ikone Copy u prozoru ugrađenog upita.

Zatražite pregled koda

Za pregled koda s Qt AI Assistantom:

1. Istaknite kod u uređivaču koda.
2. Otvorite prozor za unutarni upit.
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 Postavke > 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 koda.
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 testni projekt.

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 testni projekt

Konfigurirajte projekt za testiranje CMakeLists.txt

Povežite dodatak sa svojim testnim ciljem (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 projekt za testiranje 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})

   Postavite putanju uvoza QML-a kako bi Qt mogao pronaći modul:
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 koda.
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 kôd u uređivaču kôda.
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

Za zahtjev objašnjenja 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 inlinijske komentare

Za dodavanje inline komentara u postojeći kod s Qt AI Assistantom:

1. Istaknite kôd u uređivaču koda.
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 liniji koje možete primijeniti na svoj kod.