1c Ai Connector

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

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

[](https://opensource.org/licenses/MIT) [](https://1c.ru) [](https://github.com/andromanpro/1c-ai-connector/releases) [](#-качество-кода)

🎯 О проекте

ИИкона (КИИ — Коннектор Искусственного Интеллекта) — расширение для работы с языковыми моделями прямо из 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+ предустановок

1. Укажите API-ключи нужных моделей (хранятся в защищённом хранилище 1С,

в выгрузки не попадают); кнопка проверки соединения — на форме модели

1. Создайте «Эксперта ИИ»: модель + системный промпт
2. Новые подсистемы включаются заполнением их настроек: 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)

• [x] Vision API — изображения и документы во вложениях + генерация изображений
• [x] Улучшенная обработка rate limits — backoff, повтор только транзиентных кодов
• [x] Function calling — агентская петля во всех пяти форматах провайдеров
• [x] Embeddings API — и весь RAG поверх
• [x] Сверх плана: 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](LICENSE) © 2026 Андриянов Роман (androman.pro)

📞 Контакты

• 🌐 Сайт: androman.pro
• 💬 Telegram: @andromanpro1c
• 📧 Email: andromanpro@gmail.com

---

Сделано с ❤️ для сообщества 1С

⭐ Поставьте звезду • 💬 Обсуждения • 🐛 Сообщить об ошибке

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: andromanpro
• Source: andromanpro/1c-ai-connector
• License: MIT
• Homepage: https://androman.pro

Install and usage instructions live in the source repository linked above.