Урок 1 25 минут Базовый

Консоль запросов 1С с ИИ: установка и первый запрос

Установите Консоль запросов 1С с ИИ, сформируйте первый запрос по описанию задачи и проверьте результат выполнения.

Результат урока

Вы откроете Консоль запросов как внешнюю обработку, сформулируете задачу обычным языком и выполните запрос, созданный с учётом метаданных вашей базы. Изменять конфигурацию для этого не потребуется.

Перед началом

Что понадобится

1С:Предприятие 8.3

Учебная или рабочая база, где вам разрешено открывать внешние обработки.

Файл Консоли запросов

Внешняя обработка в формате .epf, скачанная из личного кабинета.

Токен доступа

Ключ Aether Lab для подключения обработки к ИИ-агенту.

Тестовая задача

В уроке найдём товары с остатком на выбранном складе.

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

Основы

Что делает обычная консоль запросов

Обычная консоль — это внешняя обработка для запуска и отладки запросов в режиме 1С:Предприятия. Разработчик вручную пишет текст на языке запросов, задаёт параметры, выполняет его и изучает результат.

Она удобнее временного кода в конфигураторе: запрос можно сохранить, быстро изменить и повторно выполнить. При этом консоль не придумывает структуру запроса и не знает, какую бизнес-задачу вы решаете.

Этап	Обычная консоль	Консоль с ИИ
Постановка задачи	Сразу писать запрос	Можно описать результат обычным языком
Метаданные	Искать объекты и поля вручную	Агент использует метаданные подключённой базы
Ошибки	Разбирать сообщение платформы самостоятельно	Можно передать ошибку агенту и попросить исправление
Результат	Выполнение и просмотр таблицы	Те же возможности плюс совместное редактирование запроса

Важно

ИИ не заменяет механизм запросов 1С. Он помогает подготовить текст, а выполняет запрос сама платформа в вашей информационной базе.

Шаг 1

Откройте внешнюю обработку

Запустите базу в режиме 1С:Предприятия.

Используйте пользователя с правом интерактивного открытия внешних обработок.

Выберите «Файл → Открыть».

Укажите скачанный файл Консоли запросов с расширением .epf.

Подтвердите предупреждение безопасности.

Делайте это только для файла, полученного из личного кабинета Aether Lab.

Укажите токен доступа.

Скопируйте токен из личного кабинета и сохраните его в настройках обработки.

После подключения откроется рабочая область: редактор запроса, панель результата и чат с агентом. Конфигурация базы при запуске не изменяется.

Шаг 2

Сформулируйте первую задачу

Начинайте не с названий таблиц, а с требуемого результата. Агент уточнит структуру базы через доступные ему метаданные и подберёт объекты конфигурации.

Запрос агенту

Сформируй запрос, который выводит товары с положительным остатком на выбранном складе. В результате нужны номенклатура, склад и количество. Добавь параметры склада и даты остатков.

Формулировка фиксирует четыре важных условия: источник данных, отбор по положительному остатку, состав колонок и параметры. Это надёжнее короткой команды «покажи остатки».

Если в вашей базе другие объекты

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

Шаг 3

Разберите сформированный запрос

Ниже — пример структуры запроса для конфигурации, где остатки хранятся в регистре накопления ТоварыНаСкладах. В вашей базе имена регистра и полей могут отличаться.

ВЫБРАТЬ
    Остатки.Номенклатура КАК Номенклатура,
    Остатки.Склад КАК Склад,
    Остатки.КоличествоОстаток КАК Количество
ИЗ
    РегистрНакопления.ТоварыНаСкладах.Остатки(
        &ДатаОстатков,
        Склад = &Склад
    ) КАК Остатки
ГДЕ
    Остатки.КоличествоОстаток > 0

УПОРЯДОЧИТЬ ПО
    Остатки.Номенклатура

Виртуальная таблица Остатки получает состояние регистра на указанную дату.
Отбор по складу передан внутрь параметров виртуальной таблицы, чтобы не читать лишние записи.
КоличествоОстаток > 0 исключает нулевые и отрицательные остатки.
Параметры отделяют текст запроса от конкретного склада и даты.

Шаг 4

Заполните параметры и проверьте синтаксис

Выберите склад.

Для параметра Склад укажите ссылку на существующий элемент справочника складов.

Укажите дату.

Для первого запуска используйте текущую дату с концом дня, если бизнес-задача не требует другого момента.

Запустите проверку.

Консоль передаст текст платформе и покажет синтаксическую ошибку до просмотра результата.

Если платформа сообщает, что таблица или поле не найдены, не меняйте имена наугад. Отправьте агенту точный текст ошибки:

Уточнение агенту

Платформа сообщает: «Таблица не найдена РегистрНакопления.ТоварыНаСкладах». Проверь метаданные базы и замени источник на регистр, где хранятся остатки номенклатуры по складам.

Шаг 5

Выполните запрос и проверьте результат

После успешной проверки выполните запрос. В таблице результата должны появиться только позиции выбранного склада с количеством больше нуля.

Минимальная проверка

Выберите одну номенклатуру из результата.
Откройте штатный отчёт по остаткам в той же базе.
Установите тот же склад и дату.
Сравните количество и убедитесь, что единицы измерения совпадают.

Критерий готовности

Запрос выполняется без ошибок, возвращает только выбранный склад, а значение хотя бы по одной позиции совпадает со штатным отчётом.

Контроль качества

Что ИИ может сделать неверно

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

Поэтому рабочий цикл выглядит так: поставить задачу → получить запрос → проверить синтаксис → выполнить → сверить результат. Генерация запроса без последней проверки не считается завершённой задачей.

Самостоятельная работа

Закрепите результат

Измените исходную задачу: добавьте отбор по группе номенклатуры и выведите артикул. Не редактируйте запрос вручную — сформулируйте изменение агенту.

Задание

Добавь параметр группы номенклатуры, отбирай товары из этой группы с учётом иерархии и выведи артикул отдельной колонкой. Сохрани текущие параметры склада и даты.

Урок пройден, если изменённый запрос выполняется, показывает артикул и не возвращает товары за пределами выбранной группы.

Итоги

Что вы сделали

открыли Консоль запросов без изменения конфигурации;
поставили агенту задачу на естественном языке;
получили запрос с учётом метаданных базы;
задали параметры склада и даты;
проверили синтаксис и выполнили запрос;
сверили результат со штатным отчётом.

В следующем уроке можно перейти к параметрам сложных типов, спискам значений и повторному использованию сохранённых запросов.