Настройка динамических сущностей

Настройка динамических сущностей¶

Динамические сущности

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

Для динамических сущностей идеально подходит сохранение документов, таких как: * Счета-фактуры со списками товаров или услуг. * Накладные с перечнем позиций. * Коммерческие предложения с разделами и таблицами. * Любые другие документы, содержащие повторяющиеся блоки информации.

Просмотр списка настроенных динамических сущностей¶

Запустите приложение AI Документы из основного меню CRM Битрикс24 и в открывшемся окне выберите раздел меню Динамические сущности
В рабочем окне просмотра Динамических сущностей отражается информация о созданных документах в табличной форме:
- Тип документа (устанавливается при создании)
- Количество (Количество документов загруженных в систему)
- Действия ( — удаление настройки, — настройка типа документа)

Создание типа динамической сущности¶

Чтобы настроить обработку сложного документа, нажмите кнопку + Ноывй тип и заполните форму:

Название — укажите понятное имя для типа документа, которое будет отображаться в интерфейсе (например, "Входящий счет со списком товаров").
Ключ — это техническое имя для связи данных, извлеченных ИИ, со смарт-процессом. Ключ должен быть уникальным и соответствовать JSON-пути к данным в ответе нейросети. (Пример: Если ИИ возвращает массив товаров в поле items, укажите ключ items.)
Тип смарт-процесса — Выберите из списка заранее созданный в вашем Битрикс24 смарт-процесс, в элементы которого будут сохраняться данные.

Настройка полей для привязки данных¶

В этой таблице вы связываете поля элемента выбранного смарт-процесса с данными, которые будет извлекать ИИ.

Название: Имя поля в смарт-процессе для удобства идентификации.
Тип: Тип данных поля (например, строка, число, дата).
Ключ поля: JSON-ключ, по которому ИИ будет возвращать значение для этого поля. Пример: name, price, quantity.
Уник. (Уникальное): Активируйте эту галочку ✔, если поле используется для проверки уникальности элементов. Это помогает избежать дублирования записей.
Поле Битрикс: Здесь отображается привязка к системному полю выбранного смарт-процесса.

Управление полями¶

Используйте кнопку «Добавить поле», чтобы включить в обработку новое поле смарт-процесса.
Для удаления поля из конфигурации нажмите на значок корзины ( в колонке "Удалить").

После завершения настройки всех полей нажмите кнопку «Сохранить», чтобы активировать новый тип динамической сущности. Кнопка «Отменить» позволит выйти из формы без сохранения изменений.

Как это работает на практике¶

Вы создаете в Битрикс24 смарт-процесс "Заказы поставщика" с полями: "Номенклатура", "Количество", "Цена", "Сумма".
В приложении «AI Документы» вы создаете тип динамической сущности "Накладная", указываете ключ line_items и привязываете смарт-процесс "Заказы поставщика".
В таблице полей вы настраиваете привязку:
- Ключ title → поле смарт-процесса "Номенклатура".
- Ключ qty → поле "Количество".
- Ключ price → поле "Цена".
Когда пользователь загружает накладную, ИИ распознает в ней таблицу с товарами и возвращает массив объектов для ключа line_items.
Приложение автоматически создает в смарт-процессе "Заказы поставщика" новый элемент (например, "Накладная №123") и необходимое количество дочерних элементов-позиций, заполняя их данными из документа.