Koristite klijent ACP-a

Uz proširenje ACP Client možete razgovarati s agentima temeljenima na umjetnoj inteligenciji koji razumiju vašu bazu koda i u vaše ime izvršavaju radnje, kao što su uređivanje datoteka, izvršavanje naredbi ili pokretanje izgradnje.

Ova tema vodi vas kroz postavljanje i korištenje ekstenzije ACP klijenta, od aktivacije ekstenzije do produktivne chat sesije s agentom.

Preduvjeti

• Aktivirajte ekstenziju ACP Client u načinu rada Extensions. Za više informacija o ekstenzijama pogledajte Aktivirajte ekstenzije.
• Preporučeno: Aktivirajte i postavite ekstenziju MCP Server ako želite da agent pokreće radnje u načinu rada Qt Creator, kao što su izgradnja ili pokretanje vašeg projekta. Za više informacija pogledajte Postavljanje Qt Creator MCP poslužitelja.

Konfigurirajte agenta

Prije otvaranja chata odaberite agenta u Preferences. Možete odabrati jednog od unaprijed konfiguriranih agenata ili definirati vlastitog.

Unaprijed konfigurirani agenti

Za postavljanje unaprijed konfiguriranog agenta:

1. Idite na Preferences > AI > ACP Servers.
2. Odaberite Add.
3. U odjeljku Template odaberite unaprijed konfiguriranog agenta za korištenje s njegovim zadanim postavkama.
4. Odaberite Apply za spremanje.

Prilagođeni agenti

Za postavljanje prilagođenog agenta:

1. Instalirajte AI agenta na računalo ili mrežu i provjerite vezu s njim.
2. Idite na Preferences > AI > ACP Servers.
3. Odaberite Add.
4. U Template odaberite Custom.
5. U odjeljku Name navedite naziv za konfiguraciju agenta.
6. U Executable, navedite izvršnu datoteku za pokretanje procesa ACP poslužitelja.
7. U Arguments, navedite argumente naredbenog retka koji će se proslijediti pri pokretanju procesa ACP poslužitelja.
8. U odjeljku Environment Changes odaberite Change kako biste dodali sve potrebne promjene varijabli okruženja za proces agenta.
9. Odaberite Apply za spremanje.

Povežite se s agentima

Sadržaj ACP registra određuje metodu povezivanja s određenim agentom:

• binary Paketi se koriste izravno bez ovisnosti.
• npx Paketi za Node.js zahtijevaju instalaciju Node.js-a.
• uvx Python paketi zahtijevaju instalaciju upravitelja paketa uv i Pythona.

npx

Da biste provjerili imate li Node.js, upišite node --version u naredbeni redak.

Ako AI agent ne može pronaći binarnu datoteku npx koju koristi za pokretanje Claude agenta, iako je mapa u PATH-u, dodajte direktorij npx u putanju u Preferences > Environment > System. U Environment odaberite Change i dodajte PATH+=<full-path-to-folder).

Claude CLI

Možda ćete morati instalirati dodatne ovisnosti da biste koristili neke agente. Na primjer, za autentifikaciju na Claudeu također morate instalirati Claude Code CLI. Da biste provjerili imate li ga, unesite claude --version u naredbeni redak.

Otvorite prozor za chat ACP-a

U načinu rada Edit možete otvoriti prozor za razgovor ACP-a na sljedeće načine:

• Idite na Tools > ACP Client > Show Agentic AI Chat in Side Panel.
• Odaberite (Show Agentic AI Chat in Side Panel) na alatnoj traci uređivača kada imate otvorenu datoteku.

Povežite se na ACP poslužitelj

Nakon što otvorite prozor chata za projekt, povežite se s ACP poslužiteljem.

Za povezivanje na ACP poslužitelj:

1. Odaberite agenta koji ste konfigurirali.
2. Odaberite Connect.

Ako agent nije naveden u Choose AI Agent u, odaberite Manage Agents da biste ga dodali.

Qt Creator pokreće proces agenta i uspostavlja ACP vezu.

Za pokretanje nove sesije odaberite Add Chat i povežite se na poslužitelj.

Pregledajte ACP komunikaciju

Proširenje ACP klijenta šalje poruke (zahtjeve) na ACP poslužitelj i prima odgovore koji sadrže tražene informacije ako je poslužitelj u mogućnosti obraditi zahtjeve. Za pregled komunikacije između proširenja i ACP poslužitelja idite na Tools > ACP Client > Inspect ACP Client.

U odjeljku ACP Client odaberite ACP poslužitelj za prikaz popisa događaja. Odaberite događaj kako biste vidjeli zahtjev klijenta u odjeljku Client Message i odgovor poslužitelja u odjeljku Server Message.

Za uklanjanje starih unosa odaberite Clear.

Za spremanje poruka kao datoteku odaberite Save.

Alatna traka prozora za razgovor

Nakon povezivanja, alatna traka na dnu prozora chata prikazuje kontrole koje možete prilagoditi u bilo kojem trenutku tijekom sesije.

Različite opcije konfiguracije u alatnoj traci ovise o odabranom agentu. Za prikaz više informacija o opciji, pređite mišem preko nje kako biste vidjeli skočni opis.

Razgovarajte s agentom

Upišite svoju poruku u polje za unos na dnu prozora za razgovor i odaberite Send ili Enter.

Da biste umetnuli naredbu u svoju poruku, odaberite / i iz popisa odaberite naredbu.

Kontekst u porukama

Qt Creator automatski prilaže trenutni kontekst urednika svakoj poruci, tako da možete koristiti prirodne reference kao što su:

• Objasni trenutni kod.
• Refaktoriraj odabrani blok kako bi koristio for petlju temeljenu na rasponu.
• Zašto izgradnja ne uspijeva? Popravite to.

  Napomena: Ovo zahtijeva ekstenziju MCP servera kako bi agent mogao pokrenuti sustav za izgradnju i pročitati izlaz kompajlera.

• Dodajte unit testove za funkciju na kursoru.
• Pregledajte vidljivi kod i predložite poboljšanja.

Za ručno dodavanje više konteksta svojoj poruci odaberite > Add file ili Add remote file u Context.

Odgovori agenta

Odgovor agenta pojavljuje se u prozoru chata.

Ako agent predloži izmjene datoteka, možete ih pregledati u prozoru chata. Ovisno o odabranom Mode u, možda ćete morati dopustiti agentu da ih primijeni.

Tipični tijekovi rada

Možete koristiti ACP klijent za širok raspon zadataka. Evo nekoliko primjera tijekova rada za početak.

Objasnite i istražite

1. Otvorite bilo koju izvornu datoteku.
2. Postavite Mode na ' Plan Mode ' kako biste spriječili slučajne izmjene.
3. Upitajte: Prođite me kroz to što ova klasa radi i identificirajte sve potencijalne probleme.
4. Pročitajte analizu agenta u povijesti chata.

Refaktoriraj uz pregled

1. Odaberite kod koji želite promijeniti.
2. Postavite Mode na Default.
3. Upit: Izvadite odabrani kod u zasebnu funkciju nazvanu processInput.
4. Pregledajte predložene promjene.

Izgradi i popravi

1. Provjerite jesu li oba ekstenzija, ACP Client i MCP Server, aktivna.
2. Postavite Mode na Accept Edits.
3. Upit: Izgradite projekt i ispravite sve greške kompajlera.
4. Agent pokreće izgradnju putem MCP poslužitelja, čita izlaz i primjenjuje ispravke. Pratite napredak u povijesti chata.