ИИкона — AI-коннектор для 1С:Предприятие

Расширение для интеграции языковых моделей (LLM) в конфигурации 1С:Предприятие 8.3:
единый коннектор к провайдерам, агентская петля с инструментами, RAG, MCP-сервер,
мониторинг ошибок с ИИ-анализом и генератор диаграмм.

🎯 О проекте

ИИкона (КИИ — Коннектор Искусственного Интеллекта) — расширение для работы
с языковыми моделями прямо из 1С. Начиналась как API-коннектор с единым интерфейсом
для всех популярных провайдеров; с версии 1.3.0 это платформа ИИ-подсистем:
поверх коннектора работают агентская петля с инструментами, семантический поиск
по базе знаний (RAG), MCP-сервер для внешних ИИ-агентов, мониторинг ошибок
с ИИ-диагнозом и генератор диаграмм.

Ставится как расширение конфигурации, основную конфигурацию не изменяет.

Готовые сценарии из коробки:

• 🚨 Мониторинг ошибок базы: сбор из журнала регистрации, ИИ-диагноз, Telegram
• 🔍 Аудит кода по ошибке: место в исходниках + объяснение причины
• 🛠 База 1С как набор инструментов для Claude/Cursor (MCP)
• 📊 Диаграммы по текстовому описанию (mermaid/plantuml/graphviz/bpmn)

И API для своих решений:

• 🤖 Чат-боты для поддержки клиентов
• 📝 Генерация контента (описания товаров, документы)
• 🔍 Классификация и извлечение структурированных данных из текста
• 📚 Ответы по своей базе знаний (RAG)
• 🎯 Агенты, которые сами ходят по данным 1С инструментами

✨ Возможности

Коннектор (ядро)

• Пять форматов провайдеров отдельными коннекторами: OpenAI-совместимые API,
  Anthropic, Google Gemini, YandexGPT, GigaChat — плюс 25+ готовых моделей
  в макете предустановок.
• Синхронные и асинхронные запросы (фоновые задания), история сообщений,
  системные промпты.
• Мультимодальность: изображения и документы во вложениях запроса,
  генерация изображений в ответе.
• Кеш ответов с TTL (per-model, opt-in), полное логирование запросов
  (токены, время, ошибки), поддержка прокси, OAuth2 (GigaChat), IAM (Yandex).
• Повторы с экспоненциальным backoff — только транзиентные коды (429/5xx),
  без задвоения POST.

Агентская петля (function calling)

Модель вызывает инструменты 1С и продолжает рассуждение по результатам — во всех
пяти форматах провайдеров. Лимиты раундов и вызовов, дедупликация повторных
вызовов, принуждение к финальному выводу, аудит каждого вызова.

Форматные адаптеры всех провайдеров покрыты тестами; живой прогон выполнялся
на OpenAI-совместимых моделях. Флаги «Поддерживает инструменты» у остальных
провайдеров в предустановках включайте после смоука со своими ключами.

RAG — база знаний

Категории знаний, авто-нарезка документов на фрагменты, эмбеддинги
с версионированием. Знания привязываются к экспертам и подмешиваются в системный
промпт автоматически. Два бэкенда поиска: встроенный (чистый 1С, без зависимостей)
и Qdrant — с очередью синхронизации и фоновой сверкой.
Egress-политики не выпускают конфиденциальные фрагменты за пределы базы.

MCP-сервер

HTTP-сервис (JSON-RPC 2.0): внешние ИИ-агенты работают с базой как с набором
инструментов — метаданные, структура объектов, read-only запросы, диаграммы.
Basic Auth, ограничение частоты, whitelist запросов, сокрытие секретов, аудит
с автоочисткой. ⚠ Наружу публикуйте только через HTTPS (reverse-proxy с TLS).

Мониторинг ошибок

Регламентный сбор из журнала регистрации, нормализация и дедупликация, пакетный
ИИ-анализ и глубокий агентный разбор, уведомления в Telegram с антиспамом,
правила игнорирования, статистика, HTML-дашборд. Плюс аудитор кода: по ошибке
находит место в исходниках и объясняет причину.

Генератор диаграмм

Описание словами → диаграмма (mermaid / plantuml / graphviz / bpmn). Mermaid
рендерится локально встроенной библиотекой mermaid.js — без внешних сервисов;
остальные форматы и серверный рендер (PNG/SVG, MCP-инструмент) — через
kroki. Модель с инструментами сама читает метаданные
конфигурации и рисует реальные реквизиты.

🌐 Поддерживаемые провайдеры

Провайдер	Формат API	Function calling	Статус
OpenAI (GPT-4/5.x)	OpenAI Compatible	✅	✅
Anthropic (Claude)	Anthropic Messages	✅ формат готов	✅
Google (Gemini)	Google AI	✅ формат готов	✅
DeepSeek	OpenAI Compatible	✅	✅
GigaChat (Сбер)	OAuth2 + legacy functions	✅ формат готов	✅
Yandex (YandexGPT)	Yandex Cloud	✅ формат готов	✅
Mistral / Qwen / Groq / Grok	OpenAI Compatible	✅	✅
Ollama / LM Studio / LiteLLM (локальные)	OpenAI Compatible	зависит от модели	✅
OpenRouter / Together / Fireworks и др.	OpenAI Compatible	✅	✅

📦 Установка

Требования

• 1С:Предприятие 8.3.24+ — версия 1.3.0 разрабатывалась и тестировалась
  на 8.3.27
• БСП (Библиотека стандартных подсистем) 3.1.10+ — тестировалось
  на демо-базе БСП 3.1.11.392
• Доступ в интернет для облачных провайдеров (локальные модели работают офлайн)
• Опционально: Qdrant для быстрого векторного поиска,
  kroki для рендера диаграмм

Версии 1.0.x проверялись также на 1С:ERP 2.5.17. Версия 1.3.0 на ERP
не перепроверялась — отчёты о работе на других конфигурациях приветствуются
в Issues.

Шаги установки

1. Скачайте .cfe из Releases
2. Подключите расширение (Администрирование → Расширения конфигурации)
3. Обновите базу данных
4. Откройте справочник «Модели ИИ» и нажмите «Заполнить модели» — загрузятся
   25+ предустановок
5. Укажите API-ключи нужных моделей (хранятся в защищённом хранилище 1С,
   в выгрузки не попадают); кнопка проверки соединения — на форме модели
6. Создайте «Эксперта ИИ»: модель + системный промпт
7. Новые подсистемы включаются заполнением их настроек: Telegram-токен
   для мониторинга, адрес Qdrant для RAG, адрес kroki для диаграмм,
   пользователь API для MCP — что не настроено, то просто не работает,
   не мешая остальному

Обновление с 1.0.x

Штатное: данные моделей и экспертов сохраняются, публичный API совместим
(ЗапросКМодели, ЗапросКМоделиВФоне, ПараметрыМодели — прежние сигнатуры).
Единственное поведенческое изменение: роль «КИИ Полные права» больше
не раздаёт права на объекты основной конфигурации — только на объекты
расширения (закрыта избыточная выдача).

🚀 Быстрый старт

Простейший запрос (3 строки кода)

Модель = Справочники.КИИ_МоделиИИ.НайтиПоНаименованию("gpt-4");
Ответ = КИИ_КоннекторИИ.ЗапросКМодели(Модель, "Привет! Как дела?");

Если Не Ответ.ЭтоОшибка Тогда
    ОбщегоНазначения.СообщитьПользователю(Ответ.ТекстОтвета);
КонецЕсли;

С системным промптом и историей

Промпт = Новый Структура;
Промпт.Вставить("СистемныйПромпт", "Ты — помощник программиста 1С");
Промпт.Вставить("ПользовательскийПромпт", "Как создать новый документ?");
Промпт.Вставить("ИсторияСообщений", История); // необязательно

Ответ = КИИ_КоннекторИИ.ЗапросКМодели(Модель, Промпт);

Асинхронный запрос (фоновое задание)

ДлительнаяОперация = КИИ_КоннекторИИ.ЗапросКМоделиВФоне(Модель, Промпт);
ДлительныеОперации.ОжидатьЗавершение(ДлительнаяОперация);
Ответ = ПолучитьИзВременногоХранилища(ДлительнаяОперация.АдресРезультата);

Markdown → HTML

HTML = КИИ_МаркдаунПарсерКлиентСервер.ПреобразоватьВHTML(Ответ.ТекстОтвета);

Тестирование без кода

Обработка «Тест ИИ»: чат с экспертом, вложения (изображения/документы),
история диалога, просмотр логов — всё интерактивно.

📚 Документация и разработка

• Руководство пользователя (вики) — 1c-ai-connector-guide:
  настройка моделей и провайдеров, RAG и база знаний, мониторинг ошибок
  и аудитор кода, MCP-сервер и безопасность, генератор диаграмм.
• Автотесты (398 YAxUnit-тестов) — 1c-ai-connector-tests;
  для прогона нужны YAxUnit в базе
  и тестовое расширение.
• MCP-прокси для stdio-клиентов — 1c-ai-connector-mcp-proxy
  (Claude Desktop и другие клиенты без HTTP-транспорта).

🔑 Получение API ключей

Инструкции по провайдерам

OpenAI

1. platform.openai.com → API keys → создайте ключ
2. Пополните баланс

Anthropic (Claude)

1. console.anthropic.com → API Keys

Google (Gemini)

1. Google AI Studio → Get API key

DeepSeek

1. platform.deepseek.com → API Keys

GigaChat (Сбер)

1. developers.sber.ru/gigachat
2. Получите Authorization key (или ClientId:ClientSecret) — модуль сам обменяет
   на OAuth2-токен

Yandex GPT

1. Yandex Cloud → сервисный аккаунт → API-ключ
2. В модели укажите Folder ID

🔍 Качество кода

• ✅ 398 модульных тестов (YAxUnit): коннекторы, агентская петля, RAG,
  мониторинг, MCP, парсеры
• ✅ SonarQube (BSL Language Server): 0 замечаний, рейтинги A/A,
  технический долг 0; осознанные исключения задокументированы подавлениями
  с обоснованием прямо в коде
• ✅ Проход сертификационных EDT-проверок (доккомментарии, области, роли)
• ✅ Протестировано на демо-базе БСП 3.1.11.392 / платформе 8.3.27

🗺️ Roadmap

Выполнено (v1.3.0)

• Vision API — изображения и документы во вложениях + генерация изображений
• Улучшенная обработка rate limits — backoff, повтор только транзиентных кодов
• Function calling — агентская петля во всех пяти форматах провайдеров
• Embeddings API — и весь RAG поверх
• Сверх плана: MCP-сервер, мониторинг ошибок с ИИ-анализом, аудитор кода,
  генератор диаграмм, 397 автотестов

Планы

• Streaming — в чистом BSL невозможен (платформа отдаёт HTTP-ответ целиком);
  исследуется эмуляция через фоновое задание с опросом
• Live-смоук function calling на Anthropic/Google/Yandex/GigaChat
  и включение флагов в предустановках
• CI: сборка .cfe, прогон тестов и Sonar на каждый коммит
• Расширение покрытия тестами (инструментальное измерение покрытия)

❓ FAQ

Частые вопросы

Какая платформа 1С поддерживается?

8.3.24+; версия 1.3.0 разрабатывалась и тестировалась на 8.3.27.

Требуется ли БСП?

Да, БСП 3.1.10+ (тестировалось на 3.1.11.392).

Поддерживается ли отправка изображений?

Да, с версии 1.3.0: изображения и документы прикладываются к запросу
(в «Тест ИИ» — вкладка вложений), поддерживается и генерация изображений.

Можно ли использовать без интернета?

Да — локальные модели через Ollama/LM Studio, встроенный RAG-поиск
и локальный рендер mermaid-диаграмм тоже работают без внешних сервисов.

Где хранятся API ключи?

В защищённом хранилище 1С; в выгрузки конфигурации не попадают.

Как контролировать затраты?

Все запросы логируются в регистр с токенами и временем; кеш ответов
сокращает повторные обращения.

Можно ли добавить своего провайдера?

Любой OpenAI-совместимый API работает из коробки: создайте модель, укажите
адрес, формат OpenAI_Compatible, имя модели и ключ.

Можно ли использовать в коммерческих проектах?

Да, лицензия MIT.

🤝 Участие в проекте

• 🐛 Нашли баг? — Issue
• 💡 Есть идея? — Discussions
• 🔧 Хотите помочь? — Pull Request

📄 Лицензия

MIT © 2026 Андриянов Роман (androman.pro)

📞 Контакты

• 🌐 Сайт: androman.pro
• 💬 Telegram: @andromanpro1c
• 📧 Email: [email protected]

---