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
Artifacts	Ожидающие вашего решения проверки действий, Critical и Data Send.
Проверенные файлы, отчёты, журналы, медиа, таблицы и манифесты операций, созданные Runs.	Automations
Расписания, мониторы, вебхуки, события приложения и триггеры Shortcut/App Intent.	Skills
Повторно используемые инструкции с типизированными входными данными, разрешёнными инструментами, необходимыми подключениями, риском и результатами.	Провайдеры, профили браузера, корневые папки файлов/VFS, SSH, MCP, HTTP/SaaS, мосты умного дома и каналы уведомлений.
Знания	Индексированные папки, содержимое QuickNote, веб-клипы, PDF и источники Office.
История	Неизменяемые записи о решениях по безопасности, действиях инструментов, назначениях и временных метках.
Настройки	Добавляемые только в конец решения по безопасности, действия инструментов, назначения и метки времени.

Внешний вид, язык, AI, инструменты, безопасность, Workspace Profiles, сочетания клавиш, разрешения, справка и Pro.

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

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

Правило назначения: QuickAgent никогда незаметно не переключается с провайдера на устройстве или локального провайдера в облако. Активное назначение остаётся видимым в Chat и при каждой проверке Data Send.

Runs, утверждения и восстановление

Управление Run

Пауза запрашивает согласованную остановку на надёжной контрольной точке.
Продолжить продолжает тот же Run и уже выполненную работу.
Остановить отменяет работу провайдера и инструментов. Остановленный или неопределённый внешний эффект не сообщается как успех.
Повторить доступно только тогда, когда QuickAgent может определить безопасную границу повтора.

Уровни безопасности

Уровень	Значение
Безопасно	Чтение, проверка или преобразование в рамках активного профиля.
Утвердить	Проверьте обычную запись или внешнее действие.
Убедитесь, что	Проверьте изменение с более серьёзными последствиями или более сложной отменой.
Critical	Строгое подтверждение каждый раз; правила никогда не утверждают его автоматически.

В утверждении отображаются точная цель, назначение, предлагаемые аргументы, риск и статус Undo. Если вы измените аргумент, QuickAgent снова проверит и оценит риск изменённого действия.

Неопределённый результат: после прерывания сначала проверьте целевую систему. Выбирайте «Я проверил — повторить» только когда повтор действия уместен. Одно лишь «Продолжить» никогда не повторяет неопределённый внешний эффект.

Multi-Agent Runs

Для сложных целей можно использовать планировщик, типизированных специалистов, рецензента и специалиста по безопасности. Timeline показывает каждую передачу, проверку, повтор, резервный вариант и границу окончательного ответа. Исполнители получают только пересечение четырёх наборов: инструменты Skill, инструменты Workspace Profile, инструменты роли и доступные в данный момент инструменты.

Глобальные и ролевые бюджеты ограничивают вызовы, время, стоимость, сетевые байты и токены. При исчерпании бюджета QuickAgent приостанавливается. Он показывает текущие и предлагаемые лимиты и увеличивает их только после явной проверки. Утверждённый бюджет и история завершённых ролей сохраняются после перезапуска.

Context, Knowledge и AI Memory

Context Tray

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

Знания

Источники 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. Мобильные платформы не предоставляют такого же неограниченного управления настольным компьютером.

Проверенные файлы, отчёты, журналы, медиа, таблицы и манифесты операций, созданные Runs.

Automations могут запускаться по времени, файлу/папке, веб-событию, вебхуку, электронной почте, календарю, сети, хосту, устройству, датчику, местоположению, событию приложения, Shortcut/App Intent, команде или вручную, если платформа это поддерживает. Триггер создаёт обычный Run; он не обходит проверки Workspace Profile, утверждения, Critical или Data Send.

Мониторинг на настольном устройстве продолжается только пока работает процесс приложения.
Мобильные платформы возобновляют просроченную работу, когда приложение возвращается на передний план.
Используйте Shortcut/App Intent или доверенную ретрансляцию событий, если требуется доставка операционной системой.
События в очереди, пауза, отмена и удаление остаются явными, поэтому события не отбрасываются незаметно.

Skills и Skill Packs

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

Семь встроенных Packs содержат полноценные Skills для Office, Coding, Smart Home, Research, Browser Automation, Personal Admin и Incident Response. Вы можете устанавливать, обновлять, удалять, настраивать, дублировать, импортировать и экспортировать Skills. Импортированный JSON получает предварительный просмотр доверия, издателя, подписи, разрешений, риска, платформы и конфликтов. «Keep both» создаёт неподписанную локальную производную версию, а не наследует доверие другого издателя.

Artifacts, History и Undo

Artifacts сохраняют выходные байты, метаданные, версии, происхождение, исходный Run и манифесты операций. В зависимости от возможностей платформы вы можете открывать, предоставлять, экспортировать или показывать их. Для подходящих операций доступен проверенный Undo; разрушительные или неопределённые действия никогда не воспроизводятся автоматически.

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

Настройки

Общие: внешний вид, язык, Workspace Profiles, сочетания клавиш, Help и разрешения.
AI: провайдеры, конечные точки, модели, учётные данные и проверки в реальном времени.
Инструменты: готовность каталога, поддержка платформы и причины настройки.
Безопасность: правила утверждения, поведение Data Send, аутентификация устройства и политика Memory с областями действия.
Дополнительно: восстановление и диагностика для устранения неполадок.

Сочетания клавиш

В 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 confirmation, проверки Data Send или проверки бюджета. Stop остаётся доступным.
Разрешение изменилось	Откройте Help > Overview или Settings, затем системные настройки. После возврата повторно проверьте затронутое подключение или инструмент.
Внешнее действие имеет неопределённый результат	Проверьте целевую систему. Оставьте Run на паузе или остановите его, если не убедились, что повтор уместен.
Automation не сработала в фоновом режиме	Мобильные операционные системы не гарантируют произвольный опрос. Вернитесь на передний план для обработки накопившегося или настройте Shortcut/App Intent либо доверенный источник событий.
Artifact невозможно открыть или экспортировать	Проверьте, доступны ли ещё его байты, поддерживает ли платформа действие и действительно ли разрешение выбранного назначения.

Конфиденциальность, разрешения и лицензии

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

Разрешения запрашиваются по контексту: файлы/папки, фотографии, камера, микрофон, распознавание речи, локальная сеть, уведомления, запись экрана и управление доступностью/вводом независимы. Отзыв разрешения делает затронутую возможность недоступной, а не создаёт ложный успех.

Откройте Settings > Help & Privacy для таблицы возможностей текущей платформы и Лицензии с открытым исходным кодом для уведомлений о пакетах и встроенных нативных компонентах.

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