QuickAgent - Посібник

Посібник користувача QuickAgent

QuickAgent — це локальний робочий простір для AI-агентів. Він перетворює мету на надійний Run, обмежує цей Run за допомогою Workspace Profile, запитує перевірку перед чутливими діями та зберігає перевірені результати в Artifacts.

Початок роботи

Відкрийте Settings > AI, додайте постачальника та запустіть перевірку його підключення.
Відкрийте Settings > Workspace Profiles. Виберіть, які постачальники, інструменти, підключення, кореневі каталоги файлів, джерела Knowledge та області Memory можна використовувати.
Виберіть New Chat, оберіть профіль і підтвердьте призначення постачальника, показане над розмовою.
Опишіть результат. Додавайте лише файли, папки, медіа, Knowledge або Memory, потрібні для цього Run.
Перегляньте план, схвалення, Critical confirmation і Data Send Preview, коли вони з’являться.
Відстежуйте роботу в Timeline. Відкрийте завершений результат із Artifacts і перегляньте журнал аудиту в Історія.

Порада: Почніть із вузького Workspace Profile. Розширюйте його інструменти або кореневі каталоги лише тоді, коли QuickAgent покаже конкретну причину недоступності.

Огляд інтерфейсу

Розділ	Для чого він призначений
Chats	Розмови, призначення постачальника, Context Tray, плани, схвалення та Timeline активного Run.
Runs	Усі заплановані, запущені, призупинені, заплановані за розкладом, невдалі або завершені завдання.
Approval Inbox	Перевірки очікуваних дій, Critical і Data Send, що потребують вашого рішення.
Artifacts	Перевірені файли, звіти, журнали, медіа, таблиці та маніфести операцій, створені Runs.
Automations	Розклади, монітори, вебхуки, події програм і тригери Shortcut/App Intent.
Skills	Багаторазові інструкції з типізованими вхідними даними, дозволеними інструментами, необхідними підключеннями, рівнем ризику та результатами.
Connections	Постачальники, профілі браузера, кореневі каталоги файлів/VFS, SSH, MCP, HTTP/SaaS, домашні мости та канали сповіщень.
Knowledge	Індексовані папки, вміст QuickNote, вебвирізки, PDF-файли та джерела Office.
Історія	Рішення щодо безпеки, дії інструментів, призначення та позначки часу, що лише додаються.
Налаштування	Вигляд, мова, AI, інструменти, безпека, Workspace Profiles, комбінації клавіш, дозволи, Help і Pro.

Постачальники та Workspace Profiles

QuickAgent може використовувати System AI, якщо операційна система надає сумісну можливість, локальних постачальників, як-от Ollama, LM Studio або DeskLLM, LAN чи користувацькі кінцеві точки, сумісні з OpenAI, а також налаштованих хмарних постачальників, як-от Anthropic або Gemini. Доступність визначається перевіркою можливостей у реальному часі; сама лише назва постачальника не означає, що він готовий.

Workspace Profile — це оболонка дозволів Run. Він фіксує вибраного постачальника/модель, дозволені інструменти, підключення, кореневі каталоги файлів, джерела Knowledge, області Memory, перевизначення безпеки та бюджет. Подальша зміна конфігурації робить цей знімок застарілим і потребує перевірки.

Правило призначення: QuickAgent ніколи непомітно не перемикається з постачальника на пристрої або локального постачальника в хмару. Активне призначення залишається видимим у Chat і в кожній перевірці Data Send.

Runs, схвалення та відновлення

Елементи керування Run

Pause надсилає запит на узгоджену зупинку в надійній контрольній точці.
Resume продовжує той самий Run і завершену роботу.
Зупинити скасовує роботу постачальника та інструментів. Зупинений або невизначений зовнішній результат не позначається як успішний.
Retry доступний лише тоді, коли QuickAgent може визначити безпечну межу повторної спроби.

Рівні безпеки

Рівень	Значення
Safe	Читання, перевірка або перетворення в межах активного профілю.
Approve	Перевірте звичайну операцію запису або зовнішню дію.
Переконайтеся, що	Перевірте зміну з вищим впливом або таку, яку складніше скасувати.
Critical	Надійне підтвердження щоразу; правила ніколи не схвалюють його автоматично.

Схвалення показує точну ціль, призначення, запропоновані аргументи, ризик і стан Undo. Якщо ви редагуєте аргумент, QuickAgent знову перевіряє та оцінює ризик відредагованої дії.

Невизначений результат: після переривання спочатку перевірте цільову систему. Обирайте “Я перевірив — повторити” лише тоді, коли повторення дії доречне. Саме по собі “Resume” ніколи не повторює невизначену зовнішню дію.

Запуски з кількома агентами

Для складних цілей можуть використовуватися планувальник, типізовані спеціалізовані виконавці, рецензент і рецензент безпеки. Timeline показує кожну передачу роботи, перевірку, повторну спробу, резервний варіант і межу фінальної відповіді. Виконавці отримують лише чотиристоронній перетин інструментів Skill, інструментів Workspace Profile, інструментів ролі та доступних на цей момент інструментів.

Глобальні та рольові бюджети обмежують кількість викликів, час, вартість, байти мережі й токени. Коли бюджет вичерпано, QuickAgent призупиняється. Він показує поточні та запропоновані межі й збільшує їх лише після явної перевірки. Схвалений бюджет та історія завершених ролей зберігаються після перезапуску.

Контекст, Knowledge і пам’ять AI

Context Tray

Додавайте файли, папки, зображення, кадри відео, аудіо, голосові нотатки, вміст QuickNote, Knowledge або Workspace Memory. QuickAgent витягує чи підсумовує підтримуваний вміст і показує, чи буде вкладення надіслано безпосередньо постачальнику.

Knowledge

Джерела Knowledge індексуються окремо від чату. Run може шукати лише в джерелах, дозволених його Workspace Profile, а цитати зберігають ідентичність свого джерела.

Memory

Memory є навмисною функцією, а не автоматичною історією чату. Області User, Workspace, Project і Tool/Connection є окремими. Кожен запит на створення, редагування чи видалення отримує нове схвалення, а попередній перегляд схвалення показує область і точне запропоноване значення.

Інструменти та підключення

Каталог у реальному часі охоплює операції з файлами/VFS; Office, PDF і структуровані дані; медіа й OCR; використання браузера та комп’ютера; команди розробки; SSH; MCP; HTTP і SaaS; мости розумного дому; сповіщення; розклади; монітори; та керування автоматизацією. Підключені сервери MCP можуть додавати динамічні інструменти після перевірки схеми та повторної оцінки ризику QuickAgent.

Settings > Tools показує, чому інструмент готовий або вимкнений. Типові причини: відсутнє підключення, дозвіл операційної системи, непідтримувана платформа, обмеження Workspace Profile, неперевірена кінцева точка або недоступна можливість постачальника.

Використання комп’ютера: захоплення екрана та керування доступністю/введенням — це окремі дозволи. Тримайте видимий попередній перегляд і аварійну кнопку Stop доступними. Мобільні платформи не надають такого самого необмеженого керування комп’ютером, як настільні.

Automations

Автоматизації можуть запускатися за часом, через файл/папку, веб, вебхук, електронну пошту, календар, мережу, хост, пристрій, датчик, місцезнаходження, подію програми, Shortcut/App Intent, команду або вручну, якщо це підтримує платформа. Тригер створює звичайний Run; він не обходить перевірки Workspace Profile, схвалення, Critical або Data Send.

Моніторинг на комп’ютері триває лише доки запущений процес програми.
Мобільні платформи відновлюють прострочену роботу, коли програма повертається на передній план.
Використовуйте Shortcut/App Intent або надійне реле подій, коли потрібна доставка від операційної системи.
Події в черзі, призупинення, скасування та видалення залишаються явними, щоб події не відкидалися непомітно.

Skills і пакети Skills

Skill зберігає запит, зосереджений на результаті, типізовані змінні, рекомендацію постачальника, дозволені інструменти, необхідні підключення та можливості, максимальний ризик і очікувані Artifacts. Перед використанням QuickAgent показує вхідні дані та чинні дозволи; сам попередній перегляд не надає дозволу.

Сім вбудованих пакетів надають практичні Skills для Office, кодування, розумного дому, досліджень, автоматизації браузера, особистого адміністрування та реагування на інциденти. Ви можете встановлювати, оновлювати, видаляти, налаштовувати, дублювати, імпортувати й експортувати Skills. Імпортований JSON отримує попередній перегляд довіри, видавця, підпису, дозволу, ризику, платформи та конфлікту. “Зберегти обидва” створює непідписану локальну похідну версію замість успадкування довіри іншого видавця.

Artifacts, History і Undo

Artifacts зберігають байти виводу, метадані, версії, походження, вихідний Run і маніфести операцій. Залежно від можливостей платформи ви можете їх відкрити, поширити, експортувати або показати у файловому менеджері. Придатні операції надають перевірений Undo; руйнівна або невизначена робота ніколи не відтворюється автоматично.

History лише доповнюється. Фільтруйте його за Safe, Approve, Confirm або Critical та експортуйте аудит, коли потрібен зовнішній запис.

Налаштування

Загальні: вигляд, мова, Workspace Profiles, комбінації клавіш, Help і дозволи.
AI: постачальники, кінцеві точки, моделі, облікові дані та перевірки в реальному часі.
Tools: готовність каталогу, підтримка платформи та причини налаштування.
Safety: правила схвалення, поведінка Data Send, автентифікація пристрою та політика Memory з обмеженою областю.
Advanced: відновлення й діагностика, призначені для усунення несправностей.

Комбінації клавіш

У macOS програма зіставляє відображені Ctrl комбінації клавіш із клавішею Command платформи, де це доречно. Сторінка Shortcuts у програмі є остаточним джерелом і підтримує налаштування.

Комбінація	Дія
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	Перемістити фокус до поля введення
`Ctrl` + `Shift` + `Space`	Призупинити або відновити активний Run
`Ctrl` + `.`	Зупинити активний Run
`Ctrl` + `1` … `9`	Відкрити Chats через History
`Ctrl` + `,`	Відкрити Settings
`F1`	Відкрити Help & Privacy
`Esc`	Закрити діалогове вікно або скасувати поточну неруйнівну взаємодію

Примітки щодо платформ

Платформа	Важливі обмеження
macOS	Ізольовано в Debug і Release. Доступ до файлів використовує вибрані кореневі каталоги/закладки з обмеженою областю безпеки. Screen Recording і Accessibility — окремі системні дозволи. Інтеграції з локальними процесами та Shortcut залишаються перевіреними на рівні можливостей.
Windows	Можливості роботи з файлами, Office/PDF/даними, браузером, розробкою, віддаленим доступом і керуванням комп’ютером залежать від установленого середовища виконання та дозволів. Інтеграції лише для Apple недоступні з видимим поясненням.
iPhone / iPad	Для файлів використовується системний засіб вибору. Доступ до камери, мікрофона, мовлення, фото, локальної мережі та сповіщень запитується в контексті. Фоновий моніторинг не гарантується; використовуйте Shortcuts/App Intents або відновлення на передньому плані.
Android	Для файлів і папок використовується Storage Access Framework. Фонова робота відповідає обмеженням Android. Керування введенням на основі Accessibility ніколи не вважається наданим лише тому, що службу оголошено.
Web	Використовує сховище лише на час сеансу для функцій, яким потрібна нативна постійність, і чітко вимикає непідтримувані можливості пристрою, кореневих каталогів файлів, локальних процесів і фонової роботи.

Поради & підказки

Почніть із вузького Workspace Profile та додавайте інструмент, підключення або кореневий каталог файлів лише тоді, коли Run покаже конкретну вимогу.

Надавайте кожному запиту чіткий результат, очікуваний Artifact і межу перевірки, щоб перебіг роботи було легко перевіряти.

Використовуйте Knowledge для багаторазових індексованих джерел, а Context — для матеріалу, потрібного лише поточному Run.

Коли зовнішній результат невизначений, перевірте призначення перед повторною спробою; Resume ніколи не повторює його автоматично.

Усунення несправностей

Проблема	Що перевірити
Постачальник не може виконати	Відкрийте Settings > AI. Перевірте конфігурацію, автентифікацію, можливості моделі, доступність кінцевої точки, параметри часу очікування та обмеження швидкості, а потім запустіть перевірку підключення.
Інструмент вимкнено	Відкрийте Settings > Tools і прочитайте причину в реальному часі. Перевірте поточну платформу, дозвіл, перевірку підключення, Workspace Profile і вибраний кореневий каталог.
Run здається завислим	Відкрийте Runs і Timeline. Він може бути призупинений, очікувати на введення, схвалення, підтвердження Critical, перевірку Data Send або перегляд бюджету. Stop залишається доступною.
Дозвіл змінився	Відкрийте Help > Overview або Settings, а потім відкрийте системні налаштування. Після повернення повторно перевірте відповідне підключення або інструмент.
Зовнішня дія є невизначеною	Перевірте цільову систему. Залиште Run призупиненим або зупиніть його, якщо не переконалися, що повторна спроба доречна.
Автоматизація не спрацювала у фоновому режимі	Мобільні операційні системи не гарантують довільне опитування. Поверніться на передній план для надолуження або налаштуйте Shortcut/App Intent чи надійне джерело подій.
Artifact не вдається відкрити або експортувати	Перевірте, чи його байти все ще доступні, чи платформа підтримує цю дію та чи дозвіл для вибраного призначення досі чинний.

Конфіденційність, дозволи та ліцензії

QuickAgent локально зберігає розмови, Runs, схвалення, метадані Knowledge, Skills і налаштування. Облікові дані використовують захищене платформою сховище. Вміст залишає пристрій лише через налаштованого вами постачальника або підключену службу, а зовнішні надсилання отримують попередній перегляд із урахуванням призначення.

Дозволи запитуються в контексті: файли/папки, фотографії, камера, мікрофон, розпізнавання мовлення, локальна мережа, сповіщення, запис екрана та керування спеціальними можливостями/введенням є незалежними. Відкликання дозволу робить відповідну можливість недоступною, а не створює хибне враження успіху.

Відкрийте Settings > Help & Privacy для таблиці можливостей поточної платформи та Ліцензії з відкритим кодом для повідомлень про пакети та вбудовані нативні компоненти.

Free та Pro: усі функції агента доступні у Free. Семиденна пробна версія не містить реклами; після цього на мобільних пристроях може відображатися реклама, а на комп’ютерах — щоденне нагадування. Pro прибирає ці повідомлення за річною підпискою або разовою довічною покупкою.