Användarhandbok för QuickAgent
QuickAgent är en lokal-först-arbetsyta för AI-agenter. Den omvandlar ett mål till en varaktig Run, begränsar den Run med en Workspace Profile, begär granskning före känsliga åtgärder och behåller verifierade resultat i Artifacts.
Kom i gång
- Öppna Settings > AI, lägg till en leverantör och kör dess anslutningstest.
- Öppna Settings > Workspace Profiles. Välj vilka leverantörer, verktyg, anslutningar, filrötter, Knowledge-källor och Memory-omfång som får användas.
- Välj New Chat, välj profilen och bekräfta leverantörsdestinationen som visas ovanför konversationen.
- Beskriv ett resultat. Lägg bara till de filer, mappar, medier, Knowledge eller Memory som behövs för denna Run.
- Granska planen, godkännanden, Critical-bekräftelsen och Data Send Preview när de visas.
- Följ arbetet i Timeline. Öppna det slutförda resultatet från Artifacts och granska granskningsspåret i Historik.
Översikt över gränssnittet
| Avsnitt | Vad det används för |
|---|---|
| Chattar | Konversationer, leverantörsdestination, Context Tray, planer, godkännanden och den aktiva Run-tidslinjen. |
| Körningar | Varje planerad, pågående, pausad, schemalagd, misslyckad eller slutförd uppgift. |
| Inkorg för godkännanden | Granskningar av väntande åtgärder, Critical och Data Send som behöver ditt beslut. |
| Artifacts | Verifierade filer, rapporter, loggar, media, tabeller och åtgärdsmanifest som skapats av Runs. |
| Automatiseringar | Scheman, övervakningar, webbhooks, apphändelser och genvägar/App Intent-utlösare. |
| Skills | Återanvändbara instruktioner med typade indata, tillåtna verktyg, nödvändiga anslutningar, risk och resultat. |
| Anslutningar | Leverantörer, webbläsarprofiler, fil-/VFS-rötter, SSH, MCP, HTTP/SaaS, hembryggor och aviseringskanaler. |
| Knowledge | Indexerade mappar, QuickNote-innehåll, webbklipp, PDF-filer och Office-källor. |
| Historik | Säkerhetsbeslut, verktygsåtgärder, destinationer och tidsstämplar som endast kan läggas till. |
| Inställningar | Utseende, språk, AI, verktyg, säkerhet, Workspace Profiles, genvägar, behörigheter, Help och Pro. |
Leverantörer och arbetsyteprofiler
QuickAgent kan använda System-AI när operativsystemet erbjuder en kompatibel funktion, lokala leverantörer som Ollama, LM Studio eller DeskLLM, LAN- eller anpassade OpenAI-kompatibla slutpunkter samt konfigurerade molnleverantörer som Anthropic eller Gemini. Tillgänglighet avgörs genom ett direkt funktionstest; enbart ett leverantörsnamn innebär inte att den är redo.
En arbetsyteprofil är körningens behörighetsram. Den sparar en ögonblicksbild av vald leverantör/modell, tillåtna verktyg, anslutningar, filrötter, kunskapskällor, minnesomfång, säkerhetsåsidosättningar och budget. En senare konfigurationsändring gör ögonblicksbilden inaktuell och kräver granskning.
Körningar, godkännanden och återställning
Körningskontroller
- Pausa begär ett samarbetsinriktat stopp vid en beständig kontrollpunkt.
- Återuppta fortsätter samma körning och slutfört arbete.
- Stoppa avbryter leverantörs- och verktygsarbete. En stoppad eller osäker extern effekt rapporteras inte som lyckad.
- Försök igen är endast tillgängligt när QuickAgent kan identifiera en säker gräns för nytt försök.
Säkerhetsnivåer
| Nivå | Betydelse |
|---|---|
| Säker | Läs, inspektera eller omvandla inom den aktiva profilen. |
| Godkänn | Granska en vanlig skrivåtgärd eller extern åtgärd. |
| Bekräfta | Granska en ändring med större påverkan eller som är svårare att återställa. |
| Kritisk | Stark bekräftelse varje gång; regler godkänner den aldrig automatiskt. |
Godkännandet visar exakt mål, destination, föreslagna argument, risk och Ångra-status. Om du redigerar ett argument validerar QuickAgent och riskkontrollerar den redigerade åtgärden igen.
Körningar med flera agenter
Komplexa mål kan använda en planerare, typade specialistarbetare, en granskare och en säkerhetsgranskare. Tidslinjen visar varje överlämning, granskning, nytt försök, reservlösning och gräns för slutsvar. Arbetare får endast fyrvägsskärningen av Skill-verktyg, arbetsyteprofilens verktyg, rollverktyg och verktyg som för närvarande är aktiva.
Globala budgetar och budgetar per roll begränsar anrop, tid, kostnad, nätverksbyte och token. När en budget nås pausar QuickAgent. Den visar aktuella och föreslagna gränser och höjer dem endast efter uttrycklig granskning. Den godkända budgeten och historiken över slutförda roller överlever en omstart.
Kontext, kunskap och AI-minne
Kontextfack
Lägg till filer, mappar, bilder, videobildrutor, ljud, röstanteckningar, QuickNote-innehåll, kunskap eller arbetsyteminne. QuickAgent extraherar eller sammanfattar innehåll som stöds och visar om en bilaga skickas direkt till en leverantör.
Knowledge
Kunskapskällor indexeras separat från chatten. En körning kan bara söka i källor som tillåts av dess arbetsyteprofil, och citeringar behåller källans identitet.
Minne
Minne är avsiktligt, inte automatisk chatthistorik. Omfång för användare, arbetsyta, projekt och verktyg/anslutning är separata. Varje begäran om att skapa, redigera eller ta bort får ett nytt godkännande, och förhandsvisningen visar omfånget och det exakta föreslagna värdet.
Verktyg och anslutningar
Den aktiva katalogen omfattar fil-/VFS-åtgärder; Office, PDF och strukturerade data; media och OCR; webbläsar- och datoranvändning; utvecklingskommandon; SSH; MCP; HTTP och SaaS; bryggor för smarta hem; aviseringar; scheman; övervakning; och automatiseringsstyrning. Anslutna MCP-servrar kan lägga till dynamiska verktyg efter schemavalidering och en förnyad riskbedömning för QuickAgent.
Inställningar > Verktyg visar varför ett verktyg är redo eller inaktiverat. Vanliga orsaker är en saknad anslutning, operativsystembehörighet, plattform som inte stöds, begränsning i arbetsyteprofilen, otestad slutpunkt eller otillgänglig leverantörsfunktion.
Automatiseringar
Automatiseringar kan startas av tids-, fil-/mapp-, webb-, webhook-, e-post-, kalender-, nätverks-, värd-, enhets-, sensor-, plats-, apphändelse-, Shortcut/App Intent-, kommando- eller manuella utlösare när plattformen stöder dem. En utlösare skapar en vanlig körning; den kringgår inte arbetsyteprofil, godkännande, Kritisk eller Data Send-kontroller.
- Skrivbordsövervakning fortsätter endast medan appprocessen körs.
- Mobila plattformar återupptar försenat arbete när appen återgår till förgrunden.
- Använd Shortcut/App Intent eller en betrodd händelserelä när leverans från operativsystemet krävs.
- Händelser i kö, paus, avbryt och borttagning förblir uttryckliga så att händelser inte tyst kasseras.
Skills och Skill Packs
En Skill lagrar en resultatinriktad prompt, typade variabler, leverantörsrekommendation, tillåtna verktyg, nödvändiga anslutningar och funktioner, maximal risk samt förväntade Artefakter. Före användning visar QuickAgent indata och effektiva behörigheter; förhandsvisningen beviljar i sig inte behörighet.
Sju inbyggda paket erbjuder verkliga Skills för Office, kodning, smarta hem, forskning, webbläsarautomatisering, personlig administration och incidenthantering. Du kan installera, uppdatera, avinstallera, anpassa, duplicera, importera och exportera Skills. Importerad JSON får en förhandsvisning av förtroende, utgivare, signatur, behörighet, risk, plattform och konflikter. ”Behåll båda” skapar en osignerad lokal härledning i stället för att ärva en annan utgivares förtroende.
Artefakter, historik och Ångra
Artefakter behåller utdata i byteformat, metadata, versioner, ursprung, källkörning och åtgärdsmanifest. Beroende på plattformens funktioner kan du öppna, dela, exportera eller visa dem. Kvalificerade åtgärder erbjuder ett granskat Ångra; destruktivt eller osäkert arbete spelas aldrig upp automatiskt igen.
Historiken är endast tilläggsbar. Filtrera den efter Säker, Godkänn, Bekräfta eller Kritisk och exportera granskningen när du behöver en extern post.
Inställningar
- Allmänt: utseende, språk, arbetsyteprofiler, genvägar, Hjälp och behörigheter.
- AI: leverantörer, slutpunkter, modeller, autentiseringsuppgifter och direkttester.
- Verktyg: katalogberedskap, plattformsstöd och orsaker till konfiguration.
- Säkerhet: godkännanderegler, Data Send-beteende, enhetsautentisering och minnesprincip med avgränsat omfång.
- Avancerat: återställning och diagnostik avsedd för felsökning.
Kortkommandon
I macOS kopplar appen den visade Ctrl genvägar till plattformens Command-tangent där det är lämpligt. Genvägssidan i appen är auktoritativ och stöder anpassning.
| Genväg | Åtgärd |
|---|---|
| Ctrl + N | New Chat |
| Ctrl + L | Fokusera inmatningsfältet |
| Ctrl + Shift + Mellanslag | Pausa eller återuppta den aktiva körningen |
| Ctrl + . | Stoppa den aktiva körningen |
| Ctrl + 1 … 9 | Öppna Chattar via Historik |
| Ctrl + , | Öppna Inställningar |
| F1 | Öppna Hjälp & Integritet |
| Esc | Stäng en dialogruta eller avbryt den aktuella icke-destruktiva interaktionen |
Plattformsanteckningar
| Plattform | Viktiga gränser |
|---|---|
| macOS | Sandboxad i Debug och Release. Filåtkomst använder valda rötter/säkerhetsomfångsbegränsade bokmärken. Skärminspelning och Tillgänglighet är separata systembehörigheter. Lokala process- och Shortcut-integreringar förblir funktionstestade. |
| Windows | Fil-, Office/PDF/data-, webbläsar-, utvecklings-, fjärr- och skrivbordskontrollfunktioner beror på installerad körtid och behörigheter. Integreringar som endast finns hos Apple är inte tillgängliga med en synlig förklaring. |
| iPhone / iPad | Filer använder systemväljaren. Kamera, mikrofon, tal, bilder, lokalt nätverk och aviseringar begärs i sitt sammanhang. Bakgrundsövervakning garanteras inte; använd Shortcuts/App Intents eller upphämtning i förgrunden. |
| Android | Filer och mappar använder Storage Access Framework. Bakgrundsarbete följer Android-begränsningar. Indatakontroll baserad på tillgänglighet betraktas aldrig som beviljad enbart för att en tjänst har deklarerats. |
| Webb | Använder lagring endast för sessionen för funktioner som kräver inbyggd beständighet och inaktiverar tydligt enhets-, filrot-, lokalprocess- och bakgrundsfunktioner som inte stöds. |
Tips & trick
Felsökning
| Problem | Vad du ska kontrollera |
|---|---|
| Leverantören kan inte köras | Öppna Inställningar > AI. Kontrollera konfiguration, autentisering, modellfunktion, slutpunktsåtkomlighet, tidsgräns och information om hastighetsbegränsning och kör sedan anslutningstestet. |
| Ett verktyg är inaktiverat | Öppna Inställningar > Verktyg och läs den aktuella orsaken. Granska aktuell plattform, behörighet, anslutningstest, arbetsyteprofil och vald rot. |
| En körning verkar ha fastnat | Öppna Körningar och Tidslinjen. Den kan vara pausad, invänta indata, godkännande, Kritisk bekräftelse, Data Send-granskning eller budgetgranskning. Stoppa är fortsatt tillgängligt. |
| En behörighet ändrades | Öppna Hjälp > Översikt eller Inställningar och öppna sedan systeminställningarna. Testa den berörda anslutningen eller verktyget igen efter att du har återvänt. |
| En extern åtgärd är osäker | Kontrollera målsystemet. Håll körningen pausad eller stoppa den om du inte har bekräftat att ett nytt försök är lämpligt. |
| En automatisering utlöstes inte i bakgrunden | Mobila operativsystem garanterar inte godtycklig polling. Återgå till förgrunden för upphämtning eller konfigurera en Shortcut/App Intent eller betrodd händelsekälla. |
| En Artefakt kan inte öppnas eller exporteras | Kontrollera om dess byte fortfarande är tillgängliga, om plattformen stöder åtgärden och om behörigheten för den valda destinationen fortfarande är giltig. |
Integritet, behörigheter och licenser
QuickAgent lagrar konversationer, körningar, godkännanden, kunskapsmetadata, Skills och inställningar lokalt. Autentiseringsuppgifter använder plattformsskyddad lagring. Innehåll lämnar enheten endast via en leverantör eller ansluten tjänst som du konfigurerar, och externa sändningar får en destinationsmedveten förhandsvisning.
Behörigheter begärs i sitt sammanhang: filer/mappar, bilder, kamera, mikrofon, taligenkänning, lokalt nätverk, aviseringar, skärminspelning och tillgänglighets-/indatakontroll är oberoende. Om en behörighet tas bort blir den berörda funktionen otillgänglig i stället för att ge ett falskt lyckat resultat.
Öppna Inställningar > Hjälp & Integritet för den aktuella plattformens funktionstabell och Licenser för öppen källkod för information om paket och medfödda komponenter.