Przewodnik użytkownika QuickAgent
QuickAgent to przestrzeń robocza dla agentów AI działających przede wszystkim lokalnie. Zamienia cel w trwały Run, ogranicza ten Run profilem przestrzeni roboczej, prosi o przegląd przed wrażliwymi działaniami i przechowuje zweryfikowane wyniki w sekcji Artifacts.
Pierwsze kroki
- Otwórz Ustawienia > AI, dodaj dostawcę i uruchom test połączenia.
- Otwórz Ustawienia > Profile przestrzeni roboczej. Wybierz, który dostawca oraz jakie narzędzia, połączenia, katalogi główne plików, źródła Knowledge i zakresy Memory mogą być używane.
- Wybierz Nowy czat, wskaż profil i potwierdź dostawcę docelowego widocznego nad rozmową.
- Opisz oczekiwany rezultat. Dodaj tylko te pliki, foldery, multimedia, źródła Knowledge lub Memory, które są potrzebne w tym uruchomieniu.
- Przejrzyj plan, zatwierdzenia, potwierdzenie działań krytycznych oraz Data Send Preview, gdy się pojawią.
- Śledź pracę na osi czasu. Otwórz gotowy wynik w sekcji Artifacts i sprawdź ścieżkę audytu w Historia.
Przegląd interfejsu
| Sekcja | Do czego służy |
|---|---|
| Czaty | Rozmowy, dostawca docelowy, Context Tray, plany, zatwierdzenia i oś czasu aktywnego uruchomienia. |
| Uruchomienia | Wszystkie zadania zaplanowane, trwające, wstrzymane, umieszczone w harmonogramie, nieudane i zakończone. |
| Skrzynka zatwierdzeń | Oczekujące działania, przeglądy krytyczne i przeglądy Data Send wymagające Twojej decyzji. |
| Artifacts | Zweryfikowane pliki, raporty, dzienniki, multimedia, tabele i manifesty operacji utworzone przez uruchomienia. |
| Automatyzacje | Harmonogramy, monitory, webhooki, zdarzenia aplikacji oraz wyzwalacze Shortcut/App Intent. |
| Skills | Wielokrotnego użytku instrukcje z typowanymi danymi wejściowymi, dozwolonymi narzędziami, wymaganymi połączeniami, poziomem ryzyka i wynikami. |
| Połączenia | Dostawcy, profile przeglądarki, katalogi główne plików/VFS, SSH, MCP, HTTP/SaaS, mostki domowe i kanały powiadomień. |
| Knowledge | Zindeksowane foldery, treści QuickNote, wycinki z sieci, pliki PDF i źródła pakietu Office. |
| Historia | Wyłącznie dopisywane decyzje bezpieczeństwa, działania narzędzi, miejsca docelowe i znaczniki czasu. |
| Ustawienia | Wygląd, język, AI, narzędzia, bezpieczeństwo, profile przestrzeni roboczej, skróty, uprawnienia, Pomoc i Pro. |
Dostawcy i profile przestrzeni roboczej
QuickAgent może korzystać z systemowej AI, gdy system operacyjny udostępnia zgodną funkcję, z dostawców lokalnych takich jak Ollama, LM Studio czy DeskLLM, z punktów końcowych w sieci LAN lub własnych punktów zgodnych z OpenAI oraz ze skonfigurowanych dostawców chmurowych, takich jak Anthropic czy Gemini. O dostępności decyduje bieżący test możliwości; sama nazwa dostawcy nie oznacza, że jest gotowy.
Profil przestrzeni roboczej to koperta uprawnień danego uruchomienia. Zapisuje migawkę wybranego dostawcy i modelu, dozwolonych narzędzi, połączeń, katalogów głównych plików, źródeł Knowledge, zakresów Memory, wyjątków bezpieczeństwa i budżetu. Późniejsza zmiana konfiguracji sprawia, że migawka jest nieaktualna i wymaga ponownego przeglądu.
Uruchomienia, zatwierdzenia i odzyskiwanie
Sterowanie uruchomieniem
- Wstrzymaj — prosi o zgodne zatrzymanie w trwałym punkcie kontrolnym.
- Wznów — kontynuuje to samo uruchomienie i wykonaną już pracę.
- Stop — anuluje pracę dostawcy i narzędzi. Zatrzymany lub niepewny efekt zewnętrzny nie jest raportowany jako sukces.
- Ponów — jest dostępne tylko wtedy, gdy QuickAgent potrafi wskazać bezpieczną granicę ponowienia.
Poziomy bezpieczeństwa
| Poziom | Znaczenie |
|---|---|
| Bezpieczne | Odczytywanie, sprawdzanie lub przekształcanie w aktywnym profilu. |
| Zatwierdź | Sprawdź zwykły zapis lub działanie zewnętrzne. |
| Sprawdź, czy | Sprawdź zmianę o większym wpływie lub trudniejszą do cofnięcia. |
| Krytyczne | Za każdym razem wymagane jest silne potwierdzenie; reguły nigdy nie zatwierdzają tego automatycznie. |
Zatwierdzenie pokazuje dokładny cel, miejsce docelowe, proponowane argumenty, ryzyko i status Undo. Jeśli zmienisz argument, QuickAgent ponownie sprawdzi poprawność i ryzyko zmienionego działania.
Uruchomienia Multi-Agent
Złożone cele mogą korzystać z planisty, wyspecjalizowanych pracowników o określonych typach, recenzenta i recenzenta bezpieczeństwa. Oś czasu pokazuje każde przekazanie, recenzję, ponowienie, rozwiązanie awaryjne i granicę odpowiedzi końcowej. Pracownicy otrzymują wyłącznie czterokierunkowe przecięcie narzędzi Skill, narzędzi Workspace Profile, narzędzi roli i aktualnie dostępnych narzędzi.
Globalne budżety i budżety dla ról ograniczają liczbę wywołań, czas, koszt, bajty sieciowe i tokeny. Po osiągnięciu budżetu QuickAgent wstrzymuje pracę. Pokazuje bieżące i proponowane limity oraz zwiększa je wyłącznie po wyraźnej weryfikacji. Zatwierdzony budżet i historia ukończonych ról przetrwają ponowne uruchomienie.
Kontekst, wiedza i pamięć AI
Zasobnik kontekstu
Dodawaj pliki, foldery, obrazy, klatki wideo, dźwięk, notatki głosowe, zawartość QuickNote, wiedzę lub pamięć obszaru roboczego. QuickAgent wyodrębnia lub podsumowuje obsługiwaną zawartość i wskazuje, czy załącznik zostanie wysłany bezpośrednio do dostawcy.
Knowledge
Źródła wiedzy są indeksowane niezależnie od czatu. Run może przeszukiwać wyłącznie źródła dozwolone przez jego Workspace Profile, a cytaty zachowują tożsamość źródła.
Pamięć
Pamięć jest celowa, a nie automatyczną historią czatu. Zakresy użytkownika, obszaru roboczego, projektu i narzędzia/połączenia są oddzielne. Każde żądanie utworzenia, edycji lub usunięcia otrzymuje nowe zatwierdzenie, a podgląd zatwierdzenia pokazuje zakres i dokładną proponowaną wartość.
Narzędzia i połączenia
Katalog na żywo obejmuje operacje na plikach/VFS; Office, PDF i dane strukturalne; multimedia i OCR; użycie przeglądarki i komputera; polecenia programistyczne; SSH; MCP; HTTP i SaaS; mostki inteligentnego domu; powiadomienia; harmonogramy; monitory; oraz sterowanie automatyzacją. Połączone serwery MCP mogą dodawać dynamiczne narzędzia po walidacji schematu i ponownej ocenie ryzyka przez QuickAgent.
Settings > Tools pokazuje, dlaczego narzędzie jest gotowe lub wyłączone. Typowe powody to brak połączenia, uprawnienia systemu operacyjnego, nieobsługiwana platforma, ograniczenie Workspace Profile, nieprzetestowany punkt końcowy lub niedostępna funkcja dostawcy.
Automatyzacje
Automatyzacje mogą być uruchamiane przez czas, plik/folder, internet, webhook, e-mail, kalendarz, sieć, host, urządzenie, czujnik, lokalizację, zdarzenie aplikacji, Shortcut/App Intent, polecenie lub ręczne wyzwalacze, gdy platforma je obsługuje. Wyzwalacz tworzy zwykły Run; nie omija Workspace Profile, zatwierdzenia, kontroli Critical ani Data Send.
- Monitorowanie na komputerze działa tylko wtedy, gdy proces aplikacji jest uruchomiony.
- Platformy mobilne odzyskują zaległą pracę, gdy aplikacja wraca na pierwszy plan.
- Użyj Shortcut/App Intent lub zaufanego przekaźnika zdarzeń, gdy wymagane jest dostarczanie przez system operacyjny.
- Zdarzenia w kolejce, wstrzymywanie, anulowanie i usuwanie pozostają jawne, aby zdarzenia nie były po cichu odrzucane.
Skills i pakiety Skill
Skill przechowuje monit nastawiony na wynik, zmienne o określonych typach, rekomendację dostawcy, dozwolone narzędzia, wymagane połączenia i możliwości, maksymalne ryzyko oraz oczekiwane Artifacts. Przed użyciem QuickAgent pokazuje dane wejściowe i obowiązujące uprawnienia; sam podgląd nie przyznaje uprawnień.
Siedem wbudowanych pakietów zapewnia rzeczywiste Skills dla Office, programowania, inteligentnego domu, badań, automatyzacji przeglądarki, administracji osobistej i reagowania na incydenty. Możesz instalować, aktualizować, odinstalowywać, dostosowywać, duplikować, importować i eksportować Skills. Importowany JSON otrzymuje podgląd zaufania, wydawcy, podpisu, uprawnień, ryzyka, platformy i konfliktów. „Zachowaj oba” tworzy niepodpisaną lokalną pochodną zamiast dziedziczenia zaufania innego wydawcy.
Artifacts, historia i Undo
Artifacts zachowują bajty wyjściowe, metadane, wersje, pochodzenie, źródłowy Run i manifesty operacji. Zależnie od możliwości platformy możesz je otwierać, udostępniać, eksportować lub ujawniać. Kwalifikujące się operacje udostępniają sprawdzone Undo; niszcząca lub niepewna praca nigdy nie jest odtwarzana automatycznie.
Historia jest wyłącznie dopisywana. Filtruj ją według Safe, Approve, Confirm lub Critical i eksportuj audyt, gdy potrzebujesz zewnętrznego zapisu.
Ustawienia
- Ogólne: wygląd, język, Workspace Profiles, skróty, pomoc i uprawnienia.
- AI: dostawcy, punkty końcowe, modele, poświadczenia i testy na żywo.
- Narzędzia: gotowość katalogu, obsługa platformy i powody konfiguracji.
- Bezpieczeństwo: reguły zatwierdzania, zachowanie Data Send, uwierzytelnianie urządzenia i zakresowa polityka pamięci.
- Zaawansowane: odzyskiwanie i diagnostyka przeznaczone do rozwiązywania problemów.
Skróty klawiaturowe
W systemie macOS aplikacja mapuje wyświetlane skróty Ctrl na platformowy klawisz Command, gdy jest to właściwe. Strona Shortcuts w aplikacji jest wiążąca i obsługuje dostosowanie.
| Skrót | Działanie |
|---|---|
| Ctrl + N | Nowy czat |
| Ctrl + L | Ustaw fokus w polu tworzenia wiadomości |
| Ctrl + Shift + Space | Wstrzymaj lub wznów aktywny Run |
| Ctrl + . | Zatrzymaj aktywny Run |
| Ctrl + 1 … 9 | Otwórz Chats przez historię |
| Ctrl + , | Otwórz Settings |
| F1 | Otwórz Help & Privacy |
| Esc | Zamknij okno dialogowe lub anuluj bieżącą nieniszczącą interakcję |
Uwagi dotyczące platform
| Platforma | Ważne granice |
|---|---|
| macOS | Działa w piaskownicy w Debug i Release. Dostęp do plików korzysta z wybranych katalogów głównych/zakładek o zakresie bezpieczeństwa. Screen Recording i Accessibility są odrębnymi uprawnieniami systemowymi. Integracje z procesami lokalnymi i Shortcut pozostają testowane pod kątem możliwości. |
| Windows | Funkcje plików, Office/PDF/danych, przeglądarki, programowania, zdalne i sterowania pulpitem zależą od zainstalowanego środowiska wykonawczego i uprawnień. Integracje wyłącznie Apple są niedostępne z widocznym wyjaśnieniem. |
| iPhone / iPad | Pliki korzystają z systemowego selektora. Dostęp do kamery, mikrofonu, mowy, zdjęć, sieci lokalnej i powiadomień jest wymagany w odpowiednim kontekście. Monitorowanie w tle nie jest gwarantowane; użyj Shortcuts/App Intents lub nadrabiania na pierwszym planie. |
| Android | Pliki i foldery korzystają z Storage Access Framework. Praca w tle podlega ograniczeniom Android. Sterowanie wejściem oparte na Accessibility nigdy nie jest traktowane jako przyznane wyłącznie dlatego, że usługa została zadeklarowana. |
| Internet | Korzysta z pamięci tylko dla sesji w przypadku funkcji wymagających natywnej trwałości oraz wyraźnie wyłącza nieobsługiwane możliwości urządzenia, katalogu głównego plików, procesu lokalnego i tła. |
Porady & wskazówki
Rozwiązywanie problemów
| Problem | Co sprawdzić |
|---|---|
| Dostawca nie może uruchomić się | Otwórz Settings > AI. Sprawdź konfigurację, uwierzytelnianie, możliwości modelu, osiągalność punktu końcowego, limit czasu i szczegóły limitu szybkości, a następnie uruchom test połączenia. |
| Narzędzie jest wyłączone | Otwórz Settings > Tools i przeczytaj bieżący powód. Sprawdź aktualną platformę, uprawnienie, test połączenia, Workspace Profile i wybrany katalog główny. |
| Run wygląda na zablokowany | Otwórz Runs i Timeline. Może być wstrzymany, oczekiwać na dane wejściowe, zatwierdzenie, potwierdzenie Critical, sprawdzenie Data Send lub sprawdzenie budżetu. Stop pozostaje dostępne. |
| Uprawnienie zostało zmienione | Otwórz Help > Overview lub Settings, a następnie ustawienia systemowe. Po powrocie ponownie przetestuj dane połączenie lub narzędzie. |
| Działanie zewnętrzne jest niepewne | Sprawdź system docelowy. Pozostaw Run wstrzymany lub użyj Stop, chyba że potwierdziłeś, iż ponowienie jest właściwe. |
| Automatyzacja nie uruchomiła się w tle | Mobilne systemy operacyjne nie gwarantują dowolnego odpytywania. Wróć na pierwszy plan, aby nadrobić pracę, lub skonfiguruj Shortcut/App Intent albo zaufane źródło zdarzeń. |
| Artifact nie może zostać otwarty ani wyeksportowany | Sprawdź, czy jego bajty są nadal dostępne, czy platforma obsługuje to działanie oraz czy uprawnienie wybranego miejsca docelowego jest wciąż ważne. |
Prywatność, uprawnienia i licencje
QuickAgent przechowuje lokalnie rozmowy, Runs, zatwierdzenia, metadane Knowledge, Skills i ustawienia. Poświadczenia korzystają z magazynu chronionego przez platformę. Treść opuszcza urządzenie wyłącznie przez skonfigurowanego dostawcę lub połączoną usługę, a wysyłki zewnętrzne otrzymują podgląd uwzględniający miejsce docelowe.
Uprawnienia są wymagane w odpowiednim kontekście: pliki/foldery, zdjęcia, kamera, mikrofon, rozpoznawanie mowy, sieć lokalna, powiadomienia, nagrywanie ekranu oraz sterowanie dostępnością/wejściem są niezależne. Usunięcie uprawnienia powoduje niedostępność danej możliwości, a nie fałszywy sukces.
Otwórz Settings > Help & Privacy dla tabeli możliwości bieżącej platformy oraz Licencje open source dla informacji o pakietach i dołączonych komponentach natywnych.