Использование¶

Откройте панель через пункт меню AI Agent или значок на панели инструментов, наберите запрос, нажмите Enter. Shift+Enter переносит строку; пока агент работает, кнопка отправки превращается в «стоп».

Вопросы о проекте¶

Чтение выполняется сразу, без подтверждения:

какие у меня слои?
какие поля у слоя дорог и что лежит в highway?
сколько дорог типа motorway?
какая река самая длинная? — длина и площадь берутся из самой геометрии; отдельная колонка с длиной не нужна
почему города красные? — агент читает настоящий рендерер, а не угадывает

Изменения¶

Запись копится в карточку плана; Применить выполняет её, Отменить сбрасывает:

сделай реки синими / дороги — тонкие серые пунктирные линии
раскрась районы по населению, 7 классов, Viridis
подпиши города названиями, жирным, 12 пунктов, с белой обводкой — один шаг, а не четыре
построй буфер 500 м вокруг школ — на слое в градусах агент сам сначала перепроецирует
загрузи /data/roads.geojson в группу «Фон»
скачай кафе в Твери из OSM / дороги кроме грунтовых в текущем виде
обрежь дороги по границе города, посчитай длину и сохрани проект — целая цепочка ложится в одну карточку плана

Диалоги¶

Диалоги переживают перезапуск QGIS и привязаны к проекту: меню Диалоги показывает только начатые в открытом сейчас проекте. Заголовок — ваша первая реплика. Восстановление диалога возвращает и контекст модели: уточнение вроде а сколько их? продолжает работать.

Журналы прогонов¶

После прогона с применёнными изменениями в диалоге появляется путь к обычному Markdown-журналу. Он лежит в каталоге ai_agent_runs активного профиля QGIS, получает доступ только для владельца, где это поддерживается, и не удаляется плагином автоматически. Файл не шифруется. Точное содержимое и рекомендации по очистке приведены в разделе «Данные и конфиденциальность».

Когда что-то идёт не так¶

Ошибка инструмента не убивает прогон: агент читает её и исправляется сам — на неверное имя слоя он получает список настоящих.
Кнопка «стоп» немедленно прерывает прогон и сбрасывает запланированные изменения.
Overpass (сервис OSM) публичный и бывает занят; отказ — не поломка плагина: повторите позже или сузьте запрос.
Маленькая локальная модель (7–8B) будет путаться в вызовах. Осмысленный минимум — модель уровня 30B с поддержкой function calling.

Скиллы и слэш-команды¶

Скилл — это пакет знаний, который агент подгружает, когда задача заходит в его область: один SKILL.md с именем, однострочным описанием и правилами в Markdown. Двенадцать встроенных скиллов покрывают домены QGIS; можно добавлять свои.

Наберите / в чате — появится список. Выберите скилл стрелками и Tab, затем напишите запрос: /osm кафе в Казани загружает правила OSM ещё до первого хода модели, и агент начинает в нужном домене, а не обнаруживает его на ход позже. Голый /skill применяет скилл к текущему проекту.

Свои скиллы живут в профиле QGIS, в ai_agent_skills/<имя>/SKILL.md — Настройки → Скиллы показывают папку, открывают её и создают пример, от которого удобно отталкиваться. Во фронтматтере нужны name (строчные буквы, цифры, - или _) и description (та самая фраза, по которой модель выбирает скилл); необязательный список tools называет существующие инструменты, которые нужно взять с собой — правила их доменов загрузятся вместе с ними. Локальный скилл не может добавить Python-код: он учит агента вашим правилам, порядку шагов и подводным камням, и появляется в / и в собственном списке load_skill агента наравне со встроенными. Проблемы — нет имени, имя занято встроенным скиллом, неизвестный инструмент — перечисляются на той же странице настроек, а не глотаются молча.