Перейти к содержанию

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

Откройте панель из меню AI Agent или значком на панели инструментов, напишите запрос и нажмите Enter (Shift+Enter — новая строка). Пока агент работает, кнопка отправки становится кнопкой остановки; Esc тоже останавливает прогон. Сообщение, написанное во время прогона, уходит агенту как поправка.

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

Вопросы выполняются сразу, без подтверждения. Над ответом свёрнутый список показывает каждый шаг агента и что он нашёл; щёлкните, чтобы раскрыть.

  • какие у меня слои?
  • какие поля у слоя дорог и что лежит в highway?
  • какая река самая длинная? (длины и площади берутся из геометрии)
  • почему города красные? (агент читает настоящий стиль)

Изменения

Изменения собираются в карточку плана, по одному пронумерованному шагу на изменение. Применить выполняет их; Отменить сбрасывает, а Вернуть план возвращает их, пока вы не отправили новое сообщение. После применения карточка предлагает Откатить: проект вернётся в состояние до этого применения.

  • сделай реки синими
  • раскрась районы по населению, 7 классов, Viridis
  • подпиши города названиями, жирным, 12 pt, с белым ореолом
  • построй буфер 500 м вокруг школ (на слое в градусах агент сначала перепроецирует)
  • скачай кафе в Твери из OSM
  • обрежь дороги по границе города, посчитай длину и сохрани проект (вся цепочка в одной карточке плана)

Долгие шаги, например алгоритмы Processing и загрузки, идут в фоне. QGIS остаётся отзывчивым, шаг показывает прогресс, а ■ останавливает его и шаги после него. После применения агент проверяет результат и предлагает исправления, если что-то не получилось.

Вопросы от агента

Когда агенту нужно решение, например какой из двух похожих слоёв взять, он спрашивает в карточке: до трёх вариантов ответа и строка для своего. Щёлкните ответ или нажмите его номер. Прогон продолжится с вашим ответом.

Режимы

Кнопка режима в поле ввода переключает три режима. Shift+Tab перебирает их по кругу.

  • Спрашивать (по умолчанию): каждый план ждёт «Применить».
  • Авто: планы применяются сами, включая веб-вызовы. Планы, которые правят или удаляют данные на месте, выполняют Python или код другого плагина, по-прежнему ждут «Применить» и спрашивают ещё раз.
  • План: агент только читает и отвечает нумерованным планом. Выполнить с подтверждением выполняет его в режиме «Спрашивать», Выполнить автоматически — в режиме «Авто».

Поле ввода

  • Наберите /, чтобы выбрать навык: /osm кафе в Казани загружает правила OSM до первого шага.
  • Наберите @, чтобы вставить точное имя слоя, например @rivers или @"Main roads".
  • Слой, выбранный в QGIS, показан над текстом. Новый запрос относится к нему, так что раскрась этот слой работает. Нажмите ×, чтобы его не учитывать.
  • + добавляет слой, файл или таблицу, картинку или навык. Точка на карте… и Область на карте… позволяют щёлкнуть точку или протянуть прямоугольник; место попадает в запрос как @point(lon, lat) или @area(west, south, east, north).

Приложенные или перетащенные ГИС-файлы (GeoPackage, shapefile, GeoJSON, CSV, GeoTIFF и другие) сразу добавляются в проект и упоминаются в запросе. CSV со столбцами lon/lat или x/y в градусах становится точками, любой другой CSV — таблицей. Картинки (PNG, JPEG, WebP, GIF, BMP) уходят модели со следующим запросом; картинка с файлом привязки добавляется слоем.

Разговоры

Разговоры сохраняются в профиле QGIS и привязаны к проекту. Щёлкните название разговора сверху, чтобы увидеть историю этого проекта; + или Ctrl+N (⌘N) в поле ввода начинает новый. Наведите курсор на разговор, чтобы переименовать или удалить его. Открытый заново разговор сохраняет контекст модели, так что уточняющие вопросы работают.

Откат

Наведите курсор на своё сообщение и щёлкните изогнутую стрелку, чтобы вернуться к моменту до него. Выберите Разговор и проект, Только разговор или Только проект. Для проекта восстанавливается снимок, сделанный перед применением; QGIS хранит последние десять, пока работает. Изменения, записанные в источники данных, не откатываются.

Контекстное окно

Кольцо рядом с именем модели показывает, какую долю контекстного окна модели занял последний запрос. Щёлкните его, чтобы увидеть подробности и кнопку Сжать: она заменяет для модели старые сообщения сводкой. В чате остаются все сообщения. При 90 % окна разговор сжимается сам.

Что добавляют навыки

Рисование

Поставь точку 55.75, 37.62 или проведи линию от Москвы до Казани создаёт настоящие объекты во временном слое. Пара чисел читается широтой вперёд. Название места сначала геокодируется, а это спрашивает согласия. Временные слои живут в памяти до закрытия QGIS; попросите экспортировать слой, чтобы его сохранить.

Таблицы и соединения

Агент показывает содержимое CSV (разделитель, кодировку, типы столбцов, первые строки), загружает его точками или соединяет со слоем по ключевому полю. Соединение живое: ничего не копируется. Соединение, где не совпал ни один ключ, отклоняется с причиной, например текст против чисел или ведущие нули.

SQL

Сколько школ в каждом районе? выполняет один SELECT по слоям проекта и ничего не меняет. Сделай слой районов с числом школ сохраняет тот же запрос живым виртуальным слоем. Выполняются только читающие запросы.

Открытые данные

Найди безоблачный снимок Sentinel-2 этого района за июль ищет в Microsoft Planetary Computer; загрузи самый чистый добавляет его. Landsat, модели рельефа и покрытие земли работают так же. Добавь регионы Кении загружает geoBoundaries; слои Natural Earth и публичные картографические сервисы (NASA GIBS, OpenTopoMap, национальные сервисы) в том же каталоге. Каждая загрузка сначала спрашивает. Настройки → Коннекторы включают и выключают источники.

Диаграммы

Диаграмма населения по районам, гистограмма площадей участков или таблица десяти крупнейших городов рисует диаграмму или таблицу в чате. Щёлкните правой кнопкой, чтобы скопировать картинку или данные в CSV. Модель получает только числа.

Другие плагины

Агент может запускать алгоритмы Processing установленных плагинов как шаги плана. Команда меню плагина выполняется только после подтверждения. Если ничего подходящего не установлено, агент может найти плагин в официальном репозитории и установить его после двух подтверждений; удаляется он в Модули → Управление модулями.

Свои навыки

Навык — это файл SKILL.md с именем, описанием в одну строку и правилами. Свои навыки кладите в профиль QGIS в ai_agent_skills/<name>/SKILL.md. Настройки → Навыки открывает папку, создаёт пример и показывает ошибки. Локальный навык может называть существующие инструменты, но не может добавить код. Любой навык, встроенный или ваш, там же можно выключить.

Настройки

  • Подключение: провайдер, адрес, модель и ключ. См. установку.
  • Приватность: куда уходят данные, проверка SSL, сколько хранить разговоры, журнал прогона (по умолчанию выключен), статистика использования и Удалить историю и журналы. См. «Данные и конфиденциальность».
  • Дополнительно: проверка после применения, бюджет токенов, шагов за прогон (по умолчанию 40), таймаут инструмента (120 с), контекстное окно, рассуждение, формат API и дополнительные заголовки. Сбросить настройки агента возвращает значения по умолчанию, но оставляет подключение, ключи и ваши тексты.
  • Персонализация: обращение к вам, длина и язык ответов, единицы, тема панели, постоянные инструкции и заметки памяти. Всё это уходит модели с каждым запросом.
  • Навыки, Коннекторы и Геокодирование: см. выше.

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

  • Ошибка инструмента не заканчивает прогон; агент читает её и исправляется.
  • Остановка или сбой сохраняют написанную часть ответа, возвращают запрос в поле ввода и всё равно предлагают подготовленные изменения.
  • Неудачный шаг отмечается в плане с причиной, а шаги после него не выполняются.
  • Неудачный запрос к модели показывает карточку с причиной и, где это помогает, кнопкой Повторить. Занятой модели запрос повторяется автоматически.
  • Overpass, сервис OpenStreetMap, иногда перегружен. Повторите позже или сузьте область.
  • Маленькие локальные модели (7–8B) часто ошибаются в вызовах инструментов. Берите модель от примерно 30B с поддержкой вызова функций.