QuickAgent - Útmutató

QuickAgent felhasználói útmutató

A QuickAgent egy helyi működésre épülő AI-ügynöki munkaterület. A célból tartós Run folyamatot hoz létre, azt Workspace Profile segítségével korlátozza, érzékeny műveletek előtt felülvizsgálatot kér, az ellenőrzött eredményeket pedig Artifacts elemekben őrzi.

Első lépések

Nyissa meg a Beállítások > AI, adjon hozzá szolgáltatót, és futtassa annak kapcsolati tesztjét.
Nyissa meg a Beállítások > Workspace Profiles. Válassza ki, mely szolgáltató, eszközök, kapcsolatok, fájlgyökerek, Knowledge-források és Memory-hatókörök használhatók.
Válassza az Új csevegéslehetőséget, válassza ki a profilt, és erősítse meg a beszélgetés felett megjelenő szolgáltatói célt.
Írja le a kívánt eredményt. Csak az ehhez a Run folyamathoz szükséges fájlokat, mappákat, médiát, Knowledge vagy Memory elemeket adja hozzá.
Megjelenésükkor tekintse át a tervet, a jóváhagyásokat, a Critical megerősítést és a Data Send Preview előnézetet.
Kövesse a munkát a Timeline nézetben. Nyissa meg az elkészült kimenetet az Artifacts részből, az ellenőrzési nyomvonalat pedig a Előzmények.

Tipp: felületen. Kezdjen szűk Workspace Profile profillal. Csak akkor bővítse eszközeit vagy gyökereit, ha a QuickAgent konkrét elérhetetlenségi okot jelez.

A felület áttekintése

Szakasz	Rendeltetés
Csevegések	Beszélgetések, szolgáltatói cél, Context Tray, tervek, jóváhagyások és az aktív Run Timeline.
Futtatások	Minden tervezett, futó, szüneteltetett, ütemezett, sikertelen vagy befejezett feladat.
Jóváhagyási beérkezett üzenetek	Döntésére váró művelet-, Critical- és Data Send-felülvizsgálatok.
Artifacts	A Run folyamatok által létrehozott ellenőrzött fájlok, jelentések, naplók, médiatartalmak, táblázatok és műveleti jegyzékek.
Automatizálások	Ütemezések, figyelők, webhookok, alkalmazásesemények és Shortcut/App Intent eseményindítók.
Skills	Újrahasználható utasítások típusos bemenetekkel, engedélyezett eszközökkel, szükséges kapcsolatokkal, kockázattal és kimenetekkel.
Kapcsolatok	Szolgáltatók, böngészőprofilok, fájl-/VFS-gyökerek, SSH, MCP, HTTP/SaaS, otthoni hidak és értesítési csatornák.
Knowledge	Indexelt mappák, QuickNote-tartalom, webes kivágások, PDF-ek és Office-források.
Előzmények	Csak hozzáfűzhető biztonsági döntések, eszközműveletek, célok és időbélyegek.
Beállítások	Megjelenés, nyelv, AI, eszközök, biztonság, Workspace Profiles, billentyűparancsok, engedélyek, Súgó és Pro.

Szolgáltatók és Workspace Profiles

A QuickAgent használhat System AI-t, ha az operációs rendszer kompatibilis képességet biztosít; helyi szolgáltatókat, például Ollama, LM Studio vagy DeskLLM; LAN- vagy egyéni OpenAI-kompatibilis végpontokat; továbbá beállított felhőszolgáltatókat, például Anthropic vagy Gemini. Az elérhetőséget élő képességteszt határozza meg; a szolgáltató neve önmagában nem jelenti, hogy használatra kész.

A Workspace Profile a Run jogosultsági kerete. Pillanatképet készít a kiválasztott szolgáltatóról/modellről, az engedélyezett eszközökről, kapcsolatokról, fájlgyökerekről, Knowledge-forrásokról, Memory-hatókörökről, biztonsági felülbírálásokról és költségkeretről. Egy későbbi beállításmódosítás elavulttá teszi a pillanatképet, és felülvizsgálatot igényel.

Célszabály: A QuickAgent soha nem vált észrevétlenül eszközön futó vagy helyi szolgáltatóról felhőre. Az aktív cél mindig látható a Csevegésben és minden Data Send-felülvizsgálatban.

Futtatások, jóváhagyások és helyreállítás

Run vezérlők

Szüneteltetés együttműködő leállítást kér egy tartós ellenőrzési pontnál.
Folytatás ugyanazt a Run folyamatot és az elkészült munkát folytatja.
Leállítás megszakítja a szolgáltatói és eszközműveleteket. A leállított vagy bizonytalan külső hatás nem jelenik meg sikerként.
Újrapróbálkozás csak akkor érhető el, ha a QuickAgent biztonságos újrapróbálkozási határt tud azonosítani.

Biztonsági szintek

Szint	Jelentés
Biztonságos	Olvasás, vizsgálat vagy átalakítás az aktív profilon belül.
Jóváhagyás	Normál írási vagy külső művelet felülvizsgálata.
Ellenőrizze, hogy a	Nagyobb hatású vagy nehezebben visszafordítható módosítás felülvizsgálata.
Kritikus	Minden alkalommal erős megerősítést igényel; szabályok soha nem hagyják jóvá automatikusan.

A jóváhagyás megmutatja a pontos célt, rendeltetési helyet, javasolt argumentumokat, kockázatot és a Visszavonás állapotát. Egy argumentum szerkesztésekor a QuickAgent ismét ellenőrzi és kockázatértékeli a módosított műveletet.

Bizonytalan eredmény: megszakítás után először ellenőrizze a célrendszert. Csak akkor válassza az „Ellenőriztem — újrapróbálkozás” lehetőséget, ha a művelet megismétlése megfelelő. A „Folytatás” önmagában soha nem ismétel meg bizonytalan külső hatást.

Többügynökös futtatások

Az összetett célok tervezőt, típusos szakértői végrehajtókat, felülvizsgálót és biztonsági felülvizsgálót használhatnak. A Timeline minden átadást, felülvizsgálatot, újrapróbálkozást, tartalék megoldást és végsőválasz-határt megjelenít. A végrehajtók csak a Skill eszközei, a Workspace Profile eszközei, a szerepkör eszközei és az aktuálisan élő eszközök négyes metszetét kapják meg.

A globális és szerepkörönkénti keretek korlátozzák a hívások számát, az időt, a költséget, a hálózati bájtokat és a tokeneket. A keret elérésekor a QuickAgent szünetel. Megjeleníti az aktuális és javasolt korlátokat, és csak kifejezett felülvizsgálat után növeli őket. A jóváhagyott keret és a befejezett szerepkörelőzmény újraindítás után is megmarad.

Környezet, Knowledge és AI Memory

Context Tray

Adjon hozzá fájlokat, mappákat, képeket, videóképkockákat, hangot, hangjegyzeteket, QuickNote-tartalmat, Knowledge vagy Workspace Memory elemeket. A QuickAgent kinyeri vagy összefoglalja a támogatott tartalmat, és jelzi, ha egy mellékletet közvetlenül elküld a szolgáltatónak.

Knowledge

A Knowledge-források indexelése a csevegéstől elkülönül. Egy Run csak a Workspace Profile által engedélyezett forrásokban kereshet, az idézetek pedig megőrzik forrásazonosságukat.

Memory

A Memory tudatosan kezelt adat, nem automatikus csevegési előzmény. A Felhasználó, Workspace, Projekt és Eszköz/Kapcsolat hatóköre elkülönül. Minden létrehozási, szerkesztési vagy törlési kérés új jóváhagyást kap, amelynek előnézete megmutatja a hatókört és a pontos javasolt értéket.

Eszközök és kapcsolatok

Az élő katalógus lefedi a fájl-/VFS-műveleteket; Office-, PDF- és strukturált adatokat; médiát és OCR-t; böngésző- és számítógép-használatot; fejlesztési parancsokat; SSH-t; MCP-t; HTTP- és SaaS-szolgáltatásokat; okosotthon-hidakat; értesítéseket; ütemezéseket; figyelőket és automatizálásvezérlést. A csatlakoztatott MCP-kiszolgálók sémaellenőrzés és QuickAgent-kockázatértékelés után dinamikus eszközöket adhatnak hozzá.

Beállítások > Eszközök megmutatja, miért használható vagy letiltott egy eszköz. Gyakori ok a hiányzó kapcsolat, operációsrendszer-engedély, nem támogatott platform, Workspace Profile-korlátozás, nem tesztelt végpont vagy nem elérhető szolgáltatói képesség.

Számítógép-használat: a képernyőrögzítés és az akadálymentesítési/beviteli vezérlés külön engedélyek. Tartsa láthatóan az előnézetet és elérhetően a vészleállítást. A mobilplatformok nem biztosítanak ugyanilyen korlátlan asztali vezérlést.

Automatizálások

Az automatizálás idő-, fájl-/mappa-, web-, webhook-, e-mail-, naptár-, hálózat-, gép-, eszköz-, érzékelő-, hely-, alkalmazásesemény-, Shortcut/App Intent-, parancs- vagy kézi eseményindítóval indulhat, ha a platform támogatja. Egy eseményindító közönséges Run folyamatot hoz létre; nem kerüli meg a Workspace Profile, jóváhagyás, Critical vagy Data Send ellenőrzéseit.

Az asztali figyelés csak addig folytatódik, amíg az alkalmazás folyamata fut.
A mobilplatformok az alkalmazás előtérbe kerülésekor pótolják az esedékessé vált munkát.
Használjon Shortcut/App Intent eseményindítót vagy megbízható eseménytovábbítót, ha operációsrendszer-szintű kézbesítés szükséges.
A sorba állított események, a szüneteltetés, a megszakítás és a törlés egyértelmű marad, így az események nem vesznek el észrevétlenül.

Skills és Skill Packs

Egy Skill eredményközpontú utasítást, típusos változókat, szolgáltatói ajánlást, engedélyezett eszközöket, szükséges kapcsolatokat és képességeket, maximális kockázatot és elvárt Artifacts elemeket tárol. Használat előtt a QuickAgent megmutatja a bemeneteket és tényleges jogosultságokat; az előnézet önmagában nem ad engedélyt.

Hét beépített Pack biztosít valódi Skills elemeket az Office, Coding, Smart Home, Research, Browser Automation, Personal Admin és Incident Response területéhez. A Skills telepíthető, frissíthető, eltávolítható, testreszabható, másolható, importálható és exportálható. Az importált JSON esetén megjelenik a megbízhatóság, kiadó, aláírás, jogosultság, kockázat, platform és ütközés előnézete. A „Mindkettő megtartása” aláíratlan helyi változatot hoz létre a másik kiadó megbízhatóságának öröklése helyett.

Artifacts, előzmények és visszavonás

Az Artifacts megőrzi a kimeneti bájtokat, metaadatokat, verziókat, eredetet, forrás-Run adatot és műveleti jegyzékeket. A platform képességeitől függően megnyithatja, megoszthatja, exportálhatja vagy megjelenítheti őket. Az alkalmas műveletek ellenőrzött Visszavonást kínálnak; a romboló vagy bizonytalan munka soha nem ismétlődik meg automatikusan.

Az előzmények csak hozzáfűzhetők. Szűrje Biztonságos, Jóváhagyás, Megerősítés vagy Kritikus szerint, és exportálja az ellenőrzési naplót, ha külső nyilvántartásra van szüksége.

Beállítások

Általános: megjelenés, nyelv, Workspace Profiles, billentyűparancsok, Súgó és engedélyek.
AI: szolgáltatók, végpontok, modellek, hitelesítő adatok és élő tesztek.
Eszközök: katalógus készenléte, platformtámogatás és beállítási indokok.
Biztonság: jóváhagyási szabályok, Data Send-működés, eszközhitelesítés és hatókörhöz kötött Memory-szabályzat.
Speciális: hibaelhárításra szolgáló helyreállítás és diagnosztika.

Billentyűparancsok

macOS rendszeren az alkalmazás a megjelenített Ctrl billentyűparancsokat adott esetben a platform Command billentyűjéhez rendeli. Az alkalmazáson belüli Billentyűparancsok oldal az irányadó, és támogatja a testreszabást.

Billentyűparancs	Művelet
`Ctrl` + `N`	Új csevegés
`Ctrl` + `L`	Fókusz a szerkesztőmezőre
`Ctrl` + `Shift` + `Space`	Az aktív Run szüneteltetése vagy folytatása
`Ctrl` + `.`	Az aktív Run leállítása
`Ctrl` + `1` … `9`	Csevegések megnyitása az Előzményeken keresztül
`Ctrl` + `,`	Beállítások megnyitása
`F1`	Súgó & adatvédelem megnyitása
`Esc`	Párbeszédablak bezárása vagy az aktuális, nem romboló művelet megszakítása

Platformmegjegyzések

Platform	Fontos korlátok
macOS	Debug és Release módban is homokozóban fut. A fájlhozzáférés kiválasztott gyökereket/biztonsági hatókörű könyvjelzőket használ. A Screen Recording és Accessibility külön rendszerengedély. A helyi folyamatok és Shortcut-integrációk képességteszthez kötöttek.
Windows	A fájl-, Office/PDF/adat-, böngésző-, fejlesztési, távoli és asztalivezérlési funkciók a telepített futtatókörnyezettől és engedélyektől függnek. A kizárólag Apple-platformon működő integrációk látható indoklással nem érhetők el.
iPhone / iPad	A fájlok a rendszer fájlválasztóját használják. A kamera, mikrofon, beszédfelismerés, fényképek, helyi hálózat és értesítések engedélyét a megfelelő helyzetben kéri az alkalmazás. A háttérfigyelés nem garantált; használjon Shortcuts/App Intents eseményt vagy előtérbe kerüléskori pótlást.
Android	A fájlok és mappák a Storage Access Framework keretrendszert használják. A háttérmunka az Android korlátozásait követi. Az akadálymentesítésen alapuló beviteli vezérlés pusztán egy szolgáltatás deklarálásától még nem számít engedélyezettnek.
Web	A natív állandó tárolást igénylő funkciókhoz csak munkamenet-alapú tárolást használ, és egyértelműen letiltja a nem támogatott eszköz-, fájlgyökér-, helyifolyamat- és háttérképességeket.

Tippek & trükkök

Kezdjen szűk Workspace Profile profillal, és csak akkor adjon hozzá eszközt, kapcsolatot vagy fájlgyökeret, ha a Run konkrét követelményt jelez.

Minden kéréshez adjon egyértelmű eredményt, elvárt Artifact elemet és felülvizsgálati határt, hogy az előrehaladás könnyen ellenőrizhető maradjon.

Újrahasználható, indexelt forrásokhoz használja a Knowledge elemeket, a csak az aktuális Run folyamathoz szükséges anyagokhoz pedig a Context elemeket.

Ha egy külső hatás bizonytalan, újrapróbálkozás előtt ellenőrizze a célt; a Folytatás soha nem ismétli meg automatikusan.

Hibaelhárítás

Probléma	Ellenőrizendő
A szolgáltató nem futtatható	Nyissa meg a Beállítások > AI oldalt. Ellenőrizze a beállítást, a hitelesítést, a modell képességeit, a végpont elérhetőségét, az időtúllépést és a sebességkorlát részleteit, majd futtassa a kapcsolati tesztet.
Egy eszköz le van tiltva	Nyissa meg a Beállítások > Eszközök oldalt, és olvassa el az élő indokot. Ellenőrizze az aktuális platformot, engedélyt, kapcsolati tesztet, Workspace Profile profilt és kiválasztott gyökeret.
Egy Run elakadtnak tűnik	Nyissa meg a Futtatások és a Timeline nézetet. Lehet, hogy szünetel, bevitelre, jóváhagyásra, Critical megerősítésre, Data Send- vagy költségkeret-felülvizsgálatra vár. A Leállítás továbbra is elérhető.
Egy engedély megváltozott	Nyissa meg a Súgó > Áttekintés oldalt vagy a Beállításokat, majd a rendszerbeállításokat. Visszatérés után tesztelje újra az érintett kapcsolatot vagy eszközt.
Egy külső művelet eredménye bizonytalan	Ellenőrizze a célrendszert. Tartsa szüneteltetve vagy állítsa le a Run folyamatot, amíg meg nem győződik arról, hogy az újrapróbálkozás megfelelő.
Egy automatizálás nem indult el a háttérben	A mobil operációs rendszerek nem garantálják a tetszőleges lekérdezést. Pótláshoz térjen vissza az előtérbe, vagy állítson be Shortcut/App Intent eseményt vagy megbízható eseményforrást.
Egy Artifact nem nyitható meg vagy exportálható	Ellenőrizze, hogy a bájtjai még elérhetők-e, a platform támogatja-e a műveletet, és érvényes-e még a kiválasztott cél engedélye.

Adatvédelem, engedélyek és licencek

A QuickAgent helyben tárolja a beszélgetéseket, Runs folyamatokat, jóváhagyásokat, Knowledge-metaadatokat, Skills elemeket és beállításokat. A hitelesítő adatok a platform által védett tárolót használják. Tartalom csak az Ön által beállított szolgáltatón vagy csatlakoztatott szolgáltatáson keresztül hagyja el az eszközt, és a külső küldések céltudatos előnézetet kapnak.

Az engedélyeket a megfelelő helyzetben kéri az alkalmazás: a fájlok/mappák, fényképek, kamera, mikrofon, beszédfelismerés, helyi hálózat, értesítések, képernyőrögzítés és akadálymentesítési/beviteli vezérlés egymástól független. Egy engedély eltávolítása elérhetetlenné teszi az érintett képességet, nem eredményez hamis sikert.

Nyissa meg a Beállítások > Súgó & adatvédelem az aktuális platform képességtáblázatához, valamint Nyílt forráskódú licencek a csomagok és beépített natív összetevők közleményeihez.

Ingyenes és Pro: minden ügynökfunkció elérhető marad az Ingyenes csomagban. A hétnapos próbaidőszak reklámmentes; utána mobilon hirdetések, asztali gépen napi emlékeztető jelenhet meg. A Pro éves előfizetéssel vagy élethosszig tartó vásárlással eltávolítja ezeket az üzeneteket.