AI Агент1С

AI-агент на платформе 1С:Enterprise в виде расширения конфигурации: агентский цикл с вызовом инструментов (function calling), MCP-клиент, память диалога и интерактивный HTML-чат. Работа с моделью — через любой OpenAI-совместимый endpoint (/v1/chat/completions).

Совместимость расширения 8.3.24, платформа 8.5.1.

Возможности

• Агентский цикл с вызовом инструментов: модель предлагает вызовы, агент исполняет их на сервере 1С и возвращает результат в цикле до готового ответа.
• Подключение к любому OpenAI-совместимому endpoint — OpenAI, Ollama, vLLM, LM Studio, шлюзы.
• Инструменты 1С: запросы к базе, схема метаданных, диагностика журнала регистрации, выгрузка в Excel, диаграммы, обзорные сводки, калькулятор, Mermaid, файлы диалога.
• Распознавание изображений и PDF (vision): картинки и постраничное распознавание PDF через vision-модель; PDF рендерится внешним движком (pdftoppm / Ghostscript / ImageMagick).
• MCP-клиент: подключение внешних серверов по JSON-RPC (initialize, tools/list, tools/call), транспорты StreamableHTTP и SSE; инструменты сервера попадают в общий реестр агента, а встроенные инструменты могут сами вызывать MCP (например, Mermaid).
• Память диалога: факты, релевантный отбор, сводка, TTL.
• Контроль безопасности: подтверждение вызовов пользователем, права 1С, безопасный режим, белый/чёрный список объектов в запросах к БД.
• Чат-интерфейс на поле HTML: markdown, эмодзи, темы, индикатор шагов, файлы и картинки.

Установка и быстрый старт

1. Подключите расширение к информационной базе на БСП-конфигурации (из EDT — привязкой к базовому проекту, либо загрузкой собранного .cfe).
2. Создайте профиль подключения (см. ниже) — подключение к OpenAI-совместимому endpoint и список его моделей.
3. Создайте режим работы (см. ниже) — модель, промпт и параметры на основе профиля.
4. Зарегистрируйте встроенные инструменты — кнопкой «по умолчанию» в форме списка справочника «Инструменты агента» (СИ_ИнструментыАгента) (см. ниже).
5. Включите регламентное задание «Обслуживание агента» (СИ_ОбслуживаниеАгента) — оно чистит просроченную память диалогов и снимает зависшие фоновые заходы.
6. Проверьте подключение и начните диалог в чате.

Активный режим — это элемент справочника «Режимы работы» (см. ниже). Режимы различаются только моделью, профилем, промптом и температурой; используемый по умолчанию выбирается в настройках, а переключаться между созданными режимами можно прямо в чате.

 Профиль подключения

Справочник «Профили подключений» (СИ_ПрофилиПодключений) хранит подключение к OpenAI-совместимому endpoint и список его моделей. Открывается из формы «Настройки» обработки «Чат агента» или напрямую.

• Подключение: БазовыйURL (с версией API — например, https://api.openai.com/v1 или http://localhost:11434/v1 для Ollama), КлючAPI, тип авторизации (Bearer / ключ в заголовке / ключ в URL / без авторизации — для локальных endpoint'ов), таймаут, прокси, проверка SSL.
• Табличная часть «Модели» — перечень моделей endpoint: имя, контекстное окно, максимум токенов ответа, флажки «Использовать по умолчанию» и «Поддержка изображений». Для распознавания картинок и PDF (vision) добавьте сюда отдельную мультимодальную модель (llava, qwen2-vl, gpt-4o и т.п.) и отметьте её флажком «Поддержка изображений» — именно эти модели предлагаются в поле «Модель распознавания картинок» режима работы.
• Лимиты: максимум итераций агентского цикла (MaxIterations), сжатие истории (процент окна под историю, сводка, число свежих сообщений), лимиты длины сообщений и tool-результатов, число повторов при транспортных ошибках, РазрешитьРассуждения для reasoning-моделей.
• Распознавание PDF (если нужно): движок (pdftoppm / ghostscript / imagemagick), путь к утилите, максимум страниц, DPI.

Режим работы

Справочник «Режимы работы» (СИ_РежимиРаботы) — «конфигурация агента»: какая модель, через какой профиль и с каким промптом. Создаётся из формы «Настройки» (кнопка открытия справочника) или напрямую. Элемент, выбранный в настройках чата, становится активным режимом — он используется по умолчанию, без всякого выбора у пользователя.

• Профиль — подключение, созданное на шаге 2.
• Модель — выбирается из табличной части «Модели» выбранного профиля.
• Распознавание картинок: «Модель распознавания картинок» (список ограничен моделями профиля с флажком «Поддержка изображений») и «Профиль для распознавания» — если vision-модель живёт на другом endpoint (например, локальная Ollama, пока чат идёт в облако). Если профиль распознавания не заполнен, используется основной профиль режима.
• Промпт и тон: системный промпт (кнопка «Промпт по умолчанию» подставляет базовый текст), температура, подсказки стартового экрана (каждая строка — кнопка в чате).
• Видимость: флажок «Использовать в списке чатов» и табличная часть «Доступные пользователи» — пустой список означает, что режим доступен всем.

Права: создавать и редактировать профили и режимы может роль СИ_АдминистрированиеЧатАгента; для работы с чатом достаточно СИ_ИспользованиеЧатАгента — профили и режимы пользователи только читают.

Подключение к LLM: OpenAI-совместимый API

Взаимодействие с моделью построено на OpenAI-совместимом протоколе (/v1/chat/completions) с полем tools (function calling); число повторов при транспортных ошибках настраивается в профиле. HTTP-клиент — СИ_ОpenAIКлиент, настройки — СИ_НастройкиАгента, редактирование — форма «Настройки» обработки «Чат агента».

Параметры распределены между объектами (см. «Установка и быстрый старт» выше): подключение и лимиты (БазовыйURL, КлючAPI, таймаут, прокси, MaxIterations, сжатие истории) — в профиле подключения; модель и температура — в режиме работы. Профилей может быть несколько — например, облачная модель для чата и локальная Ollama для распознавания картинок. Доступность endpoint можно проверить действием «проверить подключение» в форме настроек (запрос списка моделей).

Типы авторизации (СИ_ТипыАвторизации)

Ollama

Локальные модели подключаются напрямую: Ollama поддерживает тот же OpenAI-совместимый интерфейс.

• БазовыйURL: http://localhost:11434/v1 (или адрес машины с Ollama).
• Тип авторизации: «Нет» — ключ не нужен.
• Добавьте модели в табличную часть «Модели» профиля — имена как в ollama list (например, qwen2.5:14b); одну пометьте «Использовать по умолчанию».
• Для распознавания картинок добавьте multimodal-модель (llava, qwen2-vl и т.п.) с флажком «Поддержка изображений» и укажите её в режиме работы (см. выше).
• Прокси и проверка SSL настраиваются так же, как для внешних endpoint'ов.

Регистрация инструментов

Как устроен реестр

Единый реестр инструментов — справочник СИ_ИнструментыАгента. В нём живут инструменты двух типов (перечисление СИ_ТипыИнструментов):

Для модели оба типа выглядят одинаково: поле tools собирается в формате OpenAI function-calling (СИ_УправлениеИнструментами1С.СформироватьПолеТools), а диспетчер ВызватьИнструмент сам маршрутизирует вызов — в BSL-функцию или в tools/call MCP-сервера.

Поля элемента реестра и порядок заполнения — в разделе «Свой инструмент: порядок создания» ниже; в коде атрибуты называются ИмяФункции, Описание, ПараметрыSchema, ИмяФункцииОбработчика, Разрешен, ТребуетРазрешения, Слова, Действие, ТЧ РазрешённыеРежимы.

Регистрация базовых инструментов

Встроенные инструменты регистрируются кнопкой «по умолчанию» в форме списка справочника «Инструменты агента» — она выполняет СИ_Инструменты1С.ЗарегистрироватьИнструменты() и СИ_ФайлыДиалога.ЗарегистрироватьИнструменты(). Регистрация идемпотентна: повторный запуск обновляет описания и схемы уже существующих инструментов, поэтому её безопасно выполнять после каждого обновления расширения. Требуются права на изменение справочника (роль СИ_АдминистрированиеЧатАгента).

Свой инструмент: порядок создания

Свой инструмент — это обработчик в общем модуле + элемент реестра. Авторегистрацию через ЗарегистрироватьИнструмент для своих инструментов использовать не нужно — элемент реестра создаётся вручную.

1. Напишите обработчик — экспортную функцию серверного общего модуля (контракт — см. ниже). Обработчики недоверенных модулей исполняются под безопасным режимом платформы: привилегированные возможности в них недоступны.

2. Создайте элемент справочника «Инструменты агента» («Создать») и заполните поля:

   Поле	Как заполнить
   Наименование	человекочитаемое имя элемента; по нему вызов не выполняется
   Имя функции	уникальное имя для модели — латиница, camelCase (например, Calculate); по нему модель вызывает инструмент
   Описание	семантика инструмента для модели; определяет, когда модель будет его вызывать
   Параметры Schema	JSON Schema параметров: type: object + properties + required; при создании нового элемента форма подставляет заготовку
   Имя функции обработчика	"ИмяМодуля.ИмяФункции" — экспортная функция серверного общего модуля
   Разрешён	флажок включения инструмента; у нового элемента установлен автоматически
   Запрашивать разрешение	подтверждение пользователя перед исполнением — ставьте для пишущих инструментов
   Группа (родитель)	папка реестра; для нового элемента подставляется «Основные». Инструменты «Основных» всегда в промпте; для специализированных инструментов создавайте отдельные группы
   Ключевые слова	слова вопроса через запятую, по которым группа поднимается в промпт без fetch_toolset (для групп вне «Основных»)
   Действие (статус шага)	текст для индикатора чата («Смотрю остатки товара…»); пусто — берётся первая фраза описания
   Разрешённые режимы (ТЧ)	список режимов работы; пусто — инструмент доступен во всех режимах

3. Проверьте в чате: задайте вопрос, на который должен сработать инструмент, и убедитесь, что модель его вызывала (шаг инструмента виден в индикаторе чата).

Контракт обработчика

Обработчик — экспортная функция серверного общего модуля:

// Параметры:
//  Аргументы - Структура - параметры, которые передала модель
//    (движок конвертирует Соответствие из tool_calls в Структуру).
//
// Возвращаемое значение - Структура:
//  * Успех    - Булево.
//  * Значение - Произвольный - результат; сериализуется в JSON и уходит модели.
//  * Ошибка   - Строка,Неопределено - текст ошибки при Успех = Ложь.
Функция Калькулятор(Аргументы) Экспорт
	Результат = Новый Структура("Успех, Значение, Ошибка", Ложь, Неопределено, Неопределено);
	...
	Возврат Результат;
КонецФункции

• Если обработчик вернул не структуру или структуру без ключа Успех, движок считает вызов успешным, а возвращённое значение — результатом.
• В Значение можно дополнительно положить служебные ключи, которые изымаются до сериализации и модели не уходят:
  • СсылкиОбъектов — карта ссылок на объекты для «упоминаний» в чате;
  • Диаграмма — карточка диаграммы (SVG, заголовок, файл диалога) — показывается пользователю, как у инструмента DrawChart.
• Движок сам: проверяет доступность инструмента в режиме, детектирует отказ по правам доступа 1С (НетПрав + инструкция модели «ДОСТУП ЗАПРЕЩЁН»), применяет гигиену результата (маскирование | перед отдачей табличных данных в markdown-ответ), считает длительность вызова.

Доверенные модули. Обработчики модулей СИ_Инструменты1С, СИ_ФайлыДиалога, СИ_РаспознованиеИзображений вызываются без безопасного режима и без Вычислить — через статическую диспетчеризацию (ВыполнитьБезБезопасногоРежима). Список методов там ручной: при регистрации нового инструмента доверенного модуля его метод нужно добавить в эту ветку, иначе вызов упадёт с «Неизвестный метод доверенного модуля». Обработчики из любого другого модуля вызываются через Вычислить под безопасным режимом платформы и в дополнительных настройках не нуждаются.

Группы и ленивое подтягивание (fetch_toolset)

Чтобы не переполнять промпт, реестр раздаёт инструменты по группам:

• Инструменты группы «Основные» (пустая группа трактуется как «Основные») всегда передаются модели в поле tools.
• Инструменты остальных групп («Диагностика», «Выгрузки и диаграммы», «Сводки», …) модель подтягивает сама виртуальным инструментом fetch_toolset, а также группа целиком поднимается в промпт, если вопрос пользователя совпал с ключевыми словами (Слова) любого инструмента группы.

Поэтому новую группу создавайте осмысленно: «Основные» — то, без чего агент не работает, остальные — специализированные наборы с ключевыми словами.

Подтверждение вызовов пользователем

Инструменты с флагом ТребуетРазрешения перед исполнением попадают в регистр СИ_ОжидающиеРазрешения; в чате появляется запрос подтверждения, решение пользователя запоминается в СИ_РазрешенияИнструментовДиалога. Ставьте флаг всем пишущим инструментам (создание документов, файлов, отправка внешних запросов). По умолчанию он выставлен у DrawMermaid и файловых инструментов на запись.

Встроенные инструменты

Описание базовых инструментов

Запросы к данным

• ExecuteDBQuery — read-only запрос к БД. Параметры: ТекстЗапроса (обязательный, на языке запросов 1С, начинается с ВЫБРАТЬ; директивы РАЗРЕШЕННЫЕ и ПЕРВЫЕ добавляются автоматически, модифицирующие операторы запрещены), Параметры (именованные параметры: даты — строкой ГГГГ-ММ-ДД, отбор по ссылке — через текстовые поля Код/Наименование, массивы — для В (&Параметр)), ТаймаутСекунд (по умолчанию 60), ЛимитСтрок (1–100, по умолчанию 100). Возвращает строки и флаг ЕстьЕщеДанные. Запрещённые объекты (константа СИ_ЗапрещенныеОбъектыЗапросов) недоступны; в выборку рекомендуется включать ссылочное поле (Ссылка) — тогда объекты кликабельны в чате.
• GetMetadataSchema — схема метаданных для составления запросов. Параметр Поиск ("Справочник" — все справочники, "Справочник.Польз" — подстрока внутри класса, пусто — статистика по классам) или ИмяТаблицы (точное имя таблицы → реквизиты с типами). Запрещённые объекты не возвращаются.
• GetCurrentDateTime — текущие дата и время информационной базы (без параметров): ДатаВремя, Дата, Год, Месяц.
• ParsePeriod — границы периода, названного словами («за 3 квартал», «в прошлом месяце», «за последние 30 дней»). Параметр Текст (можно весь вопрос — период будет найден). Возвращает Распознан, ДатаНачала/ДатаКонца, НачалоДатаВремя/КонецДатаВремя (их передают параметрами запроса) и Пояснение.

Расчёты и графика

• Calculate — точный расчёт арифметического выражения (синтаксис 1С: + - * /, скобки, десятичная точка). Параметр Выражение; допустимы только цифры, операторы, скобки, точка и пробел — произвольный код 1С исключён.
• DrawMermaid — Mermaid-диаграмма в файл диалога. Параметры: Код (обязательный, без обрамляющих ```mermaid), Формат (png/jpeg/webp/svg, по умолчанию png), Тема (default/neutral/dark/forest). Требует включённого MCP-сервера с инструментом render_mermaid (см. «Инструменты MCP»).
• DrawChart — диаграмма по данным запроса прямо в чате. Параметры: ТекстЗапроса (обязательный, как у ExecuteDBQuery), Параметры, Тип (столбцы/линия/круг), КолонкаКатегорий (по умолчанию первая колонка), КолонкаЗначений (вторая), Заголовок, ЛимитТочек (1–100, по умолчанию 30; в круговой лишние точки сворачиваются в «Прочие»). SVG и xlsx сохраняются в файлах диалога. Требует подтверждения.

Выгрузки и диагностика

• ExportTable — выгрузка результата запроса в Excel (.xlsx) в файлы диалога. Параметры: ТекстЗапроса (обязательный), Параметры, ЛимитСтрок (1…100 000, по умолчанию 10 000), ИмяФайла (.xlsx). Модель не получает сами строки — только имя файла, число строк/колонок, первые 5 строк и итоги по числовым колонкам, поэтому инструмент подходит и для больших выборок. Требует подтверждения.
• GetRecentErrors — свежие события журнала регистрации текущего пользователя. Параметры: Минут (по умолчанию 60, максимум 1440), Уровни (Ошибка, Предупреждение, Информация, Примечание; по умолчанию первые два). Возвращает до 30 событий (Дата, Уровень, Событие, Метаданные, Данные, Комментарий).
• Сводки (GetSalesSummary / GetMoneySummary / GetStockSummary) — готовые обзорные сводки (продажи, деньги, склад) без составления запросов. Доступны, когда в базе есть соответствующие объекты демо-конфигурации.

Файлы диалога

• CreateDialogFile / UpdateDialogFile — создание и изменение файлов диалога (требуют подтверждения пользователя), ReadDialogFile / ListDialogFiles — чтение и просмотр списка. На файлах допустимых типов построено распознавание: RecognizeImage распознаёт приложенный файл (см. раздел «Распознавание изображений и PDF»).

Инструменты MCP

Внешние инструменты подключаются справочником СИ_MCPСерверы — Model Context Protocol превращает любые внешние возможности в инструменты агента: рендеринг графики, работа с файловой системой, поиск, корпоративные сервисы и т.д.

• Транспорты (перечисление СИ_ТипыПодключенийMCP): StreamableHTTP — JSON-RPC поверх HTTP POST (современный транспорт), SSE — Server-Sent Events (legacy).
• Подключение: URL, версия протокола, произвольные заголовки (ЗаголовкиJSON), авторизация (Bearer / ключ в заголовке / ключ в URL), таймаут вызова, проверка SSL, флажок Включен.
• Протокол: клиент СИ_УправлениеИнструментамиMCP выполняет initialize (с согласованием версии протокола и уведомлением об инициализации), затем tools/list — список попадает в табличную часть «Инструменты» элемента справочника. Загрузку можно повторять (опционально очищая инструменты, исчезнувшие с сервера); отдельным действием доступна проверка подключения.
• Доступ построчно: для каждого инструмента сервера задаются Разрешен, ТребуетРазрешения и разрешённые режимы — те же механизмы, что у инструментов 1С.
• Общее пространство имён: имена MCP-инструментов попадают в единый реестр; при конфликте имён движок подбирает уникальное API-имя на основе идентификатора сервера, поэтому внешние имена не могут вытеснить встроенные.
• Вызов выполняется через tools/call; для модели MCP-инструмент ничем не отличается от встроенного — диспетчер СИ_УправлениеИнструментами1С.ВызватьИнструмент маршрутизирует вызов сам.
• Двусторонняя интеграция: встроенные инструменты могут сами быть клиентами MCP — DrawMermaid обёрнут над MCP-инструментом render_mermaid и сохраняет результат как файл диалога.

Есть возможность подключить mcp от проекта EDT и создать режим Аналитика 1С. Или можно использовать https://github.com/junglnet/mcp-edt-readonly.

Получение описаний и удаление

• СИ_УправлениеИнструментами1С.ПолучитьОписаниеИнструмента(Имя) — полное описание (включая тип, обработчик, режимы, группу).
• ПолучитьСписокИнструментов(Фильтр) — список с фильтрами по типу ("1С"/"MCP"), режиму и белому списку имён; объединяет оба типа.
• УдалитьИнструмент(Имя) — для инструмента 1С ставит пометку удаления, для MCP-инструмента снимает флажок Разрешен в ТЧ сервера.

Распознавание изображений и PDF (vision)

Распознаванием занимается модуль СИ_РаспознованиеИзображений; инструмент — RecognizeImage (работает по файлу, приложенному к диалогу).

• Форматы: картинки jpg, jpeg, png, gif, bmp, webp и PDF.

• Как работает: картинка уходит vision-модели блоком image_url как data URI (base64) через тот же OpenAI-совместимый API; слишком большие картинки пережимаются в JPEG с ограничением размера стороны, чтобы base64 не раздувал запрос.

• Какая модель: реквизиты «Модель распознавания картинок» (МодельРаспознованияКартинок) и «Профиль распознавания картинок» (ПрофильРаспознованияКартинок) в элементе справочника СИ_РежимиРаботы — vision можно направить на отдельный профиль (например, локальная Ollama с llava, пока основной чат идёт в облако). Если модель не задана, инструмент вернёт ошибку «Не задана модель распознавания картинок».

• PDF обрабатывается постранично: страницы конвертируются в JPG внешней утилитой, каждая страница распознаётся отдельно, тексты склеиваются (=== Страница N ===). Настройки (раздел настроек агента):

  Настройка	По умолчанию	Смысл
  ДвижокКонвертацииPDF	pdftoppm	движок рендеринга: pdftoppm (poppler-utils), ghostscript (на Windows gswin64c), imagemagick (magick)
  ПутьКУтилитеКонвертацииPDF	пусто	полный путь к утилите, если её нет в PATH
  МаксимумСтраницPDF	10	сколько первых страниц конвертировать
  DPIКонвертацииPDF	100	разрешение рендеринга страниц

  Утилита выполняется на сервере 1С (при файловом варианте — на клиентской машине), поэтому её нужно установить там, где работает код.

Безопасность

• Права 1С соблюдаются всегда: отказ доступа превращается в инструкцию модели, а не в падение агента.
• Запросы к БД: только с директивами РАЗРЕШЕННЫЕ и ПЕРВЫЕ; чёрный список объектов — константа СИ_ЗапрещенныеОбъектыЗапросов поверх неотключаемого внутреннего списка; выражения калькулятора проверяются по белому списку символов.
• Безопасный режим платформы: обработчики недоверенных модулей исполняются только под ним.
• Подтверждение пользователем — для пишущих инструментов (см. выше).
• Лимит длины ответа модели — константа СИ_ЛимитТокеновНаОтвет; ограничения агентского цикла (число итераций, таймауты) — в СИ_Агент1С.

Права доступа

Обслуживание

Регламентное задание СИ_ОбслуживаниеАгента (ВыполнитьОбслуживание): очистка просроченной памяти диалогов (TTL) и снятие зависших фоновых заходов агентского цикла.