Инструменты

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

Инструменты находятся в разделе Contexis AI > Инструменты > Инструменты. Это справочник, в котором хранятся настроенные запросы к базе 1С.

Справочник инструментов, сгруппированный по разделам учета

По умолчанию в Contexis AI уже есть набор настроенных инструментов (пока только для УТ 11). Если их изменили или удалили, инструменты можно восстановить. Для этого нажмите Еще > Обновить предопределенные инструменты.

Создание и настройка инструмента

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

  • Группа — папка для логической группировки инструментов в справочнике (например, «Склад и остатки»).
  • Наименование (англ) — техническое имя инструмента (например, 1C_get_inventory_balances). Должно быть уникальным и содержать только латинские буквы, цифры и подчеркивания.
  • Наименование (рус) — понятное название для пользователей.
  • Описание — подробно укажите, какие данные возвращает инструмент и в каких ситуациях его используют. Чем точнее описание, тем корректнее LLM выберет инструмент для ответа пользователю.
  • Запрос к базе 1С — сформируйте запрос с помощью кнопки Конструктор запроса или вручную. После изменения запроса автоматически заполняются вкладки Колонки и Фильтры. Эти данные также участвуют в выборе инструмента для ответа пользователю.
  • Значение фильтра по умолчанию — можно указать параметр DF_NoFilterSpecified. Он используется, если пользователь не указал критерии отбора. Например, сотрудник пишет: «Покажи информацию о банке», но не указывает название. В этом случае запрос выполняется без дополнительных фильтров.
Карточка инструмента с настроенным запросом, описанием и колонками

Когда настроите запрос, нажмите Записать и закрыть. После этого LLM сможет использовать инструмент, если он добавлен в набор инструментов.

💡 Совет: Уделяйте особое внимание полю «Описание». LLM не видит сам текст SQL-запроса, она принимает решение о вызове инструмента исключительно на основе его названия и описания. Чем детальнее вы опишете, какие именно данные возвращает инструмент и какие фильтры принимает, тем качественнее будет результат.