Настройка подключения к ИИ
===========================

Перед использованием ИИ функций необходимо один раз настроить подключение
к выбранной языковой модели. Это выполняется администратором системы.

Путь в системе
--------------

**Администрирование → Настройки Системы → Настройки ИИ**

.. figure:: ../resources/img/ai_settings_menu.png

   Раздел «Настройки ИИ» в меню администрирования

Заполните следующие поля:

**Провайдер**
    Определяет тип подключения к модели.

    * **Встроенное решение** — если модель развёрнута на собственном сервере.
    * **Другой** — для подключения внешней модели (ChatGPT, Gemini, Claude и др.).

.. seealso::

   `Подробная инструкция по настройке внешней модели <https://rtd.lan.arta.kz/docs/docs-po-platforme-arta-synergy/ru/latest/ai_functions/ai_external_model.html>`_

**Название провайдера**
    Необязательное поле. Укажите любое удобное название для идентификации.

**Хост**
    Адрес сервера, на котором расположена модель.

    Пример для Claude: ``https://api.anthropic.com``

**Модель ИИ**
    Идентификатор модели, предоставляемый поставщиком.

    Пример для Claude: ``claude-haiku-4-5-20251001``

**API ключ**
    Секретный ключ доступа. Выдаётся в консоли поставщика ИИ.

**Параметры запросов**
    * **Таймаут** — время ожидания ответа от ИИ (в секундах).
    * **Количество попыток** — сколько раз система будет повторять запрос при ошибке.


.. note::

   После сохранения настроек ИИ функции становятся доступны в Дизайнере приложений.
