> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/modules/miko/module-a-i-supervisor/quick-start.md). # Быстрый старт Инструкция по быстрому началу работы с модулем ИИ Супервайзер ### Перед началом Для работы понадобятся: * MikoPBX 2025.1.1 или новее; * Mac с Apple Silicon и macOS 14 или новее; * доступ Mac к веб-интерфейсу MikoPBX. {% hint style="info" %} ИИ Супервайзер анализирует готовые расшифровки. Если распознавание речи ещё не настроено, сначала выполните [быстрый старт модуля локального распознавания речи](/mikopbx/modules/miko/module-local-speech-to-text/quick-start.md). {% endhint %} ### Установка модуля 1. Откройте веб-интерфейс MikoPBX. 2. Перейдите в раздел **Модули** → **Маркетплейс модулей**.

3. Найдите **Модуль ИИ Супервайзер** и установите его. 4. Откройте список установленных модулей и включите модуль.

5. Нажмите значок **Настройки** справа от версии модуля.

### Настройка модуля #### 1. Создайте ключ обработчика Откройте "**Настройки"** → "**Обработчики"**. Нажмите кнопку создания ключа доступа. Скопируйте показанное значение. Полный ключ отображается только один раз. После закрытия окна в списке останутся только безопасные сведения о ключе.

#### 2. Выберите состав анализа и модель Откройте **Настройки** → **ИИ-анализ**. Выберите компоненты линии анализа под Ваши задачи: * **Сводка** - Структурированный разбор звонка, темы, риски, качество. Базовый компонент модуля. Проивзодится выбранной LLM моделью. * **Голосовые метрики** - Темп, паузы, перебивания, тишина и баланс участников. Анализ технических аспектов звонка. * **Анализ эмоций** - Текстовое определение эмоций по фрагментам разговора. * **Акустический анализ** - выявление акустических признаков записи с помощью акустической модели. Используется для того, чтобы подтвердить или опровергнуть результаты голосовых метрик и анализ эмоций LLM моделью; Так же выберите профиль модели. Подробнее можно прочитать [здесь](/mikopbx/modules/miko/module-a-i-supervisor.md#ii-analiz).

#### 3. Включите поток звонков Откройте **Настройки** → **Поток звонков** и проверьте: * **Автоматический ИИ-анализ** включён; * **Автоматический импорт** включён; * выбран нужный язык результата; * обработка внутренних звонков включена, если она требуется; * установлен подходящий срок хранения данных.

### Настройка AI Supervisor Worker #### 1. Установите приложение Перейдите в раздел "Обработчики", нажмите "Скачать обработчик". Произведите установку скаченного .dmg #### 2. Выберите язык Откройте приложение **AI Supervisor Worker**. На первом этапе выберите язык интерфейса и нажмите **Продолжить**. Если приложение предложит перезапуск после смены языка, выполните его.

#### 3. Подключитесь к MikoPBX На этапе подключения укажите: * адрес MikoPBX в формате `https://...` или `http://...`; * понятное имя этого Mac; * ключ для AI Supervisor обработчика, созданный в модуле ранее. Откройте **Расширенные настройки**, только если нужно изменить стабильный UID обработчика, проверку TLS или выбрать собственный PEM-файл CA. Нажмите **Подключить и продолжить** - приложение проверит адрес, ключ и контракт worker API v2.

#### 4. Подготовьте локальный ИИ На этапе **Подготовка локального ИИ** приложение последовательно проверяет: 1. локальную среду Ollama; 2. модель, выбранную в MikoPBX; 3. готовность обработчика. Если Ollama не установлена, нажмите **Установить Ollama**. После установки нажмите **Подготовить и запустить**. Приложение загрузит выбранную модель, зарегистрирует этот Mac и запустит обработчик. Первая загрузка модели может занять продолжительное время. Не закрывайте приложение и убедитесь, что на Mac достаточно свободного места.

#### 4. Завершите настройку На последнем этапе проверьте состояния **MikoPBX**, **Локальная модель** и **AI Worker**. При необходимости включите: * Запускать при входе - при этой настройке приложение будет открываться автоматически при входе в macOS. * Поддерживать работу обработчика - при этой настройке Worker автоматически возобновляет работу после восстановления сети или пробуждения Mac (при возникшей ошибке). Нажмите **Открыть AI Supervisor Worker**.

### Проверка результата 1. В AI Supervisor Worker откройте **Обзор**. Состояние должно показывать готовность к новым заданиям. 2. В MikoPBX откройте **Настройки** → **Система** → **Обработка** и убедитесь, что задания переходят из ожидания в работу. 3. После завершения откройте вкладку **Звонки** и выберите обработанный звонок.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.mikopbx.com/mikopbx/modules/miko/module-a-i-supervisor/quick-start.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.