Ghidul utilizatorului QuickAgent
QuickAgent este un spațiu de lucru pentru agenți AI axat pe procesarea locală. Transformă un obiectiv într-o Run durabilă, limitează acea Run printr-un Workspace Profile, solicită verificarea înaintea acțiunilor sensibile și păstrează rezultatele verificate în Artifacts.
Primii pași
- Deschideți Setări > AI, adăugați un furnizor și rulați testul de conexiune al acestuia.
- Deschideți Setări > Workspace Profiles. Alegeți furnizorul, instrumentele, conexiunile, rădăcinile fișierelor, sursele Knowledge și domeniile Memory care pot fi utilizate.
- Selectați Chat nou, alegeți profilul și confirmați destinația furnizorului afișată deasupra conversației.
- Descrieți un rezultat. Adăugați numai fișierele, dosarele, conținutul media, Knowledge sau Memory necesare pentru această Run.
- Examinați planul, aprobările, confirmarea Critical și Data Send Preview atunci când apar.
- Urmăriți activitatea în Timeline. Deschideți rezultatul finalizat din Artefacte și inspectați pista de audit în Istoric.
Prezentarea interfeței
| Secțiune | La ce folosește |
|---|---|
| Conversații | Conversații, destinația furnizorului, Context Tray, planuri, aprobări și Timeline pentru Run activă. |
| Executări | Fiecare sarcină planificată, în curs, întreruptă, programată, eșuată sau finalizată. |
| Inbox pentru aprobări | Verificări în așteptare pentru acțiuni, Critical și Data Send care necesită decizia dvs. |
| Artefacte | Fișiere, rapoarte, jurnale, conținut media, tabele și manifeste de operațiuni verificate, create de Runs. |
| Automatizări | Programări, monitoare, webhookuri, evenimente ale aplicației și declanșatoare Shortcut/App Intent. |
| Competențe | Instrucțiuni reutilizabile cu intrări tipizate, instrumente permise, conexiuni necesare, risc și ieșiri. |
| Conexiuni | Furnizori, profiluri de browser, rădăcini de fișiere/VFS, SSH, MCP, HTTP/SaaS, punți pentru locuință și canale de notificare. |
| Cunoștințe | Dosare indexate, conținut QuickNote, decupaje web, PDF-uri și surse Office. |
| Istoric | Decizii de siguranță, acțiuni ale instrumentelor, destinații și marcaje temporale care permit numai adăugarea. |
| Setări | Aspect, limbă, AI, instrumente, siguranță, Workspace Profiles, comenzi rapide, permisiuni, Ajutor și Pro. |
Furnizori și Workspace Profiles
QuickAgent poate folosi System AI când sistemul de operare oferă o capacitate compatibilă, furnizori locali precum Ollama, LM Studio sau DeskLLM, puncte finale LAN sau personalizate compatibile cu OpenAI și furnizori cloud configurați precum Anthropic ori Gemini. Disponibilitatea este stabilită printr-un test live al capacității; simpla existență a numelui unui furnizor nu înseamnă că acesta este pregătit.
Un Workspace Profile este cadrul de permisiuni al unei Run. Acesta capturează furnizorul/modelul selectat, instrumentele permise, conexiunile, rădăcinile fișierelor, sursele Knowledge, domeniile Memory, suprascrierile de siguranță și bugetul. O modificare ulterioară a configurației face captura învechită și necesită verificare.
Runs, aprobări și recuperare
Comenzi Run
- Pauză solicită o oprire cooperantă la un punct de control persistent.
- Reluare continuă aceeași Run și activitatea finalizată.
- Oprire anulează activitatea furnizorului și a instrumentelor. Un efect extern oprit sau incert nu este raportat drept reușită.
- Reîncercare este disponibilă numai când QuickAgent poate identifica o limită sigură pentru reîncercare.
Niveluri de siguranță
| Nivel | Semnificație |
|---|---|
| Sigur | Citiți, inspectați sau transformați în cadrul profilului activ. |
| Aprobați | Verificați o scriere obișnuită sau o acțiune externă. |
| Confirmați că | Verificați o modificare cu impact mai mare sau mai greu de inversat. |
| Critic | Confirmare puternică de fiecare dată; regulile nu o aprobă niciodată automat. |
Aprobarea afișează ținta exactă, destinația, argumentele propuse, riscul și starea Undo. Dacă editați un argument, QuickAgent validează și evaluează din nou riscul acțiunii editate.
Runs Multi-Agent
Obiectivele complexe pot folosi un planificator, specialiști cu roluri tipizate, un recenzor și un recenzor de securitate. Timeline afișează fiecare predare, verificare, reîncercare, alternativă și limita răspunsului final. Lucrătorii primesc numai intersecția celor patru categorii: instrumentele Skill, instrumentele Workspace Profile, instrumentele rolului și instrumentele disponibile în acel moment.
Bugetele globale și pe rol limitează invocările, timpul, costurile, octeții de rețea și tokenurile. Când se atinge un buget, QuickAgent intră în pauză. Afișează limitele curente și propuse și le mărește numai după verificare explicită. Bugetul aprobat și istoricul rolurilor finalizate se păstrează după repornire.
Context, Knowledge și AI Memory
Context Tray
Adăugați fișiere, dosare, imagini, cadre video, audio, notițe vocale, conținut QuickNote, Knowledge sau Workspace Memory. QuickAgent extrage sau rezumă conținutul acceptat și arată dacă un atașament va fi trimis direct unui furnizor.
Cunoștințe
Sursele Knowledge sunt indexate separat de chat. O Run poate căuta numai în sursele permise de Workspace Profile, iar citările păstrează identitatea sursei.
Memorie
Memory este intenționată, nu un istoric automat al conversațiilor. Domeniile User, Workspace, Project și Tool/Connection sunt separate. Fiecare solicitare de creare, editare sau ștergere primește o aprobare nouă, iar previzualizarea aprobării afișează domeniul și valoarea exactă propusă.
Instrumente și Connections
Catalogul live acoperă operațiuni cu fișiere/VFS; Office, PDF și date structurate; media și OCR; utilizarea browserului și computerului; comenzi de dezvoltare; SSH; MCP; HTTP și SaaS; punți pentru locuințe inteligente; notificări; programări; monitoare și controlul automatizărilor. Serverele MCP conectate pot adăuga instrumente dinamice după validarea schemei și reevaluarea riscului de către QuickAgent.
Setări > Instrumente arată de ce un instrument este pregătit sau dezactivat. Motivele obișnuite sunt lipsa unei conexiuni, a permisiunii sistemului de operare, o platformă neacceptată, o restricție Workspace Profile, un punct final netestat sau o capacitate indisponibilă a furnizorului.
Automatizări
Automations pot porni de la declanșatoare de timp, fișier/dosar, web, webhook, e-mail, calendar, rețea, gazdă, dispozitiv, senzor, locație, eveniment al aplicației, Shortcut/App Intent, comandă sau declanșatoare manuale, când platforma le acceptă. Un declanșator creează o Run obișnuită; nu ocolește verificările Workspace Profile, de aprobare, Critical sau Data Send.
- Monitorizarea pe desktop continuă numai cât timp rulează procesul aplicației.
- Platformele mobile recuperează activitatea întârziată când aplicația revine în prim-plan.
- Folosiți Shortcut/App Intent sau un releu de evenimente de încredere când este necesară livrarea prin sistemul de operare.
- Evenimentele din coadă, pauza, anularea și ștergerea rămân explicite, astfel încât evenimentele să nu fie eliminate pe ascuns.
Skills și Skill Packs
Un Skill stochează o solicitare axată pe rezultat, variabile tipizate, recomandarea furnizorului, instrumentele permise, conexiunile și capacitățile necesare, riscul maxim și Artifacts așteptate. Înainte de utilizare, QuickAgent afișează intrările și permisiunile efective; previzualizarea nu acordă ea însăși permisiunea.
Șapte Packs incluse oferă Skills reale pentru Office, Coding, Smart Home, Research, Browser Automation, Personal Admin și Incident Response. Puteți instala, actualiza, dezinstala, personaliza, duplica, importa și exporta Skills. Fișierele JSON importate primesc o previzualizare a încrederii, editorului, semnăturii, permisiunilor, riscului, platformei și conflictelor. „Păstrați ambele” creează un derivat local nesemnat, în loc să moștenească încrederea altui editor.
Artifacts, History și Undo
Artifacts păstrează octeții ieșirii, metadatele, versiunile, proveniența, Run sursă și manifestele operațiunilor. În funcție de capacitatea platformei, le puteți deschide, partaja, exporta sau afișa locația. Operațiunile eligibile oferă un Undo verificat; activitatea distructivă sau incertă nu este reluată niciodată automat.
History permite numai adăugarea. Filtrați-l după Safe, Approve, Confirm sau Critical și exportați auditul când aveți nevoie de o evidență externă.
Setări
- General: aspect, limbă, Workspace Profiles, comenzi rapide, Ajutor și permisiuni.
- AI: furnizori, puncte finale, modele, date de autentificare și teste live.
- Instrumente: starea catalogului, compatibilitatea platformei și motivele privind configurarea.
- Siguranță: reguli de aprobare, comportamentul Data Send, autentificarea dispozitivului și politica Memory pe domenii.
- Avansat: recuperare și diagnosticare destinate depanării.
Comenzi rapide de la tastatură
Pe macOS, aplicația mapează comenzile rapide afișate cu Ctrl la tasta Command a platformei, acolo unde este cazul. Pagina Comenzi rapide din aplicație este referința oficială și permite personalizarea.
| Comandă rapidă | Acțiune |
|---|---|
| Ctrl + N | Chat nou |
| Ctrl + L | Focalizați caseta de redactare |
| Ctrl + Shift + Space | Întrerupeți sau reluați Run activă |
| Ctrl + . | Opriți Run activă |
| Ctrl + 1 … 9 | Deschideți Chats până la History |
| Ctrl + , | Deschideți Setări |
| F1 | Deschideți Ajutor & confidențialitate |
| Esc | Închideți o casetă de dialog sau anulați interacțiunea nedistructivă curentă |
Note despre platforme
| Platformă | Limite importante |
|---|---|
| macOS | Izolată în Debug și Release. Accesul la fișiere folosește rădăcini selectate/marcaje cu domeniu de securitate. Screen Recording și Accessibility sunt permisiuni de sistem separate. Integrările pentru procese locale și Shortcut rămân supuse testării capacității. |
| Windows | Funcțiile pentru fișiere, Office/PDF/date, browser, dezvoltare, acces la distanță și control desktop depind de mediul de execuție instalat și de permisiuni. Integrările exclusive Apple sunt indisponibile, cu un motiv vizibil. |
| iPhone / iPad | Fișierele folosesc selectorul sistemului. Camera, microfonul, recunoașterea vocală, fotografiile, rețeaua locală și notificările sunt solicitate în context. Monitorizarea în fundal nu este garantată; folosiți Shortcuts/App Intents sau recuperarea în prim-plan. |
| Android | Fișierele și dosarele folosesc Storage Access Framework. Activitatea în fundal respectă restricțiile Android. Controlul intrărilor bazat pe Accessibility nu este niciodată considerat acordat doar pentru că este declarat un serviciu. |
| Web | Folosește stocare limitată la sesiune pentru funcțiile care necesită persistență nativă și dezactivează clar capacitățile neacceptate pentru dispozitiv, rădăcini de fișiere, procese locale și fundal. |
Sfaturi & trucuri
Depanare
| Problemă | Ce trebuie verificat |
|---|---|
| Furnizorul nu poate rula | Deschideți Setări > AI. Verificați configurația, autentificarea, capacitatea modelului, accesibilitatea punctului final, expirarea și detaliile limitării frecvenței, apoi rulați testul de conexiune. |
| Un instrument este dezactivat | Deschideți Setări > Instrumente și citiți motivul live. Verificați platforma curentă, permisiunea, testul de conexiune, Workspace Profile și rădăcina selectată. |
| O Run pare blocată | Deschideți Runs și Timeline. Execuția poate fi întreruptă, poate aștepta o intrare, o aprobare, confirmarea Critical, verificarea Data Send sau verificarea bugetului. Oprirea rămâne disponibilă. |
| S-a modificat o permisiune | Deschideți Ajutor > Prezentare generală sau Setări, apoi deschideți setările sistemului. Testați din nou conexiunea sau instrumentul afectat după revenire. |
| O acțiune externă este incertă | Verificați sistemul țintă. Mențineți Run întreruptă sau opriți-o, dacă nu ați verificat că reîncercarea este adecvată. |
| O Automation nu s-a declanșat în fundal | Sistemele de operare mobile nu garantează interogarea periodică arbitrară. Reveniți în prim-plan pentru recuperare sau configurați un Shortcut/App Intent ori o sursă de evenimente de încredere. |
| Un Artifact nu poate fi deschis sau exportat | Verificați dacă octeții săi sunt încă disponibili, dacă platforma acceptă acțiunea și dacă permisiunea destinației alese este încă valabilă. |
Confidențialitate, permisiuni și licențe
QuickAgent stochează local conversațiile, Runs, aprobările, metadatele Knowledge, Skills și setările. Datele de autentificare folosesc spațiul de stocare protejat de platformă. Conținutul părăsește dispozitivul numai printr-un furnizor sau serviciu conectat configurat de dvs., iar trimiterile externe primesc o previzualizare adaptată destinației.
Permisiunile sunt solicitate în context: fișiere/dosare, fotografii, cameră, microfon, recunoaștere vocală, rețea locală, notificări, înregistrarea ecranului și accesibilitatea/controlul intrărilor sunt independente. Eliminarea unei permisiuni face indisponibilă funcția afectată, în loc să genereze un succes fals.
Deschideți Setări > Ajutor & confidențialitate pentru tabelul capacităților platformei curente și Licențe open-source pentru notificările despre pachete și componente native incluse.