# Мастер настройки

Мастер запускается при первом старте CLI и повторно командой:

```bash
iola master
```

Мастер обновляет только выбранные компоненты и не сбрасывает остальные настройки.

Перед выбором компонентов CLI проверяет окружение и показывает статус каждого пункта: `готово` или `не настроено`.

## Компоненты

### 1. workspace и контекст

Создает рабочую среду текущей папки: `.iola/`, `IOLA.md` и `.iola/context.md`.

Нужно, если агент будет работать с локальными файлами, документами, задачами, артефактами и контекстом проекта.

### 2. policy analyst

Включает профиль разрешений для аналитической работы: открытые данные, отчеты, безопасные локальные операции.

### 3. IOLA локальная модель

Проверяет штатную локальную модель IOLA и готовит ее к работе через доступный runtime.

Если модель уже скачана и доступна, пункт показывается как `готово`.

После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.

### 4. GigaChat API

Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.

Российский провайдер вызывается напрямую, без gateway/proxy.

### 5. OpenAI API

Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.

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

### 6. OpenRouter API

Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.

После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.

### 7. Codex CLI

Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.

### 8. MCP для Codex

Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.

### 9. 7-Zip / архивы

Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.

Нужен для чтения, распаковки, сборки и индексирования архивов.

### 10. Индекс локальных документов

Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:

```bash
iola index folder ./docs
```

### 11. Browser runtime

Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.

### 12. Ollama

Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.

Если runtime уже установлен, пункт показывается как `готово`.

### 13. Yandex Connector

Настраивает единый коннектор пользовательских сервисов Яндекса.

Первый контур:

- Yandex ID;
- Яндекс Диск.

Мастер не спрашивает список сервисов. Он подключает коннектор с максимальным набором OAuth-прав, а активные функции CLI выбираются позже командой `/yandex` в интерактивном CLI или `iola yandex menu` в терминале.

В коннектор также заложены категории для проверки: Почта, Календарь, Контакты, Документы/360 и Телемост. Яндекс Go deeplink работает через Yandex Cloud Connector и геокодер; заказ такси, Маркет и Доставка остаются без оформления заказа и оплаты.

Инструкция: [Yandex Connector](Yandex-Connector).

### 14. Yandex Cloud Connector

Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.

Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.

При запуске CLI печатает пошаговую инструкцию: войти в Яндекс, создать облако/каталог при необходимости, открыть Кабинет разработчика геокодера, создать API key, вернуться в CLI и вставить ключ. Пользователь не остается один на пустой странице консоли.

Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.

Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).

## Повторный запуск

Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.
