Документация Формулы
Разделы документации

Руководство

Обзор руководства

Бизнес-процессы и задачи

Бизнес-процессы и задачи

ИИ-АССИСТЕНТ

Возможности агента

Подробная карта того, что ИИ-ассистент умеет делать в Конструкторе: какие сущности он создаёт, как проверяет результат и где проходит граница его ответственности.

Если вы ещё не открывали панель — начните с ИИ-ассистента.

ИнструментКонкретное действие над конфигурацией: создать объект, добавить реквизит, записать код, провести документ
СкилИнструкция «как правильно» по теме (реквизиты, проведение, отчёты, регистры…). Ассистент открывает нужную инструкцию, когда она требуется
ШагОдно действие. За один запрос ассистент делает несколько шагов подряд

Ассистент работает по принципу «прочитал состояние → сделал изменение → прочитал результат». Поэтому он:

  1. Смотрит текущую конфигурацию (get_configuration_summary, list_objects, search_metadata).
  2. Открывает инструкцию по теме (get_skill).
  3. Делает изменение.
  4. Перечитывает код или схему объекта, чтобы убедиться в результате.
Важно

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


# Объекты

ЧтоКомментарий
СправочникСоздание, изменение, удаление; реквизиты, формы, журнальные настройки
ДокументПлюс нумерация, проведение, основание (по правилам Ввод на основании)
РегистрИзмерения, ресурсы, реквизиты; итоги и себестоимость
ОтчётНаборы данных, поля, ресурсы, диаграммы
СтраницаHTML/JS/CSS для внешних форм и встроенных страниц
Печатная формаШаблон + JS/CSS + описание
КомпонентПереиспользуемый код (библиотека JS)
ПакетГруппировка объектов для выдачи пользователям
ПланировщикФоновое задание по расписанию
Бизнес-процессМаршрут согласования с точками и исполнителями

# Реквизиты

Ассистент умеет создавать поля всех типов: Строка, Число, Дата, Галочка, Перечисление, Ссылка (на справочник), Ссылка на документ, Файл, Картинка, Кнопка, Надпись, HTML-блок.

Типичные запросы:

  • «Добавь в Контрагента ИНН (строка 12), расчётный счёт (строка 20)»
  • «Сделай в Заявке поле Срочно — галочку»
  • «Добавь в Товар ссылку на справочник Единицы измерения»

Полезно знать. Суммы и итоги лучше задавать выражением реквизита (например, [Количество]*[Цена]), а не писать код. Тогда платформа сама пересчитывает поле, а оно становится только для чтения. Ассистент так и делает.


# Форма

ЗадачаЧто получится
Переставить поляНовый порядок в форме
Скрыть полеПоле перестаёт показываться
Сделать поле обязательнымЗапись не пройдёт без заполнения
Изменить подписьНовый заголовок поля

Компоновку табличных частей ассистент тоже меняет — но колонки и их порядок удобнее проверять вручную в редакторе формы.


# Модуль (код)

ОперацияКогда используется
Написать модуль с нуляНовой логики ещё нет
Точечно заменить фрагментНапример, поменять условие в обработчике
Вставить код до/после строкиДобавить проверку в существующий обработчик
Добавить новый обработчикНужен новый этап обработки
Удалить обработчикЛогика больше не нужна

Поддерживаемые обработчики: ПриОткрытии, ПослеОткрытия, ПриСоздании, ПриИзменении_<Поле>, ПриИзменении_<Таблица>_<Поле>, ПередЗаписью, ПослеЗаписи, ПередЗакрытием, ПередПроведением, ПослеПроведения, ПриОтменеПроведения, ПослеОтменыПроведения.

Осторожно

Ошибка в модуле влияет на данные. Тестируйте на копии базы.


# Проведение и регистры

ИнструментЧто делает
Создание правила проведенияНастраивает, какие движения создаёт документ
Учётное правило Дт/КтБухгалтерские проводки по плану счетов
Пересчёт итоговПересчитывает хранимые итоги регистра
Пересчёт себестоимостиЗапускает расчёт себестоимости
Провести/отменить проведениеПрямая операция над документом

Ассистент сам выбирает, использовать ли регистр итогов (быстрые остатки) или считать по движениям. Итоги и себестоимость требуют корректных правил проведения.


# Отчёты

Что настраиваетсяКак
Набор данныхЗапрос к объектам, регистрам, таблицам
Поля и ресурсыЧто выводится в строках и что суммируется
ДиаграммаТип и привязка к данным
Тонкость

Сами диаграммы ассистент настраивает в ограниченном объёме — окончательную настройку удобнее сделать вручную в редакторе отчёта.


# Печатные формы и страницы

ВозможностьДеталь
Шаблон печатиHTML с подстановками
JS печатной формыЛогика подготовки данных
CSS печатной формыОформление
HTML/JS/CSS страницыПолная перезапись или точечная правка JS

Ограничение шаблонизатора. В подстановках вида ${...} нет JavaScript и функций — только простые подстановки. Всю логику выносите в JS печатной формы.


# Данные

ОперацияЧто делает
Создать записьНовая строка в справочнике или новый документ
Изменить записьПравка существующей
Удалить записьУдаление (с учётом выбранной политики удаления)

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


# Бизнес-процессы

ОперацияЧто делает
Создать процессНовый маршрут с триггером
Добавить точкуЭтап с типом действия и исполнителем
Изменить/удалить точкуПравка маршрута

Подробнее о самом механизме — Бизнес-процессы и задачи.


# Служебные темы

ТемаЧто можно попросить
ХарактеристикиВключить учёт по характеристикам у справочника
СерииВключить учёт по сериям
Единицы измеренияСоздать единицы, настроить коэффициенты
ВалютыЗавести валюту и курс
НДСНастроить ставки и счета учёта НДС
Ограничения доступа (RLS)Ограничить видимость записей по условию
ЖурналыНастроить оформление, фильтры, агрегаты
Ссылочная целостностьНайти и почистить «битые» ссылки

# Чего ассистент не делает

Не делаетПочему
Не настраивает SMTP, лицензию, резервное копированиеЭто администрирование, а не конфигурация
Не выдаёт права группамПрава «Объект → Чтение/Запись/Удаление» настраиваются вручную
Не восстанавливает базу из копииОперация уровня сервера
Не гарантирует безошибочный кодКод надо читать и тестировать
Не работает в рабочем режимеАссистент живёт только в Конструкторе

# Приёмы работы

ПриёмПример
Начать с «пустой» конфигурации«Создай справочник Номенклатура: Наименование, Артикул, Цена, Единица»
Наращивать по шагамСначала объекты, потом формы, потом проведение
Просить проверить«Покажи, какие поля сейчас у документа»
Просить объяснение«Объясни, какие движения создаст этот документ»
Откатывать через конфигурациюПеред крупной перестройкой — копия базы
Локальная модель для секретовПровайдер типа Custom

# Если что-то пошло не так

СимптомЧто делать
Ассистент создал лишнееУдалите объект или поле вручную в Конструкторе
Код с ошибкойОткройте модуль, попросите ассистента показать код и исправить
Ассистент не видит объектОбновите панель: напишите «Покажи список объектов»
Слишком долгоНапишите Остановить, затем уточните задачу
«Достигнут лимит шагов»Напишите Продолжить

# Смотрите также