QuickAgent Benutzerhandbuch
QuickAgent ist ein Local-First-Arbeitsbereich für KI-Agenten. Er verwandelt ein Ziel in einen dauerhaften Run, begrenzt diesen Run über ein Workspace-Profil, fragt vor sensiblen Aktionen nach Freigabe und bewahrt geprüfte Ergebnisse in Artefakten auf.
Erste Schritte
- Öffnen Sie Einstellungen > KI, fügen Sie einen Anbieter hinzu und führen Sie dessen Verbindungstest aus.
- Öffnen Sie Einstellungen > Workspace-Profile. Legen Sie fest, welcher Anbieter, welche Werkzeuge, Verbindungen, Dateiwurzeln, Wissensquellen und Memory-Bereiche verwendet werden dürfen.
- Wählen Sie Neuer Chat, wählen Sie das Profil und bestätigen Sie das über der Konversation angezeigte Anbieterziel.
- Beschreiben Sie ein Ergebnis. Fügen Sie nur die Dateien, Ordner, Medien, Wissensquellen oder Memory-Einträge hinzu, die dieser Run benötigt.
- Prüfen Sie Plan, Freigaben, kritische Bestätigungen und die Vorschau der Datenübermittlung, sobald sie erscheinen.
- Verfolgen Sie die Arbeit in der Zeitleiste. Öffnen Sie das fertige Ergebnis unter Artefakte und prüfen Sie den Prüfpfad in Verlauf.
Überblick über die Oberfläche
| Bereich | Wofür er da ist |
|---|---|
| Chats | Konversationen, Anbieterziel, Kontextleiste, Pläne, Freigaben und die aktive Run-Zeitleiste. |
| Runs | Jede geplante, laufende, pausierte, terminierte, fehlgeschlagene oder abgeschlossene Aufgabe. |
| Freigabe-Posteingang | Ausstehende Prüfungen zu Aktionen, kritischen Schritten und Datenübermittlungen, die Ihre Entscheidung brauchen. |
| Artefakte | Geprüfte Dateien, Berichte, Protokolle, Medien, Tabellen und Manifeste zu Vorgängen, die von Runs erzeugt wurden. |
| Automatisierungen | Zeitpläne, Überwachungen, Webhooks, App-Ereignisse sowie Auslöser über Shortcut/App Intent. |
| Skills | Wiederverwendbare Anweisungen mit typisierten Eingaben, erlaubten Werkzeugen, erforderlichen Verbindungen, Risikoeinstufung und Ausgaben. |
| Verbindungen | Anbieter, Browserprofile, Datei-/VFS-Wurzeln, SSH, MCP, HTTP/SaaS, Home-Bridges und Benachrichtigungskanäle. |
| Wissen | Indexierte Ordner, QuickNote-Inhalte, Web-Clips, PDFs und Office-Quellen. |
| Verlauf | Ausschließlich anfügbare Sicherheitsentscheidungen, Werkzeugaktionen, Ziele und Zeitstempel. |
| Einstellungen | Erscheinungsbild, Sprache, KI, Werkzeuge, Sicherheit, Workspace-Profile, Kurzbefehle, Berechtigungen, Hilfe und Pro. |
Anbieter und Workspace-Profile
QuickAgent kann System-KI nutzen, sofern das Betriebssystem eine kompatible Fähigkeit bereitstellt, dazu lokale Anbieter wie Ollama, LM Studio oder DeskLLM, LAN- oder eigene OpenAI-kompatible Endpunkte sowie eingerichtete Cloud-Anbieter wie Anthropic oder Gemini. Die Verfügbarkeit ergibt sich aus einem Live-Fähigkeitstest; ein Anbietername allein bedeutet noch nicht, dass er einsatzbereit ist.
Ein Workspace-Profil ist der Berechtigungsrahmen des Runs. Es hält Anbieter/Modell, erlaubte Werkzeuge, Verbindungen, Dateiwurzeln, Wissensquellen, Memory-Bereiche, Sicherheitsausnahmen und Budget als Momentaufnahme fest. Eine spätere Konfigurationsänderung macht die Momentaufnahme veraltet und erfordert eine erneute Prüfung.
Runs, Freigaben und Wiederherstellung
Steuerung eines Runs
- Pause fordert an einem dauerhaften Prüfpunkt einen kooperativen Halt an.
- Fortsetzen setzt denselben Run und die bereits erledigte Arbeit fort.
- Stopp bricht Anbieter- und Werkzeugarbeit ab. Eine gestoppte oder ungewisse externe Wirkung wird nicht als Erfolg gemeldet.
- Wiederholen steht nur zur Verfügung, wenn QuickAgent eine sichere Wiederholungsgrenze bestimmen kann.
Sicherheitsstufen
| Stufe | Bedeutung |
|---|---|
| Sicher | Lesen, prüfen oder umwandeln innerhalb des aktiven Profils. |
| Freigeben | Einen normalen Schreibvorgang oder eine externe Aktion prüfen. |
| Prüfen Sie, ob | Eine Änderung mit größerer Auswirkung oder schwererer Umkehrbarkeit prüfen. |
| Kritisch | Jedes Mal eine ausdrückliche Bestätigung; Regeln geben sie niemals automatisch frei. |
Die Freigabe zeigt genau das Ziel, den Bestimmungsort, die vorgeschlagenen Argumente, das Risiko und den Status des Rückgängigmachens. Wenn Sie ein Argument bearbeiten, prüft QuickAgent die geänderte Aktion erneut auf Gültigkeit und Risiko.
Multi-Agent-Runs
Komplexe Ziele können einen Planer, typisierte Fachkräfte, einen Prüfer und einen Sicherheitsprüfer einsetzen. Die Zeitleiste zeigt jede Übergabe, Prüfung, Wiederholung, Ausweichlösung und die Grenze zur endgültigen Antwort. Die Arbeitsagenten erhalten nur die Schnittmenge aus Skill-Werkzeugen, Werkzeugen des Workspace-Profils, Rollenwerkzeugen und derzeit aktiven Werkzeugen.
Globale und rollenbezogene Budgets begrenzen Aufrufe, Zeit, Kosten, Netzwerk-Bytes und Token. Ist ein Budget erreicht, pausiert QuickAgent. Es zeigt die aktuellen und vorgeschlagenen Grenzen und erhöht sie erst nach ausdrücklicher Prüfung. Das freigegebene Budget und der Verlauf abgeschlossener Rollen überstehen einen Neustart.
Kontext, Wissen und KI-Memory
Kontextleiste
Fügen Sie Dateien, Ordner, Bilder, Videobilder, Audio, Sprachnotizen, QuickNote-Inhalte, Wissensquellen oder Workspace-Memory hinzu. QuickAgent extrahiert oder fasst unterstützte Inhalte zusammen und zeigt an, ob ein Anhang direkt an einen Anbieter gesendet wird.
Wissen
Wissensquellen werden getrennt vom Chat indexiert. Ein Run kann nur die Quellen durchsuchen, die sein Workspace-Profil erlaubt, und Zitate behalten ihre Quellenzuordnung.
Memory
Memory ist bewusst gesetzt und kein automatischer Chatverlauf. Die Bereiche „Benutzer“, „Workspace“, „Projekt“ und „Werkzeug/Verbindung“ sind getrennt. Jede Anfrage zum Anlegen, Bearbeiten oder Löschen erhält eine neue Freigabe, und die Freigabevorschau zeigt den Bereich und den genauen vorgeschlagenen Wert.
Werkzeuge und Verbindungen
Der aktive Katalog umfasst Datei-/VFS-Vorgänge; Office, PDF und strukturierte Daten; Medien und OCR; Browser- und Computersteuerung; Entwicklungsbefehle; SSH; MCP; HTTP und SaaS; Smart-Home-Bridges; Benachrichtigungen; Zeitpläne; Überwachungen; sowie die Steuerung von Automatisierungen. Verbundene MCP-Server können nach Schemaprüfung und erneuter Risikobewertung durch QuickAgent dynamische Werkzeuge ergänzen.
Einstellungen > Werkzeuge zeigt, warum ein Werkzeug bereit oder deaktiviert ist. Häufige Gründe sind eine fehlende Verbindung, eine Berechtigung des Betriebssystems, eine nicht unterstützte Plattform, eine Einschränkung durch das Workspace-Profil, ein ungetesteter Endpunkt oder eine nicht verfügbare Anbieterfähigkeit.
Automatisierungen
Automatisierungen können durch Zeit, Datei/Ordner, Web, Webhook, E-Mail, Kalender, Netzwerk, Host, Gerät, Sensor, Standort, App-Ereignis, Shortcut/App Intent, Befehl oder manuell ausgelöst werden, sofern die Plattform dies unterstützt. Ein Auslöser erzeugt einen gewöhnlichen Run; er umgeht weder das Workspace-Profil noch Freigaben, kritische Bestätigungen oder Prüfungen der Datenübermittlung.
- Die Überwachung auf dem Desktop läuft nur, solange der App-Prozess aktiv ist.
- Mobile Plattformen holen überfällige Arbeit nach, sobald die App wieder in den Vordergrund kommt.
- Nutzen Sie Shortcut/App Intent oder ein vertrauenswürdiges Ereignis-Relay, wenn die Zustellung durch das Betriebssystem erforderlich ist.
- Eingereihte Ereignisse, Pause, Abbruch und Löschung bleiben ausdrücklich, damit keine Ereignisse stillschweigend verworfen werden.
Skills und Skill Packs
Ein Skill speichert eine ergebnisorientierte Anweisung, typisierte Variablen, eine Anbieterempfehlung, erlaubte Werkzeuge, erforderliche Verbindungen und Fähigkeiten, das maximale Risiko und die erwarteten Artefakte. Vor der Nutzung zeigt QuickAgent die Eingaben und die tatsächlichen Berechtigungen; die Vorschau selbst erteilt keine Berechtigung.
Sieben mitgelieferte Packs liefern echte Skills für Office, Programmierung, Smart Home, Recherche, Browser-Automatisierung, persönliche Verwaltung und Vorfallbearbeitung. Sie können Skills installieren, aktualisieren, deinstallieren, anpassen, duplizieren, importieren und exportieren. Importiertes JSON erhält eine Vorschau zu Vertrauensstatus, Herausgeber, Signatur, Berechtigungen, Risiko, Plattform und Konflikten. „Beide behalten“ erzeugt eine unsignierte lokale Ableitung, statt das Vertrauen eines anderen Herausgebers zu übernehmen.
Artefakte, Verlauf und Rückgängigmachen
Artefakte bewahren Ausgabebytes, Metadaten, Versionen, Herkunft, den auslösenden Run und Vorgangsmanifeste. Je nach Plattformfähigkeit können Sie sie öffnen, teilen, exportieren oder im Dateisystem anzeigen. Geeignete Vorgänge bieten ein geprüftes Rückgängigmachen; zerstörerische oder ungewisse Arbeit wird niemals automatisch wiederholt.
Der Verlauf ist ausschließlich anfügbar. Filtern Sie ihn nach Sicher, Freigeben, Bestätigen oder Kritisch und exportieren Sie den Prüfpfad, wenn Sie einen externen Nachweis benötigen.
Einstellungen
- Allgemein: Erscheinungsbild, Sprache, Workspace-Profile, Kurzbefehle, Hilfe und Berechtigungen.
- KI: Anbieter, Endpunkte, Modelle, Zugangsdaten und Live-Tests.
- Werkzeuge: Einsatzbereitschaft des Katalogs, Plattformunterstützung und Einrichtungsgründe.
- Sicherheit: Freigaberegeln, Verhalten bei Datenübermittlung, Geräteauthentifizierung und Memory-Richtlinie je Bereich.
- Erweitert: Wiederherstellung und Diagnose zur Fehlerbehebung.
Tastenkürzel
Unter macOS bildet die App die angezeigten Ctrl Kurzbefehle dort, wo es passt, auf die Command-Taste der Plattform ab. Maßgeblich ist die Kurzbefehlsseite in der App, die auch Anpassungen unterstützt.
| Kurzbefehl | Aktion |
|---|---|
| Ctrl + N | Neuer Chat |
| Ctrl + L | Den Eingabebereich fokussieren |
| Ctrl + Shift + Leertaste | Den aktiven Run pausieren oder fortsetzen |
| Ctrl + . | Den aktiven Run stoppen |
| Ctrl + 1 … 9 | Chats über den Verlauf öffnen |
| Ctrl + , | Einstellungen öffnen |
| F1 | Hilfe & Datenschutz öffnen |
| Esc | Einen Dialog schließen oder die aktuelle nicht zerstörerische Interaktion abbrechen |
Hinweise zu den Plattformen
| Plattform | Wichtige Grenzen |
|---|---|
| macOS | In Debug und Release in der Sandbox. Der Dateizugriff nutzt ausgewählte Wurzeln bzw. Security-Scoped Bookmarks. Bildschirmaufnahme und Bedienungshilfen sind getrennte Systemberechtigungen. Lokale Prozess- und Shortcut-Integrationen werden weiterhin auf ihre Fähigkeiten geprüft. |
| Windows | Funktionen für Dateien, Office/PDF/Daten, Browser, Entwicklung, Fernzugriff und Desktop-Steuerung hängen von der installierten Laufzeitumgebung und den Berechtigungen ab. Apple-spezifische Integrationen sind mit sichtbarer Begründung nicht verfügbar. |
| iPhone / iPad | Dateien werden über die Systemauswahl gewählt. Kamera, Mikrofon, Spracherkennung, Fotos, lokales Netzwerk und Benachrichtigungen werden im jeweiligen Zusammenhang angefragt. Hintergrundüberwachung ist nicht garantiert; nutzen Sie Shortcuts/App Intents oder das Nachholen im Vordergrund. |
| Android | Dateien und Ordner nutzen das Storage Access Framework. Arbeit im Hintergrund unterliegt den Einschränkungen von Android. Eine Eingabesteuerung über Bedienungshilfen gilt nie allein deshalb als erteilt, weil ein Dienst deklariert ist. |
| Web | Nutzt für Funktionen, die native Persistenz erfordern, einen nur für die Sitzung gültigen Speicher und deaktiviert nicht unterstützte Geräte-, Dateiwurzel-, lokale Prozess- und Hintergrundfähigkeiten deutlich sichtbar. |
Tipps & Tricks
Fehlerbehebung
| Problem | Was zu prüfen ist |
|---|---|
| Der Anbieter lässt sich nicht ausführen | Öffnen Sie Einstellungen > KI. Prüfen Sie Konfiguration, Authentifizierung, Modellfähigkeit, Erreichbarkeit des Endpunkts, Zeitüberschreitungen und Angaben zu Ratenbegrenzungen und führen Sie dann den Verbindungstest aus. |
| Ein Werkzeug ist deaktiviert | Öffnen Sie Einstellungen > Werkzeuge und lesen Sie den aktuellen Grund. Prüfen Sie die aktuelle Plattform, Berechtigung, den Verbindungstest, das Workspace-Profil und die gewählte Wurzel. |
| Ein Run scheint zu hängen | Öffnen Sie „Runs“ und die Zeitleiste. Er kann pausiert sein oder auf eine Eingabe, Freigabe, kritische Bestätigung, Prüfung der Datenübermittlung oder Budgetprüfung warten. „Stopp“ bleibt verfügbar. |
| Eine Berechtigung hat sich geändert | Öffnen Sie Hilfe > Überblick oder die Einstellungen und dann die Systemeinstellungen. Testen Sie die betroffene Verbindung oder das Werkzeug nach der Rückkehr erneut. |
| Eine externe Aktion ist ungewiss | Prüfen Sie das Zielsystem. Lassen Sie den Run pausiert oder stoppen Sie ihn, sofern Sie sich nicht vergewissert haben, dass ein erneuter Versuch angemessen ist. |
| Eine Automatisierung wurde im Hintergrund nicht ausgelöst | Mobile Betriebssysteme garantieren kein beliebiges Abfragen. Kehren Sie zum Nachholen in den Vordergrund zurück oder richten Sie einen Shortcut/App Intent bzw. eine vertrauenswürdige Ereignisquelle ein. |
| Ein Artefakt lässt sich nicht öffnen oder exportieren | Prüfen Sie, ob seine Bytes noch verfügbar sind, ob die Plattform die Aktion unterstützt und ob die Berechtigung für das gewählte Ziel noch gültig ist. |
Datenschutz, Berechtigungen und Lizenzen
QuickAgent speichert Konversationen, Runs, Freigaben, Wissens-Metadaten, Skills und Einstellungen lokal. Zugangsdaten liegen im plattformgeschützten Speicher. Inhalte verlassen das Gerät nur über einen Anbieter oder verbundenen Dienst, den Sie einrichten, und externe Übermittlungen erhalten eine Vorschau samt Zielangabe.
Berechtigungen werden im jeweiligen Zusammenhang angefragt: Dateien/Ordner, Fotos, Kamera, Mikrofon, Spracherkennung, lokales Netzwerk, Benachrichtigungen, Bildschirmaufnahme sowie Bedienungshilfen-/Eingabesteuerung sind voneinander unabhängig. Wird eine Berechtigung entzogen, ist die betroffene Fähigkeit nicht verfügbar, statt einen falschen Erfolg zu melden.
Öffnen Sie Einstellungen > Hilfe & Datenschutz für die aktuelle Tabelle der Plattformfähigkeiten und Open-Source-Lizenzen für Hinweise zu Paketen und mitgelieferten nativen Bestandteilen.