АИ Новости

Вот готовый текст для раздела «Установка и настройка» в карточке решения Маркетплейс. Он разбит на логические этапы, понятные конечному пользователю.

***

### Инструкция по установке и настройке модуля «АИ Новости»

**1. Установка модуля**
Установка выполняется стандартными средствами системы:
1. Перейдите в раздел **Администрирование -> Marketplace -> Установленные решения**.
2. Найдите модуль **«АИ Новости (magicolors.ainews)»** и нажмите кнопку **«Установить»**.
3. Дождитесь завершения процесса и нажмите **«Перейти к настройкам»** (или найдите модуль в списке установленных по названию).

**2. Получение API-ключа (внешний сервис)**
Для генерации текста используется сервис **ProxyAPI** (шлюз к моделям OpenRouter). Ключ приобретается отдельно.
1. Зарегистрируйтесь или авторизуйтесь на сайте `proxyapi.ru`.
2. Перейдите в личный кабинет и создайте новый API-токен.
3. Скопируйте полученный ключ (имеет формат `sk-...`).

**3. Настройка модуля**
1. Перейдите на страницу настроек: **Администрирование -> Настройки -> Настройки продукта -> АИ Новости** (или в меню Контент).
2. В открывшейся форме заполните поля:
  * **API ключ (proxyapi.ru):** Вставьте скопированный ранее токен.
  * **Инфоблок для генерации новостей:** Выберите из списка тот инфоблок, в котором нужно автоматически создавать контент (например, «Новости компании»).
3. Нажмите кнопку **«Сохранить»**.

**4. Важное дополнение для корректной работы (Рекомендуется)**
Генерация текста нейросетью может занимать несколько десятков секунд. Чтобы избежать разрыва соединения с базой данных MySQL (ошибка *«MySQL server has gone away»*), необходимо увеличить время ожидания ответа от БД.
1. Создайте файл `/bitrix/php_interface/after_connect.php`.
2. Добавьте в него следующий код:
```php
<?php
$DB->Query("SET wait_timeout=28800");
```
*Если такой файл уже существует, просто добавьте указанную строку в конец перед `?>`.*

**5. Проверка работы**
1. Перейдите в выбранный инфоблок и создайте новый элемент.
2. **Обязательно** заполните поле **«Название»** (тема новости). Поля «Анонс» и «Подробно» оставьте **пустыми**.
3. Нажмите «Применить» или «Сохранить».
4. Подождите 5-10 секунд и обновите страницу элемента (или вернитесь в список элементов и снова зайдите в редактирование).
5. Поля «Анонс» и «Подробно» должны автоматически заполниться сгенерированным текстом.

**Возможные проблемы:**
* **Текст не появился:** Проверьте баланс и активность токена на сайте proxyapi.ru, а также наличие файла `after_connect.php` (пункт 4).
* **Ошибка формата ответа:** Проверьте, что на хостинге доступна библиотека **cURL** для PHP.

Здравствуйте!