alonehobo / ai-assistant-1c

# Расширение «ИИ-ассистент» (ИИАссистент)
Чат с ИИ-ассистентом по данным информационной базы ERP. Ассистент отвечает на вопросы, строит запросы и отчёты, рисует графики, открывает объекты, предлагает черновики документов и изменения данных, которые записывает только сам пользователь кнопкой «Выполнить». Работает в пределах прав пользователя, профиля доступа и жёсткого периметра данных, заданного в коде.
Версия расширения и поставляемых данных: `0.2.0.7`. Префикс объектов: `ИИА_`.
Содержание:
1. Быстрый старт
2. Роли и доступ
3. Чат
4. Настройки ассистента
5. Подключения к моделям
6. Профили доступа
7. Версии политик
8. Защита данных: периметр, классы, доверие, маскирование
9. Внешний доступ (HTTP API)
10. Где что хранится
11. Поставляемые данные и обновление
12. Обслуживание и лимиты
---
## Скриншоты
**Отчёт с графиком по данным базы**
**«Показать на форме»: ассистент находит нужное поле в документе**
**Объяснение логики документа по коду конфигурации**
## Состав репозитория
| Путь | Что это |
|---|---|
| `dist/ИИАссистент.cfe` | Готовое расширение, собрано в 1С:ERP 2.5.27, платформа 8.3.27 |
| `src/ИИАссистент/` | XML-исходники расширения (выгрузка конфигуратора) |
| `tools/cfe_for_config.py` | Подготовка исходников к загрузке в другую типовую конфигурацию |
| `docs/third-party/` | Лицензии сторонних компонентов |
## Установка
Готовые сборки для ERP 2.5 и УТ 11.5 — в релизах.
1. Конфигуратор → **Конфигурация → Расширения конфигурации → Добавить из файла** → CFE из релиза для вашей конфигурации (или `dist/ИИАссистент.cfe` для ERP).
 Либо в режиме Предприятия: **Администрирование → Печатные формы, отчёты и обработки → Расширения**.
2. Снимите флаги «Безопасный режим» и «Защита от опасных действий»: расширению нужны HTTP-запросы к моделям.
3. Обновите конфигурацию базы данных и перейдите к быстрому старту.
Для конфигураций других линеек (УНФ и др.) соберите расширение из `src/` по разделу «Типовые конфигурации».
Требования: платформа 8.3.27 и выше, конфигурация на БСП 3.1+.
Сторонний код: модуль `ИИА_HTTPКоннектор` основан на Connector (Apache License 2.0), лицензия — `docs/third-party/connector/LICENSE`. Общий макет `ИИА_Mermaid` содержит Mermaid (MIT), лицензия — `docs/third-party/mermaid-LICENSE.txt`.
---
## 1. Быстрый старт
1. Назначьте администратору профиль групп доступа **ИИА_Администратор** (поставляется расширением).
2. Откройте раздел **ИИ-ассистент → Настройки ИИ-ассистента**, вкладка **Быстрый запуск**:
 - **Шаг 1.** Нажмите «Подключения к моделям», откройте нужное подключение (шесть провайдеров уже заведены и выключены), введите ключ API, включите «Используется». Вернитесь, выберите подключение и нажмите «Проверить модель».
 - **Шаг 2.** Выберите «Профиль по умолчанию» и при необходимости настройте профили.
 - **Шаг 3.** «Проверить доступ» для нужного пользователя.
 - **Шаг 4.** Включите «Использовать ИИ-ассистента» и нажмите «Сохранить настройки и открыть чат».
3. Пользователям назначьте профиль групп доступа **ИИА_Пользователь**.
Пос