Guia de l'usuari de QuickAgent
QuickAgent és un espai de treball d'agents d'IA amb enfocament local. Converteix un objectiu en un Run persistent, el limita amb un Workspace Profile, demana revisió abans d'accions sensibles i conserva els resultats verificats a Artifacts.
Primers passos
- Obriu Configuració > IA, afegeix un proveïdor i executa'n la prova de connexió.
- Obriu Configuració > Workspace Profiles. Tria quin proveïdor, eines, connexions, arrels de fitxers, fonts de Knowledge i àmbits de Memory es poden utilitzar.
- Selecciona Xat nou, tria el perfil i confirma la destinació del proveïdor que es mostra damunt de la conversa.
- Descriu el resultat que vols obtenir. Afegeix només els fitxers, carpetes, contingut multimèdia, Knowledge o Memory necessaris per a aquest Run.
- Revisa el pla, les aprovacions, la confirmació Critical i la Data Send Preview quan apareguin.
- Segueix la feina a Timeline. Obre el resultat completat des d' Artifacts i consulta el registre d'auditoria a Historial.
Descripció general de la interfície
| Secció | Per a què serveix |
|---|---|
| Chats | Converses, destinació del proveïdor, Context Tray, plans, aprovacions i Timeline del Run actiu. |
| Runs | Totes les tasques planificades, en curs, en pausa, programades, fallides o completades. |
| Approval Inbox | Revisions pendents d'accions, Critical i Data Send que requereixen la teva decisió. |
| Artifacts | Fitxers, informes, registres, contingut multimèdia, taules i manifests d'operacions verificats creats pels Runs. |
| Automations | Programacions, monitors, webhooks, esdeveniments de l'app i activadors de Shortcut/App Intent. |
| Skills | Instruccions reutilitzables amb entrades tipades, eines permeses, connexions obligatòries, risc i resultats. |
| Connections | Proveïdors, perfils de navegador, arrels de fitxers/VFS, SSH, MCP, HTTP/SaaS, ponts domòtics i canals de notificació. |
| Knowledge | Carpetes indexades, contingut de QuickNote, retalls web, PDFs i fonts d'Office. |
| Historial | Decisions de seguretat, accions d'eines, destinacions i marques de temps en un registre només d'addició. |
| Configuració | Aparença, idioma, IA, eines, seguretat, Workspace Profiles, dreceres, permisos, Ajuda i Pro. |
Proveïdors i Workspace Profiles
QuickAgent pot utilitzar la IA del sistema quan el sistema operatiu ofereix una capacitat compatible; proveïdors locals com Ollama, LM Studio o DeskLLM; endpoints de LAN o personalitzats compatibles amb OpenAI; i proveïdors al núvol configurats com Anthropic o Gemini. La disponibilitat es determina mitjançant una prova de capacitat en directe; el nom d'un proveïdor per si sol no significa que estigui preparat.
Un Workspace Profile és el marc de permisos del Run. Captura el proveïdor/model seleccionat, les eines permeses, les connexions, les arrels de fitxers, les fonts de Knowledge, els àmbits de Memory, les excepcions de seguretat i el pressupost. Un canvi de configuració posterior deixa obsoleta la captura i requereix una revisió.
Runs, aprovacions i recuperació
Controls del Run
- Pausa demana una aturada cooperativa en un punt de control persistent.
- Reprèn continua el mateix Run i la feina ja completada.
- Atura cancel·la la feina del proveïdor i de les eines. Un efecte extern aturat o incert no es notifica com a correcte.
- Torna-ho a provar només està disponible quan QuickAgent pot identificar un límit segur per tornar-ho a provar.
Nivells de seguretat
| Nivell | Significat |
|---|---|
| Safe | Llegeix, inspecciona o transforma dins del perfil actiu. |
| Approve | Revisa una escriptura normal o una acció externa. |
| Confirmeu que | Revisa un canvi de més impacte o més difícil de revertir. |
| Critical | Confirmació reforçada cada vegada; les regles mai no l'aproven automàticament. |
L'aprovació mostra l'objectiu exacte, la destinació, els arguments proposats, el risc i l'estat d'Undo. Si edites un argument, QuickAgent torna a validar l'acció editada i a avaluar-ne el risc.
Runs multiagent
Els objectius complexos poden utilitzar un planificador, treballadors especialistes tipats, un revisor i un revisor de seguretat. Timeline mostra cada traspàs, revisió, reintent, alternativa i límit de resposta final. Els treballadors només reben la intersecció entre les eines de Skill, les de Workspace Profile, les del rol i les disponibles en aquell moment.
Els pressupostos globals i per rol limiten les invocacions, el temps, el cost, els bytes de xarxa i els tokens. Quan s'arriba a un pressupost, QuickAgent es posa en pausa. Mostra els límits actuals i proposats, i només els augmenta després d'una revisió explícita. El pressupost aprovat i l'historial de rols completats es conserven després d'un reinici.
Context, Knowledge i AI Memory
Context Tray
Afegeix fitxers, carpetes, imatges, fotogrames de vídeo, àudio, notes de veu, contingut de QuickNote, Knowledge o Workspace Memory. QuickAgent extreu o resumeix el contingut compatible i indica si un adjunt s'enviarà directament a un proveïdor.
Knowledge
Les fonts de Knowledge s'indexen separadament del xat. Un Run només pot cercar a les fonts permeses pel seu Workspace Profile, i les citacions conserven la identitat de la font.
Memory
Memory és deliberada, no pas un historial automàtic del xat. Els àmbits User, Workspace, Project i Tool/Connection són independents. Cada sol·licitud de creació, edició o supressió rep una aprovació nova, i la vista prèvia mostra l'àmbit i el valor exacte proposat.
Eines i connexions
El catàleg actiu inclou operacions de fitxers/VFS; Office, PDF i dades estructurades; contingut multimèdia i OCR; ús del navegador i de l'ordinador; ordres de desenvolupament; SSH; MCP; HTTP i SaaS; ponts domòtics; notificacions; programacions; monitors; i control d'automatitzacions. Els servidors MCP connectats poden afegir eines dinàmiques després de validar-ne l'esquema i que QuickAgent en torni a avaluar el risc.
Configuració > Eines mostra per què una eina està preparada o desactivada. Els motius habituals són una connexió absent, un permís del sistema operatiu, una plataforma incompatible, una restricció de Workspace Profile, un endpoint no provat o una capacitat del proveïdor no disponible.
Automations
Les automatitzacions es poden iniciar per activadors de temps, fitxer/carpeta, web, webhook, correu, calendari, xarxa, host, dispositiu, sensor, ubicació, esdeveniment de l'app, Shortcut/App Intent, ordre o activació manual quan la plataforma ho admet. Un activador crea un Run normal; no eludeix Workspace Profile ni les comprovacions d'aprovació, Critical o Data Send.
- La supervisió a l'ordinador només continua mentre s'executa el procés de l'app.
- Les plataformes mòbils recuperen la feina endarrerida quan l'app torna a primer pla.
- Utilitza Shortcut/App Intent o un repetidor d'esdeveniments de confiança quan el sistema operatiu hagi de garantir el lliurament.
- Els esdeveniments en cua, la pausa, la cancel·lació i la supressió continuen sent explícits perquè no se'n descarti cap silenciosament.
Skills i Skill Packs
Una Skill desa una instrucció centrada en un resultat, variables tipades, una recomanació de proveïdor, eines permeses, connexions i capacitats obligatòries, el risc màxim i els Artifacts esperats. Abans d'utilitzar-la, QuickAgent mostra les entrades i els permisos efectius; la vista prèvia no concedeix permisos per si sola.
Set Packs integrats ofereixen Skills reals per a Office, Coding, Smart Home, Research, Browser Automation, Personal Admin i Incident Response. Pots instal·lar, actualitzar, desinstal·lar, personalitzar, duplicar, importar i exportar Skills. El JSON importat rep una vista prèvia de confiança, editor, signatura, permisos, risc, plataforma i conflictes. «Conserva'ls tots dos» crea un derivat local sense signar en lloc d'heretar la confiança d'un altre editor.
Artifacts, historial i Undo
Artifacts conserva els bytes de sortida, les metadades, les versions, la procedència, el Run d'origen i els manifests d'operacions. Segons les capacitats de la plataforma, pots obrir-los, compartir-los, exportar-los o mostrar-los al sistema de fitxers. Les operacions aptes ofereixen un Undo revisat; la feina destructiva o incerta mai no es repeteix automàticament.
History és un registre només d'addició. Filtra'l per Safe, Approve, Confirm o Critical i exporta l'auditoria quan necessitis un registre extern.
Configuració
- General: aparença, idioma, Workspace Profiles, dreceres, Ajuda i permisos.
- IA: proveïdors, endpoints, models, credencials i proves en directe.
- Eines: disponibilitat del catàleg, compatibilitat amb la plataforma i motius de configuració.
- Seguretat: regles d'aprovació, comportament de Data Send, autenticació del dispositiu i política de Memory per àmbits.
- Avançat: recuperació i diagnòstic per resoldre problemes.
Dreceres de teclat
A macOS, l'app assigna les dreceres que es mostren amb Ctrl a la tecla Command de la plataforma quan correspon. La pàgina Dreceres de l'app és la referència vàlida i permet personalitzar-les.
| Drecera | Acció |
|---|---|
| Ctrl + N | Xat nou |
| Ctrl + L | Posa el focus al redactor |
| Ctrl + Shift + Espai | Posa en pausa o reprèn el Run actiu |
| Ctrl + . | Atura el Run actiu |
| Ctrl + 1 … 9 | Obre Chats des de History |
| Ctrl + , | Obre Configuració |
| F1 | Obre Ajuda & privadesa |
| Esc | Tanca un quadre de diàleg o cancel·la la interacció no destructiva actual |
Notes de la plataforma
| Plataforma | Límits importants |
|---|---|
| macOS | Entorn aïllat tant a Debug com a Release. L'accés als fitxers utilitza arrels seleccionades i marcadors amb àmbit de seguretat. La gravació de pantalla i l'accessibilitat són permisos del sistema independents. Les integracions amb processos locals i Shortcut continuen subjectes a proves de capacitat. |
| Windows | Les funcions de fitxers, Office/PDF/dades, navegador, desenvolupament, accés remot i control de l'ordinador depenen de l'entorn d'execució instal·lat i dels permisos. Les integracions exclusives d'Apple no estan disponibles i se n'indica el motiu. |
| iPhone / iPad | Els fitxers utilitzen el selector del sistema. La càmera, el micròfon, el reconeixement de veu, les fotos, la xarxa local i les notificacions es demanen en context. La supervisió en segon pla no està garantida; utilitza Shortcuts/App Intents o la recuperació en primer pla. |
| Android | Els fitxers i les carpetes utilitzen Storage Access Framework. La feina en segon pla està subjecta a les restriccions d'Android. El control d'entrada basat en l'accessibilitat mai no es considera concedit només perquè s'hagi declarat un servei. |
| Web | Utilitza emmagatzematge només durant la sessió per a les funcions que necessiten persistència nativa i desactiva clarament les capacitats no compatibles de dispositiu, arrels de fitxers, processos locals i segon pla. |
Consells & trucs
Resolució de problemes
| Problema | Què cal comprovar |
|---|---|
| El proveïdor no es pot executar | Obre Configuració > IA. Comprova la configuració, l'autenticació, la capacitat del model, l'accessibilitat de l'endpoint, el temps d'espera i els detalls del límit de freqüència i, després, executa la prova de connexió. |
| Una eina està desactivada | Obre Configuració > Eines i consulta el motiu en directe. Revisa la plataforma actual, el permís, la prova de connexió, el Workspace Profile i l'arrel seleccionada. |
| Un Run sembla bloquejat | Obre Runs i Timeline. Pot estar en pausa o esperant una entrada, una aprovació, una confirmació Critical, una revisió de Data Send o una revisió de pressupost. L'opció Atura continua disponible. |
| Ha canviat un permís | Obre Ajuda > Resum o Configuració i, a continuació, obre la configuració del sistema. En tornar, prova de nou la connexió o l'eina afectada. |
| Una acció externa és incerta | Comprova el sistema de destinació. Mantén el Run en pausa o atura'l llevat que hagis verificat que és adequat tornar-ho a provar. |
| Una Automation no s'ha activat en segon pla | Els sistemes operatius mòbils no garanteixen un sondeig arbitrari. Torna a primer pla per posar-te al dia o configura un Shortcut/App Intent o una font d'esdeveniments de confiança. |
| Un Artifact no es pot obrir ni exportar | Comprova si els seus bytes encara estan disponibles, si la plataforma admet l'acció i si el permís de la destinació triada continua vigent. |
Privadesa, permisos i llicències
QuickAgent desa localment les converses, els Runs, les aprovacions, les metadades de Knowledge, les Skills i la configuració. Les credencials utilitzen l'emmagatzematge protegit de la plataforma. El contingut només surt del dispositiu mitjançant un proveïdor o servei connectat que configuris, i els enviaments externs reben una vista prèvia que indica la destinació.
Els permisos es demanen en context: fitxers/carpetes, fotos, càmera, micròfon, reconeixement de veu, xarxa local, notificacions, gravació de pantalla i control d'accessibilitat/entrada són independents. Revocar un permís fa que la capacitat afectada deixi d'estar disponible en lloc de produir un fals èxit.
Obriu Configuració > Ajuda & privadesa per consultar la taula de capacitats de la plataforma actual i Llicències de codi obert per consultar els avisos dels paquets i components natius inclosos.