ИИ-АССИСТЕНТ
Возможности агента
Подробная карта того, что ИИ-ассистент умеет делать в Конструкторе: какие сущности он создаёт, как проверяет результат и где проходит граница его ответственности.
Если вы ещё не открывали панель — начните с ИИ-ассистента.
| Инструмент | Конкретное действие над конфигурацией: создать объект, добавить реквизит, записать код, провести документ |
|---|---|
| Скил | Инструкция «как правильно» по теме (реквизиты, проведение, отчёты, регистры…). Ассистент открывает нужную инструкцию, когда она требуется |
| Шаг | Одно действие. За один запрос ассистент делает несколько шагов подряд |
Ассистент работает по принципу «прочитал состояние → сделал изменение → прочитал результат». Поэтому он:
- Смотрит текущую конфигурацию (
get_configuration_summary,list_objects,search_metadata). - Открывает инструкцию по теме (
get_skill). - Делает изменение.
- Перечитывает код или схему объекта, чтобы убедиться в результате.
ВажноИзменения появляются в Конструкторе сразу, но окончательно сохраняются вместе с конфигурацией — не забывайте про зелёную кнопку Записать в шапке объекта или Сохранить в разделе Конфигурация.
# Объекты
| Что | Комментарий |
|---|---|
| Справочник | Создание, изменение, удаление; реквизиты, формы, журнальные настройки |
| Документ | Плюс нумерация, проведение, основание (по правилам Ввод на основании) |
| Регистр | Измерения, ресурсы, реквизиты; итоги и себестоимость |
| Отчёт | Наборы данных, поля, ресурсы, диаграммы |
| Страница | HTML/JS/CSS для внешних форм и встроенных страниц |
| Печатная форма | Шаблон + JS/CSS + описание |
| Компонент | Переиспользуемый код (библиотека JS) |
| Пакет | Группировка объектов для выдачи пользователям |
| Планировщик | Фоновое задание по расписанию |
| Бизнес-процесс | Маршрут согласования с точками и исполнителями |
# Реквизиты
Ассистент умеет создавать поля всех типов: Строка, Число, Дата, Галочка, Перечисление, Ссылка (на справочник), Ссылка на документ, Файл, Картинка, Кнопка, Надпись, HTML-блок.
Типичные запросы:
- «Добавь в Контрагента ИНН (строка 12), расчётный счёт (строка 20)»
- «Сделай в Заявке поле Срочно — галочку»
- «Добавь в Товар ссылку на справочник Единицы измерения»
Полезно знать. Суммы и итоги лучше задавать выражением реквизита (например,
[Количество]*[Цена]), а не писать код. Тогда платформа сама пересчитывает поле, а оно становится только для чтения. Ассистент так и делает.
# Форма
| Задача | Что получится |
|---|---|
| Переставить поля | Новый порядок в форме |
| Скрыть поле | Поле перестаёт показываться |
| Сделать поле обязательным | Запись не пройдёт без заполнения |
| Изменить подпись | Новый заголовок поля |
Компоновку табличных частей ассистент тоже меняет — но колонки и их порядок удобнее проверять вручную в редакторе формы.
# Модуль (код)
| Операция | Когда используется |
|---|---|
| Написать модуль с нуля | Новой логики ещё нет |
| Точечно заменить фрагмент | Например, поменять условие в обработчике |
| Вставить код до/после строки | Добавить проверку в существующий обработчик |
| Добавить новый обработчик | Нужен новый этап обработки |
| Удалить обработчик | Логика больше не нужна |
Поддерживаемые обработчики: ПриОткрытии, ПослеОткрытия, ПриСоздании, ПриИзменении_<Поле>, ПриИзменении_<Таблица>_<Поле>, ПередЗаписью, ПослеЗаписи, ПередЗакрытием, ПередПроведением, ПослеПроведения, ПриОтменеПроведения, ПослеОтменыПроведения.
ОсторожноОшибка в модуле влияет на данные. Тестируйте на копии базы.
# Проведение и регистры
| Инструмент | Что делает |
|---|---|
| Создание правила проведения | Настраивает, какие движения создаёт документ |
| Учётное правило Дт/Кт | Бухгалтерские проводки по плану счетов |
| Пересчёт итогов | Пересчитывает хранимые итоги регистра |
| Пересчёт себестоимости | Запускает расчёт себестоимости |
| Провести/отменить проведение | Прямая операция над документом |
Ассистент сам выбирает, использовать ли регистр итогов (быстрые остатки) или считать по движениям. Итоги и себестоимость требуют корректных правил проведения.
# Отчёты
| Что настраивается | Как |
|---|---|
| Набор данных | Запрос к объектам, регистрам, таблицам |
| Поля и ресурсы | Что выводится в строках и что суммируется |
| Диаграмма | Тип и привязка к данным |
ТонкостьСами диаграммы ассистент настраивает в ограниченном объёме — окончательную настройку удобнее сделать вручную в редакторе отчёта.
# Печатные формы и страницы
| Возможность | Деталь |
|---|---|
| Шаблон печати | HTML с подстановками |
| JS печатной формы | Логика подготовки данных |
| CSS печатной формы | Оформление |
| HTML/JS/CSS страницы | Полная перезапись или точечная правка JS |
Ограничение шаблонизатора. В подстановках вида
${...}нет JavaScript и функций — только простые подстановки. Всю логику выносите в JS печатной формы.
# Данные
| Операция | Что делает |
|---|---|
| Создать запись | Новая строка в справочнике или новый документ |
| Изменить запись | Правка существующей |
| Удалить запись | Удаление (с учётом выбранной политики удаления) |
Ассистент не выполняет массовых разрушительных операций без явной просьбы.
# Бизнес-процессы
| Операция | Что делает |
|---|---|
| Создать процесс | Новый маршрут с триггером |
| Добавить точку | Этап с типом действия и исполнителем |
| Изменить/удалить точку | Правка маршрута |
Подробнее о самом механизме — Бизнес-процессы и задачи.
# Служебные темы
| Тема | Что можно попросить |
|---|---|
| Характеристики | Включить учёт по характеристикам у справочника |
| Серии | Включить учёт по сериям |
| Единицы измерения | Создать единицы, настроить коэффициенты |
| Валюты | Завести валюту и курс |
| НДС | Настроить ставки и счета учёта НДС |
| Ограничения доступа (RLS) | Ограничить видимость записей по условию |
| Журналы | Настроить оформление, фильтры, агрегаты |
| Ссылочная целостность | Найти и почистить «битые» ссылки |
# Чего ассистент не делает
| Не делает | Почему |
|---|---|
| Не настраивает SMTP, лицензию, резервное копирование | Это администрирование, а не конфигурация |
| Не выдаёт права группам | Права «Объект → Чтение/Запись/Удаление» настраиваются вручную |
| Не восстанавливает базу из копии | Операция уровня сервера |
| Не гарантирует безошибочный код | Код надо читать и тестировать |
| Не работает в рабочем режиме | Ассистент живёт только в Конструкторе |
# Приёмы работы
| Приём | Пример |
|---|---|
| Начать с «пустой» конфигурации | «Создай справочник Номенклатура: Наименование, Артикул, Цена, Единица» |
| Наращивать по шагам | Сначала объекты, потом формы, потом проведение |
| Просить проверить | «Покажи, какие поля сейчас у документа» |
| Просить объяснение | «Объясни, какие движения создаст этот документ» |
| Откатывать через конфигурацию | Перед крупной перестройкой — копия базы |
| Локальная модель для секретов | Провайдер типа Custom |
# Если что-то пошло не так
| Симптом | Что делать |
|---|---|
| Ассистент создал лишнее | Удалите объект или поле вручную в Конструкторе |
| Код с ошибкой | Откройте модуль, попросите ассистента показать код и исправить |
| Ассистент не видит объект | Обновите панель: напишите «Покажи список объектов» |
| Слишком долго | Напишите Остановить, затем уточните задачу |
| «Достигнут лимит шагов» | Напишите Продолжить |
