Používateľská príručka QuickAgent
QuickAgent je pracovné prostredí AI agentú s lokálnom zpracováním. Premení cieľ na trvalý beh, omezí ho profilem pracovného priestoru, pred citlivými akcemi požádá o kontrolu a overené výsledky uchová v artefaktech.
Začíname
- Otvorte Nastavenia > AI, pridajte poskytovateľa a spusťte test pripojenie.
- Otvorte Nastavenia > Profily pracovného priestoru. Zvoľte, ktoré poskytovateľa, nástroje, pripojenie, koreňové priečinky súborov, zdroje znalostí a rozsahy pamäti možno používať.
- Vyberte Nový chat, zvoľte profil a potvrďte cílového poskytovateľa zobrazeného nad konverzací.
- Popište požadovaný výsledok. Pridajte iba súbory, priečinky, média, znalosti alebo pameť potrebné pre tento beh.
- Skontrolujte plán, schválenie, kritické potvrdenie a náhled odesílaných údajov, hneď ako sa zobrazí.
- Sledujte práci na časové ose. Dokončený výstup otvorte v Artefaktech a auditní stopu prohlédnete v História.
Prehľad rozhrania
| Oddíl | K čemu slouží |
|---|---|
| Chaty | Konverzace, cílový poskytovateľ, panel kontextu, plány, schválenie a časová osa aktivního prevádzky. |
| Behy | Všetky plánované, spuštené, pozastavené, naplánované, neúspešné alebo dokončené úlohy. |
| Schránka schválenie | Čekající kontroly akcí, kritických potvrdenie a odesílání údajov, ktoré vyžadují vaše rozhodnutí. |
| Artefaktech | Overené súbory, zprávy, protokoly, média, tabulky a manifesty operací vytvorené behy. |
| Automatizace | Plány, monitory, webhooky, události aplikácií a spoušteče Shortcut/App Intent. |
| Dovednosti | Opakovane použitelné pokyny s typovanými vstupy, povolenými nástroji, požadovanými pripojeními, riziky a výstupy. |
| Pripojení | Poskytovatelia, profily prohlížeče, koreňové priečinky súborov/VFS, SSH, MCP, HTTP/SaaS, domácí mosty a oznamovací kanály. |
| Znalosti | Indexované priečinky, obsah QuickNote, webové výstrižky, PDF a zdroje Office. |
| História | Nemenný záznam bezpečnostních rozhodnutí, akcí nástrojov, cílú a časových razítek. |
| Nastavenia | Vzhled, jazyk, AI, nástroje, bezpečnost, profily pracovného priestoru, zkratky, oprávnenia, nápoveda a Pre. |
Poskytovatelia a profily pracovného priestoru
QuickAgent môže používať System AI, ak operační systém nabízí kompatibilný funkci, lokálny poskytovateľa ako Ollama, LM Studio alebo DeskLLM, sieťové či vlastné koncové body kompatibilný s OpenAI a nakonfigurované cloudové poskytovateľa ako Anthropic alebo Gemini. Dostupnost určuje živý test funkcií; samotný název poskytovateľa neznamená, že je pripraven.
Profil pracovného priestoru je obálka oprávnenia prevádzky. Zachycuje vybraného poskytovateľa/model, povolené nástroje, pripojenie, koreňové priečinky súborov, zdroje znalostí, rozsahy pamäti, bezpečnostné výjimky a rozpočet. Pozdejší zmena konfigurácia zpúsobí zastarání snímky a vyžaduje kontrolu.
Behy, schválenie a obnovenie
Ovládání prevádzky
- Pozastavit požádá o koordinované zastavenie v trvalém kontrolním bode.
- Pokračovat pokračuje vo rovnakom prevádzky a dokončené práci.
- Zastaviť zruší práci poskytovateľa a nástrojov. Zastavený alebo nejistý externé účinek sa nehlásí ako úspech.
- Opakovat je dostupné len vtedy, keď QuickAgent dokáže určit bezpečnou hranici opakovanie.
Úrovne bezpečnosti
| Úroveň | Význam |
|---|---|
| Bezpečné | Čtení, kontrola alebo transformace v rámci aktivního profilu. |
| Schválit | Kontrola bežného zápisu alebo externé akce. |
| Skontrolujte, či je | Kontrola akce s vyšším dopadem alebo obtížnejším vrácením. |
| Kritické | Pokaždé vyžaduje dúrazné potvrdenie; pravidla je nikdy neschválí automaticky. |
Schválení zobrazuje presný cieľ, umiestnenie, navrhované argumenty, riziko a stav vrátenie. Ak argument upravíte, QuickAgent upravenou akci znova overí a posoudí jej riziko.
Behy s viac agenty
Složité cíle môžu využívat plánovač, typované specializované pracovníky, recenzenta a bezpečnostního recenzenta. Časová osa zobrazuje každé predání, kontrolu, opakovanie, náhradní postup a hranici konečné odpovede. Pracovníci obdrží iba prúnik nástrojov dovednosti, profilu pracovného priestoru, role a aktuálne dostupných nástrojov.
Globální rozpočty a rozpočty jednotlivých rolí omezují počet volanie, čas, náklady, sieťové bajty a tokeny. Po dosažení rozpočtu sa QuickAgent pozastaví. Zobrazí aktuálny a navrhované limity a zvýší je len po výslovné kontrole. Schválený rozpočet a história dokončených rolí pretrvají restart.
Kontext, znalosti a pameť AI
Panel kontextu
Pridajte súbory, priečinky, obrázky, snímky videa, zvuk, hlasové poznámky, obsah QuickNote, Knowledge alebo Workspace Memory. QuickAgent extrahuje alebo zhrnie podporovaný obsah a ukáže, či sa príloha odošle priamo poskytovateľovi.
Znalosti
Zdroje Knowledge sa indexujú oddelene od chatu. Run môže prehľadávať iba zdroje povolené v jeho Workspace Profile a citácie si zachovávajú identitu zdroja.
Pamäť
Memory je zámerná, nejde o automatickú históriu chatu. Rozsahy User, Workspace, Project a Tool/Connection sú oddelené. Každá žiadosť o vytvorenie, úpravu alebo odstránenie vyžaduje nové schválenie a jeho náhľad zobrazuje rozsah aj presnú navrhovanú hodnotu.
Nástroje a pripojenia
Aktuálny katalóg zahŕňa operácie so súbormi/VFS; Office, PDF a štruktúrované údaje; médiá a OCR; používanie prehliadača a počítača; vývojárske príkazy; SSH; MCP; HTTP a SaaS; mosty inteligentnej domácnosti; oznámenia; plány; monitory a riadenie automatizácie. Pripojené servery MCP môžu po overení schémy a opätovnom posúdení rizika aplikáciou QuickAgent pridať dynamické nástroje.
Nastavenia > Nástroje ukazuje, prečo je nástroj pripravený alebo zakázaný. Bežnými dôvodmi sú chýbajúce pripojenie, povolenie operačného systému, nepodporovaná platforma, obmedzenie Workspace Profile, neotestovaný koncový bod alebo nedostupná funkcia poskytovateľa.
Automatizace
Automations sa môžu spustiť časom, súborom/priečinkom, webom, webhookom, e-mailom, kalendárom, sieťou, hostiteľom, zariadením, senzorom, polohou, udalosťou aplikácie, Shortcut/App Intent, príkazom alebo manuálnym spúšťačom, ak ich platforma podporuje. Spúšťač vytvorí bežný Run; neobchádza kontroly Workspace Profile, schválenia, Critical ani Data Send.
- Monitorovanie počítača pokračuje iba počas behu procesu aplikácie.
- Mobilné platformy obnovia oneskorenú prácu po návrate aplikácie do popredia.
- Ak sa vyžaduje doručenie operačným systémom, použite Shortcut/App Intent alebo dôveryhodné odovzdávanie udalostí.
- Udalosti vo fronte, pozastavenie, zrušenie a odstránenie zostávajú explicitné, aby sa udalosti potichu nezahadzovali.
Skills a Skill Packs
Skill uchováva výzvu zameranú na výsledok, typované premenné, odporúčanie poskytovateľa, povolené nástroje, požadované pripojenia a možnosti, maximálne riziko a očakávané artefakty. QuickAgent pred použitím zobrazí vstupy a účinné povolenia; samotný náhľad povolenie neudeľuje.
Sedem vstavaných Packs poskytuje skutočné Skills pre Office, Coding, Smart Home, Research, Browser Automation, Personal Admin a Incident Response. Skills môžete inštalovať, aktualizovať, odinštalovať, prispôsobovať, duplikovať, importovať a exportovať. Importovaný JSON zobrazí náhľad dôveryhodnosti, vydavateľa, podpisu, povolení, rizika, platformy a konfliktov. „Ponechať oboje“ vytvorí nepodpísaný lokálny derivát namiesto prevzatia dôveryhodnosti iného vydavateľa.
Artefakty, história a vrátenie zmien
Artefakty uchovávajú výstupné bajty, metaúdaje, verzie, pôvod, zdrojové spustenie a manifesty operácií. Podľa možností platformy ich môžete otvoriť, zdieľať, exportovať alebo zobraziť v priečinku. Vhodné operácie ponúkajú skontrolované vrátenie zmien; deštruktívna alebo neistá práca sa nikdy automaticky neopakuje.
História umožňuje iba pridávanie záznamov. Filtrujte ju podľa Safe, Approve, Confirm alebo Critical a v prípade potreby externého záznamu exportujte audit.
Nastavenia
- Všeobecné: vzhľad, jazyk, Workspace Profiles, skratky, pomoc a povolenia.
- AI: poskytovatelia, koncové body, modely, prihlasovacie údaje a živé testy.
- Nástroje: pripravenosť katalógu, podpora platformy a dôvody nastavenia.
- Bezpečnosť: pravidlá schvaľovania, správanie Data Send, overovanie zariadenia a zásady Memory s obmedzeným rozsahom.
- Rozšírené: obnova a diagnostika určené na riešenie problémov.
Klávesové skratky
V systéme macOS aplikácia mapuje zobrazené skratky Ctrl na kláves Command platformy, kde je to vhodné. Rozhodujúca je prispôsobiteľná stránka Skratky v aplikácii.
| Skratka | Akcia |
|---|---|
| Ctrl + N | Nový chat |
| Ctrl + L | Zamerať editor správy |
| Ctrl + Shift + Space | Pozastaviť alebo obnoviť aktívny Run |
| Ctrl + . | Zastaviť aktívny Run |
| Ctrl + 1 … 9 | Otvoriť Rozhovory cez Históriu |
| Ctrl + , | Otvoriť Nastavenia |
| F1 | Otvoriť Pomoc & súkromie |
| Esc | Zavrieť dialógové okno alebo zrušiť aktuálnu nedeštruktívnu interakciu |
Poznámky k platformám
| Platforma | Dôležité obmedzenia |
|---|---|
| macOS | V režimoch Debug aj Release je aplikácia izolovaná v sandboxe. Prístup k súborom používa vybrané koreňové priečinky/záložky s obmedzeným rozsahom zabezpečenia. Screen Recording a Accessibility sú samostatné systémové povolenia. Integrácie lokálnych procesov a Shortcut sa naďalej testujú podľa schopností. |
| Windows | Funkcie pre súbory, Office/PDF/údaje, prehliadač, vývoj, vzdialený prístup a ovládanie počítača závisia od nainštalovaného prostredia a povolení. Integrácie určené iba pre Apple nie sú dostupné a zobrazí sa dôvod. |
| iPhone / iPad | Súbory používajú systémový výber. Povolenia pre kameru, mikrofón, reč, fotografie, lokálnu sieť a oznámenia sa vyžadujú podľa kontextu. Monitorovanie na pozadí nie je zaručené; použite Shortcuts/App Intents alebo dobehnutie po návrate do popredia. |
| Android | Súbory a priečinky používajú Storage Access Framework. Práca na pozadí podlieha obmedzeniam systému Android. Ovládanie vstupu prostredníctvom prístupnosti sa nikdy nepovažuje za povolené iba preto, že je služba deklarovaná. |
| Web | Pre funkcie vyžadujúce natívne trvalé úložisko používa iba úložisko relácie a zreteľne zakáže nepodporované funkcie zariadenia, koreňových priečinkov, lokálnych procesov a práce na pozadí. |
Tipy & triky
Riešenie problémov
| Problém | Čo skontrolovať |
|---|---|
| Poskytovateľa nemožno spustiť | Otvorte Nastavenia > AI. Skontrolujte konfiguráciu, overenie, možnosti modelu, dostupnosť koncového bodu, časový limit a podrobnosti limitu požiadaviek a potom spustite test pripojenia. |
| Nástroj je zakázaný | Otvorte Nastavenia > Nástroje a prečítajte si aktuálny dôvod. Skontrolujte súčasnú platformu, povolenie, test pripojenia, Workspace Profile a vybraný koreňový priečinok. |
| Run zrejme nereaguje | Otvorte Spustenia a Časovú os. Spustenie môže byť pozastavené alebo čakať na vstup, schválenie, potvrdenie Critical, kontrolu Data Send či rozpočtu. Možnosť Zastaviť zostáva dostupná. |
| Povolenie sa zmenilo | Otvorte Pomoc > Prehľad alebo Nastavenia a potom systémové nastavenia. Po návrate znova otestujte príslušné pripojenie alebo nástroj. |
| Externá akcia má neistý výsledok | Skontrolujte cieľový systém. Ponechajte Run pozastavený alebo ho zastavte pomocou Stop, kým neoveríte, že je vhodné akciu zopakovať. |
| Automation sa nespustila na pozadí | Mobilné operačné systémy nezaručujú ľubovoľné pravidelné zisťovanie. Vráťte sa do popredia, aby sa práca dobehla, alebo nakonfigurujte Shortcut/App Intent či dôveryhodný zdroj udalostí. |
| Artifact nemožno otvoriť ani exportovať | Skontrolujte, či sú jeho bajty stále dostupné, či platforma podporuje danú akciu a či je povolenie vybraného cieľa stále platné. |
Súkromie, povolenia a licencie
QuickAgent ukladá konverzácie, Runs, schválenia, metaúdaje Knowledge, Skills a nastavenia lokálne. Prihlasovacie údaje používajú úložisko chránené platformou. Obsah opúšťa zariadenie iba prostredníctvom nakonfigurovaného poskytovateľa alebo pripojenej služby a externé odoslania zobrazia náhľad zohľadňujúci cieľ.
Povolenia sa vyžadujú podľa kontextu: súbory/priečinky, fotografie, kamera, mikrofón, rozpoznávanie reči, lokálna sieť, oznámenia, nahrávanie obrazovky a ovládanie prístupnosti/vstupu sú nezávislé. Odobratie povolenia príslušnú funkciu zneprístupní namiesto predstierania úspechu.
Otvorte Nastavenia > Pomoc & súkromie obsahuje tabuľku schopností aktuálnej platformy a Licencie softvéru s otvoreným zdrojovým kódom obsahujú upozornenia k balíkom a pribaleným natívnym komponentom.