# 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: 691
- 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 растущих категории."*

---

## 🎬 Демо

**Простой запрос:** *«Покажи топ контрагентов по суммам приходных накладных»*.

![Демо: топ контрагентов по суммам приходных накладных](docs/articles/product_first_publication/media/demo_top_contractors_incoming_invoices.gif)

- Смотреть видео на 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**
  - Важно: демо-база **доступна всем**. После теста **удалите свой токен/ключ ИИ** из настроек, чтобы его не украли и не “слили” ваш бюджет.

**Скриншоты:**

![Скриншот: форма агента](docs/articles/product_first_publication/media/screenshot_agent_ui.png)

![Скриншот: RAG/поиск по метаданным](docs/articles/product_first_publication/media/screenshot_rag_context.png)


---

## 🛠 Ключевые возможности

*   **🤖 Автопилот:** Проактивное исследование структуры объектов и получение реквизитов.
*   **🔍 Умный 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`

---

## 🛡 Безопасность и надежность

Мы понимаем ценность ваших данных. Агент спроектирован с учетом корпоративных стандартов:
*   **Валидация данных:** Защита от галлюцинаций — агент оперирует только реально полученными данными из БД.
*   **Контроль записи:** Возможность полного запрета на изменение данных для конкретных пользователей.

---

## ⚠️ Отказ от ответственности

Программное обеспечение предоставляется «как есть», без каких-либо гарантий, явных или подразумеваемых. Разработчики и правообладатели не несут ответственности за любые прямые, косвенные, случайные или иные убытки, возникшие в результате использования или невозможности использования данного ПО. Использование агента в производственной среде осуществляется исключительно на ваш собственный риск. Рекомендуется тщательное тестирование перед развёртыванием в критичных системах.

---

## 📰 Статьи

[![Infostart](https://infostart.ru/bitrix/templates/sandbox_empty/assets/tpl/abo/img/logo.svg)](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С.*