> 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/miko-ai-worker.md).

# AI Supervisor Worker

Установка и работа AI Supervisor Worker: подключение к MikoPBX, локальные модели, обработка заданий, голосовая аналитика и диагностика на Mac.

**AI Supervisor Worker** - самостоятельное приложение для macOS, которое выполняет локальный ИИ-анализ готовых расшифровок из MikoPBX. Приложение получает задания от **Модуля ИИ Супервайзер**, использует локальную языковую модель, обрабатывает запись звонка и отправляет структурированный результат обратно в PBX.

Приложение не выбирает звонки для анализа и не хранит серверную очередь. Импорт расшифровок, состав анализа, профиль модели, язык результата, правила внимания и сохранённые результаты управляются модулем на стороне MikoPBX.

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

### Требования и совместимость

* Mac с Apple Silicon.
* macOS 14 или новее.
* MikoPBX 2025.1.1 или новее.
* Доступ Mac к MikoPBX.
* Локальная среда Ollama или совместимый с OpenAI локальный endpoint.
* Доступ в интернет при первой установке среды и моделей.

### Навигация приложения

В боковой панели доступны:

| Раздел          | Назначение                                                               |
| --------------- | ------------------------------------------------------------------------ |
| **Обзор**       | Готовность обработчика, соединение, текущая работа и краткая статистика. |
| **Активность**  | Текущее задание и локальная история обработки с фильтрами и экспортом.   |
| **Модели**      | Ollama, выбранная PBX модель, компоненты анализа и локальные модели.     |
| **Диагностика** | Соединение, готовность среды, автоматическое восстановление и журнал.    |
| **Настройки**   | Подключение к MikoPBX, локальное поведение и параметры анализа.          |

Отдельного экрана **Регистрация** больше нет. Адрес PBX, токен, имя и UID обработчика находятся в разделе **Настройки**.

### Раздел «Обзор»

**Обзор** - основной экран состояния AI Supervisor Worker. Здесь находятся:

* общий статус и главное доступное действие;
* состояние соединения с MikoPBX и время последнего контакта;
* количество обработанных сегодня звонков и доля успешных;
* текущая работа и ход выполнения задания;
* последние локальные задания.

Основные состояния:

| Состояние                         | Что делать                                              |
| --------------------------------- | ------------------------------------------------------- |
| **Требуется настройка**           | Откройте подключение и укажите адрес PBX и токен.       |
| **Проверка локального ИИ**        | Дождитесь проверки Ollama и моделей.                    |
| **Загрузка модели**               | Не закрывайте приложение до завершения загрузки.        |
| **Локальный ИИ требует внимания** | Откройте раздел **Модели**.                             |
| **Готов к запуску**               | Нажмите **Запустить обработчик**.                       |
| **Всё работает**                  | Обработчик подключён и автоматически проверяет очередь. |
| **Анализируется звонок**          | Текущее задание обрабатывается локально.                |
| **Подключение к MikoPBX**         | Обработчик автоматически восстанавливает соединение.    |
| **Обработчик требует внимания**   | Откройте **Диагностику**.                               |

### Раздел «Активность»

В разделе **Активность** отображается текущая работа и сохранённая на этом Mac история заданий. История сохраняется после перезапуска приложения, но не является серверной очередью MikoPBX.

Доступны:

* периоды 24 часа, 7 дней и 30 дней;
* фильтры **В работе**, **Отложено**, **Завершено** и **Ошибка**;
* поиск по заданию и идентификатору звонка;
* раскрытие строки с моделью, типом анализа, компонентами и текстом ошибки;
* экспорт видимых строк в CSV.

Статус **Отложено** означает, что обработчик безопасно освободил задание для повторной обработки, например при временно недоступной локальной модели или зависимости.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FllgRo9ALM6gH7lqOY5S7%2FAIWorkerActivity.png?alt=media&amp;token=d721af6a-20fb-4578-8a48-63c0fb04b7e1" alt=""><figcaption><p>Раздел "Активность" в интерфейсе приложения</p></figcaption></figure>

### Раздел «Модели»

Раздел **Модели** показывает локальную среду, профиль анализа из MikoPBX и установленные модели.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Ffe1eLNmR9oS0J0B8WrMc%2FAIWorkerModels.png?alt=media&amp;token=1be45598-71f3-4c3e-b886-7c1c19eac8b7" alt=""><figcaption><p>Прежний раздел управления моделями</p></figcaption></figure>

На странице находятся:

* карточка установки Ollama, если среда ещё отсутствует;
* готовность endpoint и модели;
* выбранная MikoPBX модель;
* профиль подключённых компонентов: сводка, голосовые метрики, текстовые и акустические эмоции;
* список установленных локальных моделей;
* состояние моделей голосовой аналитики;
* ход текущей загрузки.

Кнопка **Обновить** повторно проверяет среду, модель и голосовые компоненты. Отдельных кнопок **Проверить среду** и **Проверить модель** в текущем интерфейсе нет.

Для локальных моделей доступны:

| Действие     | Описание                                          |
| ------------ | ------------------------------------------------- |
| **Показать** | Открыть расположение модели или связанных файлов. |
| **Удалить**  | Удалить модель из управляемой локальной среды.    |

Удаление отключено, пока обработчик запущен или модель используется. Если MikoPBX снова выберет удалённую модель, обработчик сможет загрузить её заново.

### Раздел «Диагностика»

**Диагностика** объединяет проверку состояния и локальный журнал.

В верхней части отображаются:

* состояние соединения с MikoPBX;
* токен и UID обработчика;
* локальный endpoint и выбранная модель;
* восстановление после временной ошибки;
* кнопки **Проверить соединение** и **Открыть папку журналов**.

Журнал поддерживает:

* периоды **1 час**, **Сегодня** и **Все**;
* уровни **Все**, **Предупреждения** и **Ошибки**;
* поиск по событиям;
* копирование видимых записей;
* экспорт в файл.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FUGTBV4EcU513Q3Fs6hbp%2FAIWorkerDiagnostics.png?alt=media&amp;token=e1245b07-3f16-4e1b-ad68-992792dd66b6" alt=""><figcaption><p>Раздел "Диагностика" в интерфейсе приложения</p></figcaption></figure>

### Раздел «Настройки»

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2Fjm3N6UFw4t5QnqFnWKSv%2FAIWorkerSettings.png?alt=media&amp;token=44d33c29-07eb-4872-bf1e-e2c75bb80229" alt=""><figcaption><p>Настройки приложения</p></figcaption></figure>

Настройки разделены на три группы.

#### Подключение к MikoPBX

Содержит адрес станции, токен в Keychain, имя, UID и проверку соединения.

Необходимые поля:

| Поле                  | Описание                                                             |
| --------------------- | -------------------------------------------------------------------- |
| **Адрес MikoPBX**     | Полный адрес с `http://` или `https://`.                             |
| **Токен обработчика** | Ключ, созданный в ИИ Супервайзере → **Настройки** → **Обработчики**. |
| **Имя обработчика**   | Понятное имя этого Mac в MikoPBX.                                    |
| **UID обработчика**   | Стабильный технический идентификатор.                                |

Нажмите **Проверить соединение**. Приложение сначала запрашивает `GET /worker-api-contract`, проверяет ModuleAISupervisor, версию API и необходимые возможности, затем использует токен для регистрации.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FJU0p6ExZ4vlPeGizjPnC%2FAIWorkerSettings-MikoPBXConnection.png?alt=media&amp;token=bb44fa4e-d08e-4d32-a57c-ccfe6d059325" alt=""><figcaption><p>Раздел "Подключение к MikoPBX" в настройках приложения</p></figcaption></figure>

#### Основные

| Настройка                           | Назначение                                                           |
| ----------------------------------- | -------------------------------------------------------------------- |
| **Язык приложения**                 | Язык интерфейса. После изменения требуется перезапуск.               |
| **Запускать вместе с macOS**        | Открывать приложение после входа пользователя.                       |
| **Поддерживать работу обработчика** | Автоматически возобновлять работу после восстановления сети или PBX. |
| **Проверка TLS**                    | Проверять HTTPS-сертификат MikoPBX.                                  |
| **Файл CA**                         | Собственный PEM/CRT/CER для частного сертификата.                    |
| **Временные файлы**                 | Каталог для временных записей и промежуточных данных.                |

#### Анализ

| Настройка                       | Назначение                                                                                |
| ------------------------------- | ----------------------------------------------------------------------------------------- |
| **Профиль анализа**             | Открывает раздел **Модели**; активные компоненты приходят из задания MikoPBX.             |
| **OpenAI-совместимый endpoint** | Локальный адрес для структурированного анализа, по умолчанию `http://127.0.0.1:11434/v1`. |
| **Профиль модели эмоций**       | Модель для текстового анализа эмоций.                                                     |
| **Максимум фрагментов**         | Ограничение числа фрагментов для анализа эмоций.                                          |
| **Минимальная длина звонка**    | Более короткие звонки пропускают необязательное обогащение эмоций.                        |

Профиль основной модели, размер контекста и состав анализа задаются в MikoPBX и передаются в каждом задании.


---

# 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/miko-ai-worker.md?ask=<question>&goal=<endgoal>
```

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