QuickAgent-gebruikershandleiding
QuickAgent is een local-first werkruimte voor AI-agenten. Het zet een doel om in een duurzame Run, begrenst die Run met een Workspace Profile, vraagt om controle vóór gevoelige acties en bewaart geverifieerde resultaten in Artifacts.
Aan de slag
- Openen Instellingen > AI, voeg een aanbieder toe en voer de verbindingstest uit.
- Openen Instellingen > Workspace Profiles. Kies welke aanbieder, tools, verbindingen, bestandsroots, Knowledge-bronnen en Memory-bereiken mogen worden gebruikt.
- Selecteer Nieuwe chat, kies het profiel en bevestig de bestemming van de aanbieder die boven het gesprek wordt weergegeven.
- Beschrijf een resultaat. Voeg alleen de bestanden, mappen, media, Knowledge of Memory toe die voor deze Run nodig zijn.
- Controleer het plan, de goedkeuringen, Critical-bevestiging en Data Send Preview wanneer deze verschijnen.
- Volg het werk in de Timeline. Open het voltooide resultaat vanuit Artefacten en bekijk het controlespoor in Geschiedenis.
Overzicht van de interface
| Onderdeel | Waarvoor het dient |
|---|---|
| Chats | Gesprekken, bestemming van de aanbieder, Context Tray, plannen, goedkeuringen en de actieve Run Timeline. |
| Uitvoeringen | Elke geplande, actieve, gepauzeerde, ingeplande, mislukte of voltooide taak. |
| Approval Inbox | Openstaande controles van acties, Critical-bevestigingen en Data Send-verzoeken waarvoor uw beslissing nodig is. |
| Artefacten | Geverifieerde bestanden, rapporten, logboeken, media, tabellen en bewerkingsmanifesten die door Runs zijn gemaakt. |
| Automatiseringen | Planningen, monitors, webhooks, appgebeurtenissen en triggers van Shortcut/App Intent. |
| Vaardigheden | Herbruikbare instructies met getypeerde invoer, toegestane tools, vereiste verbindingen, risico en uitvoer. |
| Verbindingen | Aanbieders, browserprofielen, bestands-/VFS-roots, SSH, MCP, HTTP/SaaS, woningbridges en meldingskanalen. |
| Kennis | Geïndexeerde mappen, QuickNote-inhoud, webfragmenten, PDF's en Office-bronnen. |
| Geschiedenis | Een alleen-aanvulbaar overzicht van veiligheidsbeslissingen, toolacties, bestemmingen en tijdstempels. |
| Instellingen | Weergave, taal, AI, tools, veiligheid, Workspace Profiles, sneltoetsen, machtigingen, Help en Pro. |
Aanbieders en Workspace Profiles
QuickAgent kan System AI gebruiken wanneer het besturingssysteem een compatibele mogelijkheid biedt, lokale aanbieders zoals Ollama, LM Studio of DeskLLM, LAN- of aangepaste OpenAI-compatibele eindpunten en geconfigureerde cloudproviders zoals Anthropic of Gemini. Beschikbaarheid wordt bepaald door een live capaciteitstest; alleen de naam van een aanbieder betekent niet dat deze gereed is.
Een Workspace Profile is de machtigingsgrens van de Run. Het legt de geselecteerde aanbieder/het model, toegestane tools, verbindingen, bestandsroots, Knowledge-bronnen, Memory-bereiken, veiligheidsuitzonderingen en het budget vast. Een latere configuratiewijziging maakt de momentopname verouderd en vereist een nieuwe controle.
Runs, goedkeuringen en herstel
Bediening van Runs
- Pauzeren vraagt om coöperatief te stoppen bij een duurzaam controlepunt.
- Hervatten gaat verder met dezelfde Run en het al voltooide werk.
- Stop annuleert werk van aanbieders en tools. Een gestopt of onzeker extern effect wordt niet als geslaagd gemeld.
- Opnieuw proberen is alleen beschikbaar wanneer QuickAgent een veilige grens voor een nieuwe poging kan bepalen.
Veiligheidsniveaus
| Niveau | Betekenis |
|---|---|
| Veilig | Lezen, inspecteren of transformeren binnen het actieve profiel. |
| Goedkeuren | Een normale schrijfactie of externe actie controleren. |
| Controleer of | Een wijziging met grotere impact of die moeilijker ongedaan te maken is controleren. |
| Kritiek | Elke keer een krachtige bevestiging; regels keuren dit nooit automatisch goed. |
De goedkeuring toont het exacte doel, de bestemming, voorgestelde argumenten, het risico en de status van Undo. Als u een argument bewerkt, valideert QuickAgent de gewijzigde actie opnieuw en voert het een nieuwe risicocontrole uit.
Uitvoeringen met meerdere agents
Voor complexe doelen kunnen een planner, getypeerde gespecialiseerde workers, een reviewer en een security reviewer worden ingezet. De Timeline toont elke overdracht, controle, nieuwe poging, terugvaloptie en grens van het definitieve antwoord. Workers ontvangen alleen de viervoudige doorsnede van Skill-tools, Workspace Profile-tools, roltools en momenteel actieve tools.
Algemene en rolspecifieke budgetten beperken aanroepen, tijd, kosten, netwerkbytes en tokens. Wanneer een budget wordt bereikt, pauzeert QuickAgent. Het toont de huidige en voorgestelde limieten en verhoogt deze alleen na uitdrukkelijke controle. Het goedgekeurde budget en de geschiedenis van voltooide rollen blijven na een herstart behouden.
Context, Knowledge en AI Memory
Contextlade
Voeg bestanden, mappen, afbeeldingen, videoframes, audio, spraaknotities, QuickNote-inhoud, Knowledge of Workspace Memory toe. QuickAgent extraheert of vat ondersteunde inhoud samen en toont of een bijlage rechtstreeks naar een aanbieder wordt verzonden.
Kennis
Knowledge-bronnen worden afzonderlijk van chats geïndexeerd. Een Run kan alleen bronnen doorzoeken die door het Workspace Profile zijn toegestaan, en citaten behouden de identiteit van hun bron.
Geheugen
Memory wordt bewust beheerd en is geen automatische chatgeschiedenis. De bereiken User, Workspace, Project en Tool/Connection zijn gescheiden. Elk verzoek om gegevens te maken, bewerken of verwijderen krijgt een nieuwe goedkeuring, en het goedkeuringsvoorbeeld toont het bereik en de exact voorgestelde waarde.
Tools en Connections
De livecatalogus omvat bestands-/VFS-bewerkingen; Office, PDF en gestructureerde gegevens; media en OCR; browser- en computergebruik; ontwikkelopdrachten; SSH; MCP; HTTP en SaaS; smarthomebridges; meldingen; planningen; monitors; en automatiseringsbeheer. Verbonden MCP-servers kunnen na schemavalidatie en een nieuwe risicobeoordeling door QuickAgent dynamische tools toevoegen.
Instellingen > Tools toont waarom een tool gereed of uitgeschakeld is. Veelvoorkomende redenen zijn een ontbrekende verbinding, machtiging van het besturingssysteem, niet-ondersteund platform, beperking door het Workspace Profile, ongetest eindpunt of niet-beschikbare mogelijkheid van de aanbieder.
Automatiseringen
Automations kunnen starten op basis van tijd, bestand/map, web, webhook, e-mail, agenda, netwerk, host, apparaat, sensor, locatie, appgebeurtenis, Shortcut/App Intent, opdracht of handmatige triggers wanneer het platform deze ondersteunt. Een trigger maakt een gewone Run; deze omzeilt de controles van Workspace Profile, goedkeuring, Critical of Data Send niet.
- Desktopmonitoring gaat alleen door zolang het app-proces actief is.
- Mobiele platforms halen achterstallig werk in wanneer de app weer op de voorgrond komt.
- Gebruik Shortcut/App Intent of een vertrouwde gebeurtenisrelay wanneer levering door het besturingssysteem vereist is.
- Wachtrijgebeurtenissen, pauzeren, annuleren en verwijderen blijven expliciet, zodat gebeurtenissen niet ongemerkt worden verwijderd.
Skills en Skill Packs
Een Skill bevat een resultaatgerichte prompt, getypeerde variabelen, een aanbeveling voor de aanbieder, toegestane tools, vereiste verbindingen en mogelijkheden, maximaal risico en verwachte Artifacts. Vóór gebruik toont QuickAgent de invoer en effectieve machtigingen; de voorvertoning zelf verleent geen toestemming.
Zeven ingebouwde Packs bieden echte Skills voor Office, Coding, Smart Home, Research, Browser Automation, Personal Admin en Incident Response. U kunt Skills installeren, bijwerken, verwijderen, aanpassen, dupliceren, importeren en exporteren. Geïmporteerde JSON krijgt een voorbeeld van vertrouwen, uitgever, handtekening, machtiging, risico, platform en conflicten. “Keep both” maakt een niet-ondertekende lokale afgeleide in plaats van het vertrouwen van een andere uitgever over te nemen.
Artifacts, geschiedenis en Undo
Artifacts bewaren uitvoerbytes, metadata, versies, herkomst, bron-Run en bewerkingsmanifesten. Afhankelijk van de platformmogelijkheden kunt u ze openen, delen, exporteren of weergeven. Geschikte bewerkingen bieden een gecontroleerde Undo; destructief of onzeker werk wordt nooit automatisch herhaald.
History kan alleen worden aangevuld. Filter op Safe, Approve, Confirm of Critical en exporteer de audit wanneer u een extern verslag nodig hebt.
Instellingen
- Algemeen: weergave, taal, Workspace Profiles, sneltoetsen, Help en machtigingen.
- AI: aanbieders, eindpunten, modellen, referenties en live tests.
- Hulpmiddelen: gereedheid van de catalogus, platformondersteuning en installatieredenen.
- Veiligheid: goedkeuringsregels, Data Send-gedrag, apparaatverificatie en beleid voor Memory-bereiken.
- Geavanceerd: herstel en diagnostiek voor probleemoplossing.
Sneltoetsen
Op macOS koppelt de app de weergegeven Ctrl sneltoetsen waar nodig aan de Command-toets van het platform. De pagina Shortcuts in de app is leidend en ondersteunt aanpassing.
| Sneltoets | Actie |
|---|---|
| Ctrl + N | Nieuwe chat |
| Ctrl + L | De invoereditor activeren |
| Ctrl + Shift + Spatie | De actieve Run pauzeren of hervatten |
| Ctrl + . | De actieve Run stoppen |
| Ctrl + 1 … 9 | Chats via History openen |
| Ctrl + , | Instellingen openen |
| F1 | Help & Privacy openen |
| Esc | Een dialoogvenster sluiten of de huidige niet-destructieve interactie annuleren |
Platformopmerkingen
| Platform | Belangrijke grenzen |
|---|---|
| macOS | In Debug en Release in een sandbox. Bestandstoegang gebruikt geselecteerde roots/beveiligingsgebonden bladwijzers. Schermopname en toegankelijkheid zijn afzonderlijke systeemmachtigingen. Integraties met lokale processen en Shortcuts blijven op mogelijkheden getest. |
| Windows | Functies voor bestanden, Office/PDF/gegevens, browser, ontwikkeling, externe toegang en desktopbesturing zijn afhankelijk van de geïnstalleerde runtime en machtigingen. Integraties die alleen voor Apple beschikbaar zijn, zijn niet beschikbaar en tonen hiervoor een duidelijke reden. |
| iPhone / iPad | Bestanden gebruiken de systeemkiezer. Camera, microfoon, spraak, foto's, lokaal netwerk en meldingen worden in hun context aangevraagd. Achtergrondmonitoring is niet gegarandeerd; gebruik Shortcuts/App Intents of inhalen op de voorgrond. |
| Android | Bestanden en mappen gebruiken het Storage Access Framework. Achtergrondwerk volgt de beperkingen van Android. Invoerbesturing op basis van toegankelijkheid wordt nooit als verleend beschouwd enkel omdat een service is gedeclareerd. |
| Web | Gebruikt sessiegebonden opslag voor functies die native persistente opslag vereisen en schakelt niet-ondersteunde apparaat-, bestandsroot-, lokale proces- en achtergrondmogelijkheden duidelijk uit. |
Tips & trucs
Problemen oplossen
| Probleem | Wat u moet controleren |
|---|---|
| De aanbieder kan niet worden uitgevoerd | Open Instellingen > AI. Controleer configuratie, verificatie, modelmogelijkheden, bereikbaarheid van het eindpunt, time-out- en snelheidslimietdetails en voer vervolgens de verbindingstest uit. |
| Een tool is uitgeschakeld | Open Instellingen > Tools en lees de actuele reden. Controleer het huidige platform, de machtiging, verbindingstest, het Workspace Profile en de geselecteerde root. |
| Een Run lijkt vastgelopen | Open Runs en de Timeline. De Run kan gepauzeerd zijn of wachten op invoer, goedkeuring, Critical-bevestiging, Data Send-controle of budgetcontrole. Stop blijft beschikbaar. |
| Een machtiging is gewijzigd | Open Help > Overview of Instellingen en open vervolgens de systeeminstellingen. Test na terugkeer de betreffende verbinding of tool opnieuw. |
| Een externe actie is onzeker | Controleer het doelsysteem. Houd de Run gepauzeerd of stop deze, tenzij u hebt vastgesteld dat opnieuw proberen gepast is. |
| Een Automation is niet op de achtergrond geactiveerd | Mobiele besturingssystemen garanderen geen willekeurige polling. Keer terug naar de voorgrond om achterstallig werk in te halen of configureer een Shortcut/App Intent of vertrouwde gebeurtenisbron. |
| Een Artifact kan niet worden geopend of geëxporteerd | Controleer of de bytes nog beschikbaar zijn, of het platform de actie ondersteunt en of de machtiging voor de gekozen bestemming nog geldig is. |
Privacy, machtigingen en licenties
QuickAgent bewaart gesprekken, Runs, goedkeuringen, Knowledge-metadata, Skills en instellingen lokaal. Referenties gebruiken door het platform beveiligde opslag. Inhoud verlaat het apparaat alleen via een aanbieder of verbonden dienst die u configureert, en externe verzendingen krijgen een bestemmingsbewuste voorvertoning.
Machtigingen worden in hun context aangevraagd: bestanden/mappen, foto's, camera, microfoon, spraakherkenning, lokaal netwerk, meldingen, schermopname en toegankelijkheids-/invoerbesturing zijn onafhankelijk. Wanneer u een machtiging intrekt, wordt de betreffende mogelijkheid onbeschikbaar in plaats van ten onrechte als geslaagd te worden gemeld.
Openen Instellingen > Help & Privacy voor de actuele tabel met platformmogelijkheden en Opensourcelicenties voor mededelingen over pakketten en meegeleverde native onderdelen.