Uživatelská příručka QuickAgent
QuickAgent je pracovní prostředí AI agentů s místním zpracováním. Přemění cíl na trvalý běh, omezí jej profilem pracovního prostoru, před citlivými akcemi požádá o kontrolu a ověřené výsledky uchová v artefaktech.
Začínáme
- Otevřete Nastavení > AI, přidejte poskytovatele a spusťte test připojení.
- Otevřete Nastavení > Profily pracovního prostoru. Zvolte, které poskytovatele, nástroje, připojení, kořenové složky souborů, zdroje znalostí a rozsahy paměti lze používat.
- Vyberte Nový chat, zvolte profil a potvrďte cílového poskytovatele zobrazeného nad konverzací.
- Popište požadovaný výsledek. Přidejte pouze soubory, složky, média, znalosti nebo paměť potřebné pro tento běh.
- Zkontrolujte plán, schválení, kritické potvrzení a náhled odesílaných dat, jakmile se zobrazí.
- Sledujte práci na časové ose. Dokončený výstup otevřete v Artefaktech a auditní stopu prohlédněte v Historie.
Přehled rozhraní
| Oddíl | K čemu slouží |
|---|---|
| Chaty | Konverzace, cílový poskytovatel, panel kontextu, plány, schválení a časová osa aktivního běhu. |
| Běhy | Všechny plánované, spuštěné, pozastavené, naplánované, neúspěšné nebo dokončené úlohy. |
| Schránka schválení | Čekající kontroly akcí, kritických potvrzení a odesílání dat, které vyžadují vaše rozhodnutí. |
| Artefaktech | Ověřené soubory, zprávy, protokoly, média, tabulky a manifesty operací vytvořené běhy. |
| Automatizace | Plány, monitory, webhooky, události aplikací a spouštěče Shortcut/App Intent. |
| Dovednosti | Opakovaně použitelné pokyny s typovanými vstupy, povolenými nástroji, požadovanými připojeními, riziky a výstupy. |
| Připojení | Poskytovatelé, profily prohlížeče, kořenové složky souborů/VFS, SSH, MCP, HTTP/SaaS, domácí mosty a oznamovací kanály. |
| Znalosti | Indexované složky, obsah QuickNote, webové výstřižky, PDF a zdroje Office. |
| Historie | Neměnný záznam bezpečnostních rozhodnutí, akcí nástrojů, cílů a časových razítek. |
| Nastavení | Vzhled, jazyk, AI, nástroje, bezpečnost, profily pracovního prostoru, zkratky, oprávnění, nápověda a Pro. |
Poskytovatelé a profily pracovního prostoru
QuickAgent může používat System AI, pokud operační systém nabízí kompatibilní funkci, místní poskytovatele jako Ollama, LM Studio nebo DeskLLM, síťové či vlastní koncové body kompatibilní s OpenAI a nakonfigurované cloudové poskytovatele jako Anthropic nebo Gemini. Dostupnost určuje živý test funkcí; samotný název poskytovatele neznamená, že je připraven.
Profil pracovního prostoru je obálka oprávnění běhu. Zachycuje vybraného poskytovatele/model, povolené nástroje, připojení, kořenové složky souborů, zdroje znalostí, rozsahy paměti, bezpečnostní výjimky a rozpočet. Pozdější změna konfigurace způsobí zastarání snímku a vyžaduje kontrolu.
Běhy, schválení a obnovení
Ovládání běhu
- Pozastavit požádá o koordinované zastavení v trvalém kontrolním bodě.
- Pokračovat pokračuje ve stejném běhu a dokončené práci.
- Zastavit zruší práci poskytovatele a nástrojů. Zastavený nebo nejistý externí účinek se nehlásí jako úspěch.
- Opakovat je dostupné jen tehdy, když QuickAgent dokáže určit bezpečnou hranici opakování.
Úrovně bezpečnosti
| Úroveň | Význam |
|---|---|
| Bezpečné | Čtení, kontrola nebo transformace v rámci aktivního profilu. |
| Schválit | Kontrola běžného zápisu nebo externí akce. |
| Ověřte, že je zapnuto | Kontrola akce s vyšším dopadem nebo obtížnějším vrácením. |
| Kritické | Pokaždé vyžaduje důrazné potvrzení; pravidla je nikdy neschválí automaticky. |
Schválení zobrazuje přesný cíl, umístění, navrhované argumenty, riziko a stav vrácení. Pokud argument upravíte, QuickAgent upravenou akci znovu ověří a posoudí její riziko.
Běhy s více agenty
Složité cíle mohou využívat plánovač, typované specializované pracovníky, recenzenta a bezpečnostního recenzenta. Časová osa zobrazuje každé předání, kontrolu, opakování, náhradní postup a hranici konečné odpovědi. Pracovníci obdrží pouze průnik nástrojů dovednosti, profilu pracovního prostoru, role a aktuálně dostupných nástrojů.
Globální rozpočty a rozpočty jednotlivých rolí omezují počet volání, čas, náklady, síťové bajty a tokeny. Po dosažení rozpočtu se QuickAgent pozastaví. Zobrazí aktuální a navrhované limity a zvýší je jen po výslovné kontrole. Schválený rozpočet a historie dokončených rolí přetrvají restart.
Kontext, znalosti a paměť AI
Panel kontextu
Přidejte soubory, složky, obrázky, snímky videa, zvuk, hlasové poznámky, obsah QuickNote, znalosti nebo paměť pracovního prostoru. QuickAgent podporovaný obsah extrahuje nebo shrne a ukáže, zda bude příloha odeslána přímo poskytovateli.
Znalosti
Zdroje znalostí se indexují odděleně od chatu. Běh může vyhledávat pouze ve zdrojích povolených jeho profilem pracovního prostoru a citace si zachovávají identitu zdroje.
Paměť
Paměť je záměrná, nejde o automatickou historii chatu. Rozsahy uživatele, pracovního prostoru, projektu a nástroje/připojení jsou oddělené. Každý požadavek na vytvoření, úpravu nebo odstranění vyžaduje nové schválení a jeho náhled zobrazuje rozsah i přesnou navrhovanou hodnotu.
Nástroje a připojení
Aktuální katalog zahrnuje operace se soubory/VFS; Office, PDF a strukturovaná data; média a OCR; prohlížeč a ovládání počítače; vývojové příkazy; SSH; MCP; HTTP a SaaS; mosty chytré domácnosti; oznámení; plány; monitory a řízení automatizace. Připojené servery MCP mohou po ověření schématu a novém posouzení rizik QuickAgent přidávat dynamické nástroje.
Nastavení > Nástroje ukazuje, proč je nástroj připraven nebo zakázán. Obvyklými důvody jsou chybějící připojení, oprávnění operačního systému, nepodporovaná platforma, omezení profilu pracovního prostoru, neotestovaný koncový bod nebo nedostupná funkce poskytovatele.
Automatizace
Automatizace lze spouštět časem, souborem/složkou, webem, webhookem, e-mailem, kalendářem, sítí, hostitelem, zařízením, senzorem, polohou, událostí aplikace, Shortcut/App Intent, příkazem nebo ručně, pokud to platforma podporuje. Spouštěč vytvoří běžný běh; neobchází profil pracovního prostoru ani kontroly schválení, kritického potvrzení či odesílání dat.
- Monitorování na počítači pokračuje pouze tehdy, když je proces aplikace spuštěný.
- Mobilní platformy obnoví zpožděnou práci, když se aplikace vrátí do popředí.
- Pokud je vyžadováno doručení operačním systémem, použijte Shortcut/App Intent nebo důvěryhodné předávání událostí.
- Události ve frontě, pozastavení, zrušení a odstranění zůstávají výslovné, aby se události bez upozornění nezahodily.
Dovednosti a balíčky dovedností
Dovednost ukládá pokyn zaměřený na výsledek, typované proměnné, doporučení poskytovatele, povolené nástroje, požadovaná připojení a funkce, maximální riziko a očekávané artefakty. Před použitím QuickAgent zobrazí vstupy a účinná oprávnění; samotný náhled oprávnění neuděluje.
Sedm vestavěných balíčků poskytuje skutečné dovednosti pro Office, programování, chytrou domácnost, výzkum, automatizaci prohlížeče, osobní administrativu a reakci na incidenty. Dovednosti můžete instalovat, aktualizovat, odinstalovat, přizpůsobit, duplikovat, importovat a exportovat. Importovaný JSON obdrží náhled důvěry, vydavatele, podpisu, oprávnění, rizika, platformy a konfliktů. „Ponechat obojí“ vytvoří nepodepsaný místní odvozený objekt, namísto aby převzal důvěru jiného vydavatele.
Artefakty, historie a vrácení
Artefakty uchovávají výstupní bajty, metadata, verze, původ, zdrojový běh a manifesty operací. Podle možností platformy je můžete otevřít, sdílet, exportovat nebo zobrazit v umístění. Způsobilé operace nabízejí kontrolované vrácení; destruktivní nebo nejistá práce se nikdy automaticky neopakuje.
Historie je neměnná. Filtrujte ji podle Bezpečné, Schválit, Potvrdit nebo Kritické a audit exportujte, když potřebujete externí záznam.
Nastavení
- Obecné: vzhled, jazyk, profily pracovního prostoru, zkratky, nápověda a oprávnění.
- AI: poskytovatelé, koncové body, modely, přihlašovací údaje a živé testy.
- Nástroje: připravenost katalogu, podpora platforem a důvody nastavení.
- Bezpečnost: pravidla schválení, chování při odesílání dat, ověřování zařízení a zásady paměti s vymezeným rozsahem.
- Pokročilé: obnovení a diagnostika určené k řešení potíží.
Klávesové zkratky
V systému macOS aplikace mapuje zobrazené Ctrl zkratky na klávesu Command platformy, kde je to vhodné. Směrodatná je stránka Zkratky v aplikaci, která podporuje přizpůsobení.
| Zkratka | Akce |
|---|---|
| Ctrl + N | Nový chat |
| Ctrl + L | Zaměřit editor zprávy |
| Ctrl + Shift + Mezerník | Pozastavit nebo obnovit aktivní běh |
| Ctrl + . | Zastavit aktivní běh |
| Ctrl + 1 … 9 | Otevřít chaty přes Historii |
| Ctrl + , | Otevřít Nastavení |
| F1 | Otevřít Nápovědu & soukromí |
| Esc | Zavřít dialog nebo zrušit aktuální nedestruktivní interakci |
Poznámky k platformám
| Platforma | Důležitá omezení |
|---|---|
| macOS | V režimu Debug i Release běží v sandboxu. Přístup k souborům používá vybrané kořenové složky/záložky s bezpečnostním rozsahem. Nahrávání obrazovky a Zpřístupnění jsou samostatná systémová oprávnění. Integrace místních procesů a Shortcut se průběžně testují na dostupnost. |
| Windows | Funkce souborů, Office/PDF/dat, prohlížeče, vývoje, vzdáleného přístupu a ovládání počítače závisí na nainstalovaném běhovém prostředí a oprávněních. Integrace pouze pro Apple nejsou dostupné a zobrazí se důvod. |
| iPhone / iPad | Soubory používají systémový výběr. Fotoaparát, mikrofon, rozpoznávání řeči, fotografie, místní síť a oznámení se vyžádají v kontextu. Monitorování na pozadí není zaručeno; použijte Shortcuts/App Intents nebo dohánění po návratu do popředí. |
| Android | Soubory a složky používají Storage Access Framework. Práce na pozadí se řídí omezeními Android. Ovládání vstupu přes zpřístupnění se nikdy nepovažuje za udělené jen proto, že je služba deklarována. |
| Web | Pro funkce vyžadující nativní trvalé úložiště používá pouze úložiště relace a jasně zakáže nepodporované možnosti zařízení, kořenových složek souborů, místních procesů a běhu na pozadí. |
Tipy & triky
Řešení potíží
| Problém | Co zkontrolovat |
|---|---|
| Poskytovatele nelze spustit | Otevřete Nastavení > AI. Zkontrolujte konfiguraci, ověřování, možnosti modelu, dostupnost koncového bodu, časový limit a podrobnosti omezení rychlosti a poté spusťte test připojení. |
| Nástroj je zakázán | Otevřete Nastavení > Nástroje a přečtěte si aktuální důvod. Zkontrolujte současnou platformu, oprávnění, test připojení, profil pracovního prostoru a vybranou kořenovou složku. |
| Běh se zdá být zaseknutý | Otevřete Běhy a časovou osu. Může být pozastavený nebo čekat na vstup, schválení, kritické potvrzení, kontrolu odesílání dat či rozpočtu. Zastavení zůstává dostupné. |
| Oprávnění se změnilo | Otevřete Nápovědu > Přehled nebo Nastavení a poté otevřete systémová nastavení. Po návratu znovu otestujte dotčené připojení nebo nástroj. |
| Externí akce má nejistý výsledek | Zkontrolujte cílový systém. Běh ponechte pozastavený nebo jej zastavte, dokud neověříte, že je opakování vhodné. |
| Automatizace se na pozadí nespustila | Mobilní operační systémy nezaručují libovolné pravidelné dotazování. Vraťte aplikaci do popředí, aby práci dohnala, nebo nastavte Shortcut/App Intent či důvěryhodný zdroj událostí. |
| Artefakt nelze otevřít nebo exportovat | Zkontrolujte, zda jsou jeho bajty stále dostupné, zda platforma akci podporuje a zda oprávnění zvoleného cíle stále platí. |
Soukromí, oprávnění a licence
QuickAgent ukládá konverzace, běhy, schválení, metadata znalostí, dovednosti a nastavení místně. Přihlašovací údaje používají úložiště chráněné platformou. Obsah opustí zařízení pouze prostřednictvím vámi nastaveného poskytovatele nebo připojené služby a externí odeslání zobrazí náhled zohledňující cíl.
Oprávnění se vyžadují v kontextu: soubory/složky, fotografie, fotoaparát, mikrofon, rozpoznávání řeči, místní síť, oznámení, nahrávání obrazovky a ovládání přístupnosti/vstupu jsou nezávislé. Odebrání oprávnění dotčenou funkci znepřístupní, místo aby hlásila falešný úspěch.
Otevřete Nastavení > Nápověda & soukromí pro aktuální tabulku možností platformy a Licence open source pro upozornění k balíčkům a přibaleným nativním součástem.