QuickAgent - Opas

QuickAgent-käyttöopas

QuickAgent on paikallisuutta ensisijaisesti hyödyntävä AI-agenttityötila. Se muuttaa tavoitteen kestäväksi Run-ajoksi, rajaa kyseisen ajon Workspace Profile -profiililla, pyytää tarkistusta ennen arkaluonteisia toimia ja säilyttää varmennetut tulokset Artifacts-kohteissa.

Näin pääset alkuun

Avaa Settings > AI, lisää palveluntarjoaja ja suorita sen yhteystesti.
Avaa Settings > Workspace Profiles. Valitse, mitä palveluntarjoajaa, työkaluja, yhteyksiä, tiedostojuria, Knowledge-lähteitä ja Memory-laajuuksia voidaan käyttää.
Valitse New Chat, valitse profiili ja vahvista keskustelun yläpuolella näkyvä palveluntarjoajan kohde.
Kuvaile tavoite. Lisää vain tähän Run-ajoon tarvittavat tiedostot, kansiot, mediat, Knowledge-tiedot tai Memory-tiedot.
Tarkista suunnitelma, hyväksynnät, Critical-vahvistus ja Data Send Preview, kun ne tulevat näkyviin.
Seuraa työtä Timeline-näkymässä. Avaa valmis tuloste kohteesta Artifacts ja tarkista tarkastusjälki kohdassa Historia.

Vinkki: Aloita suppealla Workspace Profile -profiililla. Laajenna sen työkaluja tai juuria vain, kun QuickAgent näyttää tarkan syyn, miksi jokin ei ole käytettävissä.

Käyttöliittymän yleiskatsaus

Osio	Käyttötarkoitus
Chats	Keskustelut, palveluntarjoajan kohde, Context Tray, suunnitelmat, hyväksynnät ja aktiivisen Run-ajon Timeline.
Runs	Jokainen suunniteltu, käynnissä oleva, keskeytetty, ajoitettu, epäonnistunut tai valmistunut tehtävä.
Approval Inbox	Odottaa päätöstäsi: vireillä olevat toiminto-, Critical- ja Data Send -tarkistukset.
Artifacts	Run-ajojen luomat varmennetut tiedostot, raportit, lokit, mediat, taulukot ja toimintomanifestit.
Automations	Ajoitukset, valvonnat, webhookit, sovellustapahtumat ja Shortcut/App Intent -käynnistimet.
Skills	Uudelleenkäytettävät ohjeet, joissa on tyypitetyt syötteet, sallitut työkalut, vaaditut yhteydet, riski ja tulosteet.
Connections	Palveluntarjoajat, selainprofiilit, tiedosto-/VFS-juuret, SSH, MCP, HTTP/SaaS, kotiverkkosillat ja ilmoituskanavat.
Knowledge	Indeksoidut kansiot, QuickNote-sisältö, verkkoleikkeet, PDF-tiedostot ja Office-lähteet.
Historia	Vain lisättävät turvallisuuspäätökset, työkalutoiminnot, kohteet ja aikaleimat.
Asetukset	Ulkoasu, kieli, AI, työkalut, turvallisuus, Workspace Profiles, pikakomennot, käyttöoikeudet, Ohje ja Pro.

Palveluntarjoajat ja Workspace Profiles

QuickAgent voi käyttää System AI:tä, kun käyttöjärjestelmä tarjoaa yhteensopivan ominaisuuden, paikallisia palveluntarjoajia, kuten Ollama, LM Studio tai DeskLLM, lähiverkon tai mukautettuja OpenAI-yhteensopivia päätepisteitä sekä määritettyjä pilvipalveluntarjoajia, kuten Anthropic tai Gemini. Saatavuus määräytyy reaaliaikaisen ominaisuustestin perusteella; pelkkä palveluntarjoajan nimi ei tarkoita, että se on valmis käytettäväksi.

Workspace Profile on Run-ajon käyttöoikeuskehys. Se ottaa tilannevedoksen valitusta palveluntarjoajasta/mallista, sallituista työkaluista, yhteyksistä, tiedostojurista, Knowledge-lähteistä, Memory-laajuuksista, turvallisuuden ohituksista ja budjetista. Myöhempi määritysmuutos vanhentaa tilannevedoksen ja edellyttää tarkistusta.

Kohdesääntö: QuickAgent ei koskaan vaihda huomaamatta laitteessa toimivasta tai paikallisesta palveluntarjoajasta pilveen. Aktiivinen kohde näkyy edelleen Chatissa ja jokaisessa Data Send -tarkistuksessa.

Run-ajot, hyväksynnät ja palautuminen

Run-ajon hallintatoiminnot

Pause pyytää yhteistyöperusteista pysäytystä kestävässä tarkistuspisteessä.
Resume jatkaa samaa Run-ajoa ja valmistunutta työtä.
Pysäytä peruuttaa palveluntarjoaja- ja työkalutyön. Pysäytettyä tai epävarmaa ulkoista vaikutusta ei ilmoiteta onnistumisena.
Retry on käytettävissä vain, kun QuickAgent pystyy tunnistamaan turvallisen uudelleenyritysrajan.

Turvallisuustasot

Taso	Merkitys
Safe	Lue, tarkista tai muunna aktiivisen profiilin sisällä.
Approve	Tarkista tavallinen kirjoitus- tai ulkoinen toiminto.
Varmista, että	Tarkista vaikutuksiltaan suurempi tai vaikeammin peruutettava muutos.
Critical	Vahva vahvistus joka kerta; säännöt eivät koskaan hyväksy sitä automaattisesti.

Hyväksyntä näyttää tarkan kohteen, määränpään, ehdotetut argumentit, riskin ja Undo-tilan. Jos muokkaat argumenttia, QuickAgent validoi ja riskitarkistaa muokatun toiminnon uudelleen.

Epävarma lopputulos: keskeytyksen jälkeen tarkista ensin kohdejärjestelmä. Valitse “Tarkistin — yritä uudelleen” vain, kun toiminnon toistaminen on tarkoituksenmukaista. Pelkkä “Resume” ei koskaan toista epävarmaa ulkoista vaikutusta.

Moniagenttiset Run-ajot

Monimutkaisissa tavoitteissa voidaan käyttää suunnittelijaa, tyypitettyjä erikoistyöntekijöitä, tarkistajaa ja tietoturvatarkistajaa. Timeline näyttää jokaisen luovutuksen, tarkistuksen, uudelleenyrityksen, varavaihtoehdon ja lopullisen vastauksen rajan. Työntekijät saavat vain Skills-työkalujen, Workspace Profile -työkalujen, roolityökalujen ja kulloinkin käytettävissä olevien työkalujen nelisuuntaisen leikkauksen.

Yleiset ja roolikohtaiset budjetit rajoittavat kutsuja, aikaa, kustannuksia, verkkotavuja ja tokeneita. Kun budjetti saavutetaan, QuickAgent keskeytyy. Se näyttää nykyiset ja ehdotetut rajat ja kasvattaa niitä vain nimenomaisen tarkistuksen jälkeen. Hyväksytty budjetti ja valmistunut roolihistoria säilyvät uudelleenkäynnistyksen jälkeen.

Konteksti, Knowledge ja AI Memory

Context Tray

Lisää tiedostoja, kansioita, kuvia, videoruutuja, ääntä, äänimuistiinpanoja, QuickNote-sisältöä, Knowledge-tietoja tai Workspace Memory -tietoja. QuickAgent purkaa tai tiivistää tuetun sisällön ja näyttää, lähetetäänkö liite suoraan palveluntarjoajalle.

Knowledge

Knowledge-lähteet indeksoidaan erillään keskustelusta. Run-ajo voi hakea vain Workspace Profile -profiilinsa sallimista lähteistä, ja viittaukset säilyttävät lähdetunnisteensa.

Memory

Memory on harkittua, ei automaattista keskusteluhistoriaa. User-, Workspace-, Project- ja Tool/Connection-laajuudet ovat erillisiä. Jokainen luonti-, muokkaus- tai poistopyyntö saa uuden hyväksynnän, ja hyväksynnän esikatselu näyttää laajuuden ja tarkan ehdotetun arvon.

Työkalut ja yhteydet

Aktiivinen luettelo kattaa tiedosto- ja VFS-toiminnot; Office-, PDF- ja rakenteiset tiedot; median ja OCR-teknologian; selaimen ja tietokoneen käytön; kehityskomennot; SSH-yhteydet; MCP-palvelimet; HTTP-protokollat ja SaaS-palvelut; älykotien sillat; ilmoitukset; ajoitukset; valvonnat; sekä automaation hallinnan. Yhdistetyt MCP-palvelimet voivat lisätä dynaamisia työkaluja skeeman validoinnin ja QuickAgent-riskin uudelleenarvioinnin jälkeen.

Settings > Tools näyttää, miksi työkalu on valmis tai poistettu käytöstä. Yleisiä syitä ovat puuttuva yhteys, käyttöjärjestelmän käyttöoikeus, tukematon alusta, Workspace Profile -rajoitus, testaamaton päätepiste tai palveluntarjoajan ominaisuuden puuttuminen.

Tietokoneen käyttö: näytön kaappaus ja esteettömyys-/syötteenohjaus ovat erillisiä käyttöoikeuksia. Pidä näkyvä esikatselu ja hätä-Stop käytettävissä. Mobiilialustat eivät tarjoa samaa rajoittamatonta työpöytäohjausta.

Automations

Automaatiot voivat käynnistyä ajasta, tiedostosta/kansiosta, verkosta, webhookista, sähköpostista, kalenterista, verkosta, isännästä, laitteesta, anturista, sijainnista, sovellustapahtumasta, Shortcut/App Intent -toiminnosta, komennosta tai manuaalisista käynnistimistä, kun alusta tukee niitä. Käynnistin luo tavallisen Run-ajon; se ei ohita Workspace Profile-, hyväksyntä-, Critical- eikä Data Send -tarkistuksia.

Työpöytävalvonta jatkuu vain, kun sovellusprosessi on käynnissä.
Mobiilialustat palauttavat myöhässä olevat työt, kun sovellus palaa etualalle.
Käytä Shortcut/App Intent -toimintoa tai luotettavaa tapahtumavälitintä, kun käyttöjärjestelmän toimitus on tarpeen.
Jonossa olevat tapahtumat, keskeytys, peruutus ja poisto säilyvät nimenomaisina, jotta tapahtumia ei hylätä huomaamatta.

Skills ja Skill Packs

Skill tallentaa lopputulokseen keskittyvän kehotteen, tyypitetyt muuttujat, palveluntarjoajasuosituksen, sallitut työkalut, vaaditut yhteydet ja ominaisuudet, enimmäisriskin sekä odotetut Artifacts-kohteet. Ennen käyttöä QuickAgent näyttää syötteet ja voimassa olevat käyttöoikeudet; esikatselu ei itsessään myönnä käyttöoikeutta.

Seitsemän sisäänrakennettua Packia tarjoaa todellisia Skills-toimintoja Office-, koodaus-, älykoti-, tutkimus-, selainautomaatio-, henkilökohtainen hallinto- ja häiriötilanteiden hallinta -käyttöön. Voit asentaa, päivittää, poistaa asennuksen, mukauttaa, monistaa, tuoda ja viedä Skills-toimintoja. Tuotu JSON saa luottamus-, julkaisija-, allekirjoitus-, käyttöoikeus-, riski-, alusta- ja ristiriitaesikatselun. “Säilytä molemmat” luo allekirjoittamattoman paikallisen johdannaisen sen sijaan, että se perisi toisen julkaisijan luottamuksen.

Artifacts, historia ja Undo

Artifacts-kohteet säilyttävät tulostetavut, metatiedot, versiot, alkuperän, lähde-Run-ajon ja toimintomanifestit. Alustan ominaisuuksista riippuen voit avata, jakaa, viedä tai näyttää ne. Kelpoiset toiminnot tarjoavat tarkistetun Undo-toiminnon; tuhoavaa tai epävarmaa työtä ei koskaan toisteta automaattisesti.

Historia on vain lisättävä. Suodata se Safe-, Approve-, Confirm- tai Critical-tason mukaan ja vie tarkastus, kun tarvitset ulkoista tietuetta.

Asetukset

Yleiset: ulkoasu, kieli, Workspace Profiles, pikakomennot, Ohje ja käyttöoikeudet.
Tekoäly: palveluntarjoajat, päätepisteet, mallit, tunnistetiedot ja reaaliaikaiset testit.
Työkalut: luettelon valmius, alustatuki ja käyttöönoton syyt.
Turvallisuus: hyväksyntäsäännöt, Data Send -toiminto, laitteen todennus ja rajattu Memory-käytäntö.
Lisäasetukset: vianmääritykseen tarkoitetut palautus- ja diagnostiikkatoiminnot.

Näppäinoikotiet

macOS:ssä sovellus yhdistää näytetyt Ctrl pikanäppäimet tarvittaessa alustan Command-näppäimeen. Sovelluksen Shortcuts-sivu on ensisijainen lähde ja tukee mukautusta.

Oikotie	Toiminto
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	Kohdista kohdistin kirjoitusalueeseen
`Ctrl` + `Shift` + `Space`	Keskeytä aktiivinen Run tai jatka sitä
`Ctrl` + `.`	Pysäytä aktiivinen Run
`Ctrl` + `1` … `9`	Avaa Chats History-näkymän kautta
`Ctrl` + `,`	Avaa Settings
`F1`	Avaa Help & Privacy
`Esc`	Sulje valintaikkuna tai peruuta nykyinen ei-tuhoava toiminto

Alustakohtaiset huomautukset

Alusta	Tärkeät rajat
macOS	Hiekkalaatikossa Debug- ja Release-versioissa. Tiedostojen käyttö perustuu valittuihin juuriin/tietoturvalaajuisiin kirjanmerkkeihin. Näytön tallennus ja käyttöapu ovat erillisiä järjestelmäoikeuksia. Paikalliset prosessi- ja Shortcut-integraatiot testataan edelleen kyvykkyyksien mukaan.
Windows	Tiedosto-, Office/PDF-/data-, selain-, kehitys-, etä- ja työpöydän hallintaominaisuudet riippuvat asennetusta ajoajasta ja käyttöoikeuksista. Vain Applelle tarkoitetut integraatiot eivät ole käytettävissä, ja syy näytetään.
iPhone / iPad	Tiedostot valitaan järjestelmän valitsimella. Kamera-, mikrofoni-, puhe-, kuva-, lähiverkko- ja ilmoitusoikeuksia pyydetään tilanteen mukaan. Taustavalvontaa ei taata; käytä Shortcuts/App Intents -toimintoja tai etualalla tehtävää kiinniottoa.
Android	Tiedostoissa ja kansioissa käytetään Storage Access Framework -kehystä. Taustatyö noudattaa Android-rajoituksia. Accessibility-toimintoon perustuvaa syötteen hallintaa ei koskaan pidetä myönnettynä vain siksi, että palvelu on määritetty.
Verkko	Käyttää vain istuntokohtaista tallennustilaa ominaisuuksille, jotka edellyttävät natiivia pysyvyyttä, ja poistaa selkeästi käytöstä tukemattomat laite-, tiedostojuuri-, paikallinen prosessi- ja taustaominaisuudet.

Vinkit & niksit

Aloita suppealla Workspace Profilella ja lisää työkalu, yhteys tai tiedostojuuri vasta, kun Run osoittaa siihen olevan erityinen tarve.

Määritä jokaiselle pyynnölle selkeä lopputulos, odotettu Artifact ja tarkastusraja, jotta edistymistä on helppo auditoida.

Käytä Knowledgea uudelleenkäytettäviin indeksoituihin lähteisiin ja Contextia vain nykyisen Runin tarvitsemiin aineistoihin.

Kun ulkoinen vaikutus on epävarma, tarkista kohde ennen uudelleenyritystä; Resume ei koskaan toista sitä automaattisesti.

Vianmääritys

Ongelma	Mitä tarkistaa
Palveluntarjoaja ei voi suorittaa toimintoa	Avaa Settings > AI. Tarkista määritykset, todennus, mallin ominaisuudet, päätepisteen tavoitettavuus, aikakatkaisu ja nopeusrajoitusten tiedot ja suorita sitten yhteystesti.
Työkalu on poistettu käytöstä	Avaa Settings > Tools ja lue reaaliaikainen syy. Tarkista nykyinen alusta, käyttöoikeus, yhteystesti, Workspace Profile ja valittu juuri.
Run näyttää jumittuneen	Avaa Runs ja Timeline. Se voi olla keskeytetty, odottaa syötettä, hyväksyntää, Critical-vahvistusta, Data Send -tarkistusta tai budjettitarkistusta. Pysäytä-toiminto on yhä käytettävissä.
Käyttöoikeus muuttui	Avaa Help > Overview tai Settings ja avaa sitten järjestelmäasetukset. Testaa kyseinen yhteys tai työkalu uudelleen palattuasi.
Ulkoinen toiminto on epävarma	Tarkista kohdejärjestelmä. Pidä Run keskeytettynä tai pysäytä se, ellet ole varmistanut, että uudelleenyritys on asianmukainen.
Automation ei käynnistynyt taustalla	Mobiilikäyttöjärjestelmät eivät takaa mielivaltaista kyselyä. Palaa etualalle kiinniottoa varten tai määritä Shortcut/App Intent tai luotettu tapahtumalähde.
Artifactia ei voi avata tai viedä	Tarkista, ovatko sen tavut edelleen saatavilla, tukeeko alusta toimintoa ja onko valitun kohteen käyttöoikeus edelleen voimassa.

Tietosuoja, käyttöoikeudet ja lisenssit

QuickAgent tallentaa keskustelut, Runit, hyväksynnät, Knowledge-metatiedot, Skillsit ja asetukset paikallisesti. Tunnistetiedot käyttävät alustan suojaamaa tallennustilaa. Sisältö poistuu laitteelta vain määrittämäsi palveluntarjoajan tai yhdistetyn palvelun kautta, ja ulkoisista lähetyksistä näytetään kohdetietoinen esikatselu.

Käyttöoikeuksia pyydetään tilanteen mukaan: tiedostot/kansiot, kuvat, kamera, mikrofoni, puheentunnistus, lähiverkko, ilmoitukset, näytön tallennus sekä käyttöapu/syötteen hallinta ovat toisistaan riippumattomia. Käyttöoikeuden poistaminen tekee kyseisen ominaisuuden käyttökelvottomaksi sen sijaan, että näyttäisi virheellisen onnistumisen.

Avaa Settings > Help & Privacy nykyisen alustan ominaisuustaulukkoon ja Avoimen lähdekoodin lisenssit paketti- ja mukana toimitettujen natiivikomponenttien ilmoituksiin.

Free ja Pro: kaikki agenttiominaisuudet ovat käytettävissä Free-versiossa. Seitsemän päivän kokeilujakso on mainokseton; sen jälkeen mobiilissa voidaan näyttää mainoksia ja työpöytäversiossa päivittäinen muistutus. Pro poistaa nämä viestit vuositilauksella tai elinikäisellä ostoksella.