> 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).

# Быстрый старт

Быстрый запуск модуля Локальный ИИ Супервайзер и приложения AI Supervisor Worker

### Перед началом

Для работы понадобятся:

* MikoPBX **2025.1.1** или новее;
* установленный и настроенный модуль транскрибации: **Локальная транскрибация** 1.102+ или **Облачная транскрибация** 1.75+;
* Mac с Apple Silicon и macOS 14 или новее;
* сетевой доступ от Mac к веб-интерфейсу MikoPBX.

{% hint style="info" %}
Локальный ИИ Супервайзер анализирует готовые расшифровки. Если транскрибация еще не настроена, сначала выполните [быстрый старт модуля локальной транскрибации](/mikopbx/modules/miko/module-local-speech-to-text/quick-start.md) или настройте [модуль облачной транскрибации](/mikopbx/modules/miko/module-cloud-speech-to-text.md).
{% endhint %}

### Установка модуля

1. Откройте веб-интерфейс MikoPBX.
2. Перейдите в раздел **Модули** → **Маркетплейс модулей**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FmxR3E47vRwk4is6vayNM%2FMikoPBXModuleMarketplace.png?alt=media&amp;token=13a28fc5-173b-4251-bfd9-d362dcd73a6b" alt=""><figcaption><p>Раздел «Маркетплейс модулей»</p></figcaption></figure>

3. Найдите модуль **Локальный ИИ Супервайзер** и установите его.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F1d82FeHPpX1f3mbx2iUb%2FLASInMarketplace.png?alt=media&amp;token=5763a013-8e7e-4422-bb1d-efc04eb6ac87" alt=""><figcaption><p>Установка модуля</p></figcaption></figure>

4. Откройте список установленных модулей и включите модуль. Нажмите кнопку настроек справа от версии модуля.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FS7OR4kAFPORmZLtQ39v3%2FLASInstalled.png?alt=media&amp;token=b89c963e-1635-4a8d-a9f4-81c9c36e76c0" alt=""><figcaption><p>Раздел «Установленные модули» - включение модуля «Локальный ИИ Супервайзер» и кнопка перехода к его настройкам</p></figcaption></figure>

### Шаг 1. Выберите источник расшифровок

При первом открытии модуля запустится мастер настройки.

1. Выберите модуль транскрибации, из которого будут поступать расшифровки. Источник должен быть в состоянии **Готов**.
2. Укажите, с какого момента анализировать звонки: **С этого момента**, **За последний день**, **За 7 дней** или **За 30 дней**.
3. Нажмите **Далее**.

{% hint style="info" %}
Чем больше период, тем больше звонков окажется в очереди после запуска. Для первого знакомства с модулем удобно выбрать **За последний день**: результаты появятся быстро, и на них сразу можно посмотреть.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F4RjWFBIkNO4eNguKFZiZ%2FLASOnboardingP1.png?alt=media&amp;token=4774744b-ea2b-4515-b8d1-daa8014ef36b" alt=""><figcaption><p>Мастер настройки - шаг 1 «Источник расшифровок»</p></figcaption></figure>

### Шаг 2. Скачайте приложение и создайте ключ

1. Нажмите **Скачать обработчик** и установите AI Supervisor Worker из загруженного `.dmg` на Mac.
2. Нажмите **Создать ключ доступа** и сразу скопируйте ключ: он показывается только один раз.

Не закрывайте мастер - после подключения приложения в нем отобразится статус воркера.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FRUS57LHNC6d4jTtjeO1N%2FLASOOnboardingP2.png?alt=media&amp;token=86044e00-3d7e-410d-81b4-146f3fa984e4" alt=""><figcaption><p>Мастер настройки - шаг 2 «Локальный воркер»: скачивание приложения и создание ключа</p></figcaption></figure>

### Настройка AI Supervisor Worker

#### 1. Выберите язык

Откройте приложение **AI Supervisor Worker**. На первом экране выберите язык интерфейса и нажмите **Продолжить**. Если приложение предложит перезапуск после смены языка, выполните его.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FAsCZ5NPy0K3gZJMh01EH%2FAIWorkerOBLanguage.png?alt=media&amp;token=dc296117-7768-44fc-8f2f-2661a4bef361" alt=""><figcaption><p>Экран выбора языка приложения</p></figcaption></figure>

#### 2. Подключитесь к MikoPBX

На этапе подключения укажите:

* адрес MikoPBX в формате `https://...` или `http://...`;
* понятное имя этого Mac;
* ключ доступа, созданный в мастере настройки модуля.

Откройте **Расширенные настройки**, только если нужно отключить проверку TLS или выбрать собственный PEM-файл CA. Нажмите **Подключить и продолжить** - приложение проверит адрес и ключ.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F7dMfB24tbHp48fPIQoBd%2FAIWorkerOBConnection.png?alt=media&amp;token=8535d91a-1ede-4001-a115-767d7d1d2b82" alt=""><figcaption><p>Подключение к MikoPBX</p></figcaption></figure>

#### 3. Подготовьте локальный ИИ

На этапе **Подготовка локального ИИ** приложение проверяет:

1. локальную среду Ollama;
2. модель, выбранную в MikoPBX;
3. готовность обработчика.

Если Ollama не установлена, нажмите **Установить Ollama**. Затем нажмите **Подготовить и запустить**: приложение загрузит модель, зарегистрирует Mac в MikoPBX и запустит обработчик.

{% hint style="warning" %}
Первая загрузка модели может занять продолжительное время. Не закрывайте приложение и убедитесь, что на Mac достаточно свободного места.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FU2ASAGQakqIvEQF9Xlxo%2FAIWorkerOBModelPreparation.png?alt=media&amp;token=b3e346fd-8d11-4ec7-9234-56fa10aefc5d" alt=""><figcaption><p>Подготовка локальной модели</p></figcaption></figure>

#### 4. Завершите настройку приложения

На последнем экране проверьте состояния **MikoPBX**, **Локальная модель** и **AI Worker**.

При необходимости включите:

* **Запускать при входе** - приложение будет открываться автоматически при входе в macOS;
* **Поддерживать работу обработчика** - обработчик сам возобновит работу после восстановления сети или пробуждения Mac.

Нажмите **Открыть AI Supervisor Worker**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fy5tGiL6Y17fUD38mbhLa%2FAIWorkerOBFinal.png?alt=media&amp;token=09e0bf2c-2c12-4bb2-ab9e-94e1eb7a9b0b" alt=""><figcaption><p>Финальный экран первичной настройки приложения</p></figcaption></figure>

### Шаг 3. Завершите мастер в MikoPBX

Вернитесь в веб-интерфейс MikoPBX. Когда приложение подключится, статус воркера в мастере сменится на **Подключён и онлайн**. Нажмите **Завершить настройку**.

Мастер покажет сообщение **Анализ запущен**: звонки начнут импортироваться и анализироваться. Нажмите **Перейти к обзору**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F6EKlASwAOC4pdIUyLBBf%2FLASOOnboardingP3.png?alt=media&amp;token=589160a1-4a92-42b1-b84a-2f4b958311c2" alt=""><figcaption><p>Мастер настройки - итоговый экран «Анализ запущен»</p></figcaption></figure>

{% hint style="info" %}
Если Mac пока не готов, на шаге 2 можно нажать **Пропустить, подключу позже**. Импорт звонков начнется сразу, а анализ - после подключения приложения. Ключ доступа в этом случае создается в разделе **Настройки** → **Обработчики**.
{% endhint %}

### Проверка результата

1. В AI Supervisor Worker откройте раздел **Обзор**: состояние должно показывать готовность к новым заданиям.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F2aK0QHODs9jcoH9JL09I%2FAIWorkerStatus.png?alt=media&amp;token=004f61e7-c0b7-43c9-aa5b-62ef54a16712" alt=""><figcaption><p>Раздел «Обзор» в приложении</p></figcaption></figure>

2. В MikoPBX откройте **Настройки** → **Система** → **Обработка** и убедитесь, что задания переходят из **Ожидают** в **В работе** и **Готово**.
3. Откройте вкладку **Звонки** и выберите обработанный звонок, чтобы посмотреть результат анализа.

СКРИНШОТ: Вкладка «Звонки» - первый проанализированный звонок

### Что настроить дальше

* **Настройки** → **Поток звонков** - включите обработку внутренних звонков, выберите язык результатов ИИ и срок хранения данных.
* **Настройки** → **ИИ-анализ** - включите дополнительные компоненты анализа и при необходимости выберите модель повышенного качества.
* **Настройки** → **Скрипты** - задайте требования к разговору для сотрудников.

Подробное описание всех разделов приведено в статье [Локальный ИИ Супервайзер](/mikopbx/modules/miko/module-a-i-supervisor.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mikopbx.com/mikopbx/modules/miko/module-a-i-supervisor/quick-start.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.