Add AI settings setup

ai_functions/ai_external_model.rst

+Подключение внешней модели ИИ
+==============================
+
+Платформа Synergy поддерживает подключение внешних языковых моделей
+через API. Это позволяет использовать коммерческие модели,
+например Claude от Anthropic, для выполнения интеллектуальных задач
+в рамках бизнес-процессов.
+
+Настройка выполняется в разделе администрирования системы:
+перейдите в **Администрирование → Настройки системы → Настройки ИИ**
+и нажмите **«Добавить функцию ИИ»**.
+
+Для подключения внешней модели потребуются три параметра:
+
+* **Адрес хоста** — URL API провайдера;
+* **Модель ИИ** — идентификатор конкретной модели;
+* **API ключ** — ключ для аутентификации запросов.
+
+Ниже приведена пошаговая инструкция на примере Claude (Anthropic).
+
+
+Шаг 1. Узнать адрес API
+------------------------
+
+Claude использует следующий базовый адрес API::
+
+   https://api.anthropic.com
+
+Полную документацию по API можно найти по адресу:
+`platform.claude.com/docs/en/api/overview <https://platform.claude.com/docs/en/api/overview>`_
+
+Укажите этот адрес в поле **«Адрес хоста»** при настройке функции ИИ.
+
+
+Шаг 2. Выбрать модель
+----------------------
+
+Anthropic регулярно выпускает новые версии моделей Claude.
+Актуальный список доступных моделей и их идентификаторы
+опубликованы по адресу:
+`platform.claude.com/docs/en/about-claude/models/overview <https://platform.claude.com/docs/en/about-claude/models/overview>`_
+
+На странице указаны идентификаторы моделей в формате, который нужно
+использовать в поле **«Модель ИИ»**. Например::
+
+   claude-sonnet-4-5
+
+.. note::
+   Рекомендуется выбирать актуальную версию модели из официального
+   списка, поскольку устаревшие модели могут быть отключены
+   провайдером.
+
+.. figure:: ../images/claude_models.png
+
+   Доступные модели claude.ai
+
+
+Шаг 3. Пополнить баланс
+------------------------
+
+Для работы через API необходимо наличие средств на балансе аккаунта Anthropic.
+Пополнение выполняется в личном кабинете на странице:
+`platform.claude.com/settings/billing <https://platform.claude.com/settings/billing>`_
+
+.. figure:: ../images/claude_billing.png
+
+   Страница биллинга
+
+.. note::
+   API работает по модели оплаты за использование (pay-as-you-go):
+   средства списываются за количество обработанных токенов.
+   Убедитесь, что баланс пополнен до начала работы.
+
+
+Шаг 4. Создать API ключ
+------------------------
+
+API ключ — это строка, которая используется платформой Synergy
+для аутентификации запросов к Claude API.
+
+Для создания ключа:
+
+1. Откройте страницу управления ключами:
+   `platform.claude.com/settings/keys <https://platform.claude.com/settings/keys>`_
+2. Нажмите кнопку **«Create Key»**.
+3. Укажите название ключа (произвольное, для удобства идентификации).
+4. Скопируйте сгенерированный ключ — он отображается только один раз.
+
+.. figure:: ../images/claude_api_page.png
+
+   Страница создания API ключа
+
+.. warning::
+   Сохраните ключ сразу после создания: после закрытия окна
+   просмотреть его повторно будет невозможно.
+   При утере ключа потребуется создать новый.
+
+Скопированный ключ укажите в поле **«API ключ»** при настройке функции ИИ.
+
+
+Итоговая настройка в Synergy
+-----------------------------
+
+После получения всех необходимых данных перейдите в
+**Администрирование → Настройки системы → Настройки ИИ**
+и заполните параметры подключения:
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Поле
+     - Значение
+   * - Адрес хоста
+     - ``https://api.anthropic.com``
+   * - Модель ИИ
+     - Идентификатор модели из списка моделей (например, ``claude-sonnet-4-5``)
+   * - API ключ
+     - Ключ, созданный в личном кабинете Anthropic
+
+Сохраните настройки. После этого модель будет доступна для использования
+в функциях ИИ платформы Synergy.
+
+.. figure:: ../images/synergy_ai_setting.png
+ 
+
+   

ai_functions/index.rst

@@ -4,5 +4,5 @@
 .. toctree::
    :maxdepth: 2
 
+   ai_external_model
    ai_ocr
-   
\ No newline at end of file