msrv-tech/AI_agent
Интеллектуальный помощник для автоматизации процессов в системах 1С:Предприятие. Анализирует данные, генерирует запросы, ускоряет принятие решений и снижает нагрузку на IT-поддержку. Подходит для основных типовых клнфигураций
# AI_agent
> Интеллектуальный помощник для автоматизации процессов в системах 1С:Предприятие. Анализирует данные, генерирует запросы, ускоряет принятие решений и снижает нагрузку на IT-поддержку. Подходит для основных типовых клнфигураций
- GitHub: https://github.com/msrv-tech/AI_agent
- Gitsell page: https://gitsell.ru/msrv-tech/AI_agent
- Visibility: public/free
- GitHub stars: 87
- Gitsell views: 690
- Gitsell downloads: 162
## 1C Configurations
Not specified.
## Pricing
Free or price is not specified.
## README
# 🚀 ИИ-Агент для 1С:Предприятие
**Превратите ваш 1С в интеллектуальную экосистему. Общайтесь с данными на естественном языке, автоматизируйте рутину и принимайте решения быстрее.**
> ⚠️ **Бета-версия** — проект в активной разработке, возможны частые обновления и изменения.
---
## ✨ Почему это меняет правила игры?
### 💼 Для бизнеса
* **Доступность данных:** Получайте отчеты и аналитику, просто задав вопрос в чате. Больше не нужно ждать программиста для написания простого запроса.
* **Скорость принятия решений:** Мгновенный поиск информации по всей базе данных (товары, остатки, задолженность).
* **Снижение затрат:** Автоматизация типовых операций и первичной поддержки пользователей.
### 🛠 Для разработчиков и администраторов
* **Умный Discovery:** Агент сам исследует метаданные, находит нужные справочники и документы, понимает связи между ними.
* **Автогенерация запросов:** Забудьте о ручном написании сложных запросов. Агент строит их сам на языке 1С.
* **Режим планирования:** Вы всегда видите, что собирается сделать агент. Прозрачность и контроль на каждом шаге.
* **Безопасность из коробки:** Гибкие настройки прав доступа и Read-Only режим для защиты данных.
---
## 🧠 Как это работает?
Агент не просто отвечает на вопросы — он **действует**. Процесс работы построен на цикле автономного планирования:
```mermaid
graph TD
User((Пользователь)) -->|Запрос на естественном языке| Agent[ИИ-Агент]
Agent -->|Анализ| Plan[Составление плана действий]
Plan -->|Шаг 1| Discovery[Поиск метаданных и RAG]
Plan -->|Шаг 2| DSL[Генерация и выполнение команд]
DSL -->|Результат| Validation[Проверка и коррекция ошибок]
Validation -->|Успех| Final((Ответ пользователю))
Validation -->|Ошибка| Plan
```
---
## 💬 Что можно спросить?
* *"Найди все заказы клиента 'ТехноПром' за прошлую неделю и выведи общую сумму."*
* *"Какие товары на складе 'Основной' имеют остаток меньше 5 штук?"*
* *"Создай черновик приходной накладной от поставщика 'Мир Мебели' на основании счета №123."*
* *"Проанализируй динамику продаж за последний месяц и выдели топ-3 растущих категории."*
---
## 🎬 Демо
**Простой запрос:** *«Покажи топ контрагентов по суммам приходных накладных»*.
- Смотреть видео на Rutube: [rutube.ru/video/70b6925431794a787177936b374d868d](https://rutube.ru/video/70b6925431794a787177936b374d868d/)
- Демо-база: [app498780.1capp.net/1SUpravleniye-torgovley-II-agent](https://app498780.1capp.net/1SUpravleniye-torgovley-II-agent/)
- Доступ: логин **Администратор**, пароль **123456**
- Важно: демо-база **доступна всем**. После теста **удалите свой токен/ключ ИИ** из настроек, чтобы его не украли и не “слили” ваш бюджет.
**Скриншоты:**
---
## 🛠 Ключевые возможности
* **🤖 Автопилот:** Проактивное исследование структуры объектов и получение реквизитов.
* **🔍 Умный RAG-поиск:** Поиск объектов конфигурации по смыслу, а не только по названию.
* **⚡ Оптимизация контекста:** Технология *Context Saver* позволяет работать даже в огромных конфигурациях (ERP, УТ 11, КА).
* **🔧 Умная обработка ошибок:** Автоматическое исправление сценариев и динамическая подстройка параметров модели.
* **🔌 Гибкость:** Поддержка любых OpenAI-совместимых провайдеров, включая локальные LLM по `http`; [Gitsell AI Proxy](https://gitsell.ru/ai-proxy) — из коробки.
---
## 📚 Документация
| Раздел | Описание |
| :--- | :--- |
| 📋 [**Планирование**](docs/PLANNING.md) | Глубокое погружение в механизм составления планов. |
| 💻 [**DSL Команды**](docs/DSL.md) | Описание языка, на котором агент общается с 1С. |
| 🏗 [**Архитектура**](docs/AGENT_ARCHITECTURE.md) | Техническое устройство модулей и потоки данных. |
| 🧭 [**LangGraph Runtime**](docs/LANGGRAPH_RUNTIME_FINAL.md) | Итоговая архитектура LangGraph-style runtime: графы, subgraphs, replay safety, policy layer, metrics и investigation API. |
| 🛡 [**Безопасность**](docs/SECURITY.md) | Как настроить ограничения и защитить базу. |
| 🔎 [**RAG Поиск**](docs/RAG.md) | Подробности работы семантического поиска по метаданным. |
| 🧪 [**Тестирование**](docs/TESTING.md) | Инструменты для проверки качества работы агента. |
| 📊 [**Стратегия оценки**](docs/EVAL_STRATEGY.md) | Как сочетать локальный benchmark и Tau-Bench без самообмана в KPI. |
| 📏 [**Tau-Bench**](docs/TAU_BENCH.md) | Внешний benchmark для сравнения с публичным tool-use baseline. |
| 🔌 [**Tau Bridge**](docs/TAU_AGENT_BRIDGE.md) | Scaffold для запуска 1С-агента внутри внешнего benchmark-контура. |
| ▶ [**Tau Real Run**](docs/TAU_REAL_RUN.md) | Как запускать Tau-Bench с 1С-backed custom agent. |
**Удобное скачивание, техподдержка, подписка на обновления:** [gitsell.ru/msrv-tech/AI_agent](https://gitsell.ru/msrv-tech/AI_agent)
---
## 🚀 Быстрый старт
1. **Установка:** Загрузите расширение в вашу базу 1С.
2. **Настройка:** Укажите адрес OpenAI-совместимого провайдера и модель.
Для облачного провайдера по `https` обычно нужен API-ключ.
Для локального сервера по `http` API-ключ можно оставить пустым.
3. **Индексация:** Запустите первичный сбор метаданных для обучения RAG-поиска.
4. **Готово!** Откройте форму агента и задайте свой первый вопрос.
Примеры:
- `https://gitsell.ru/api/v1` + `gpt-5.4-nano`
- `https://api.openai.com/v1` + `gpt-4.1`
- `http://localhost:1234/v1` + `qwen3-8b`
---
## 🛡 Безопасность и надежность
Мы понимаем ценность ваших данных. Агент спроектирован с учетом корпоративных стандартов:
* **Валидация данных:** Защита от галлюцинаций — агент оперирует только реально полученными данными из БД.
* **Контроль записи:** Возможность полного запрета на изменение данных для конкретных пользователей.
---
## ⚠️ Отказ от ответственности
Программное обеспечение предоставляется «как есть», без каких-либо гарантий, явных или подразумеваемых. Разработчики и правообладатели не несут ответственности за любые прямые, косвенные, случайные или иные убытки, возникшие в результате использования или невозможности использования данного ПО. Использование агента в производственной среде осуществляется исключительно на ваш собственный риск. Рекомендуется тщательное тестирование перед развёртыванием в критичных системах.
---
## 📰 Статьи
[](https://infostart.ru/1c/articles/2631305/)
- [**Хабр:** ИИ‑агент внутри 1С](https://habr.com/ru/articles/1006230/)
- [**Infostart:** 1C AI Agent — продукт, который не «поговорить», а «сделать»](https://infostart.ru/1c/articles/2631305/)
- [**Infostart:** 1C AI Agent 0.8.5 — графовый агент, файлы и follow-up запросы 1С](https://infostart.ru/1c/articles/2688472/)
---
*Разработано с ❤️ для сообщества 1С.*