# Руководство по настройке WorkBuddy

> Добавьте пользовательскую модель в Tencent WorkBuddy, указав OpenAI-совместимый интерфейс LLMoxy, и выполняйте офисные и кодинговые задачи на моделях шлюза.

Сайт: [https://www.workbuddy.cn (нажмите для перехода к загрузке)](https://www.workbuddy.cn)

WorkBuddy — настольный агент от Tencent Cloud: вы ставите задачу одной фразой, а он разбивает её на шаги, читает и записывает локальные файлы и выдаёт документ / таблицу / презентацию. После подключения LLMoxy используются модели шлюза, а собственные баллы WorkBuddy не расходуются.

Прежде чем начать, подготовьте [токен LLMoxy](https://ru.llmoxy.com/docs/get-started/get-token); рекомендуется группа **auto**.

## Установка и вход

1. Скачайте с официального сайта установочный пакет для своей системы (Windows 10+ или macOS 12+; для Apple Silicon выберите ARM64).
2. После установки запустите приложение и войдите, отсканировав QR-код в WeChat (также поддерживаются номер телефона, QQ и аккаунт Tencent Cloud).
3. Следуйте подсказкам и выдайте доступ к рабочим каталогам. Разрешайте только нужные папки — рабочий стол, документы, загрузки, — не открывайте доступ ко всему диску.

![Скачать WorkBuddy](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/download.png)

![Вход в WorkBuddy](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/login.png)

![Разрешение доступа к папкам](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/folder-auth.png)

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

1. Нажмите аватар в левом нижнем углу и откройте **Настройки** (`设置`).
2. Слева выберите **Модели** (`模型`), в правом верхнем углу нажмите **+ Добавить модель** (`添加模型`).
3. В выпадающем списке поставщиков найдите пункт «Другие» и выберите **Пользовательский / Custom**.
4. Заполните поля ниже, сохраните и **включите** модель в списке (поставьте отметку).

| Поле | Значение |
| --- | --- |
| Поставщик | Пользовательский / Custom |
| Адрес интерфейса | `https://llmoxy.com/v1` |
| API Key | токен, скопированный из консоли LLMoxy |
| Название модели | точный ID с площадки моделей, например `grok-4.7`, `claude-opus-5-5` |

![Открыть настройки](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/model-settings.png)

![Добавить пользовательскую модель](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/custom-model.png)

> **💡 Подсказка**
> В адресе интерфейса указывайте путь только до `/v1`, WorkBuddy сам добавит `/chat/completions`. Если запрос не проходит, включите в расширенных настройках **Пользовательский протокол** (`自定义协议`) и измените адрес на `https://llmoxy.com/v1/chat/completions`.

## Приступаем к работе

Главный экран состоит из трёх частей: слева список задач, в центре диалог, справа результаты.

1. Нажмите **Новая задача** и выберите рабочее пространство.
2. Сформулируйте требование сразу полностью: **цель + входные файлы + формат результата + ограничения**.
3. Выберите режим под задачу и отправьте.

| Режим | Что делает | Когда использовать |
| --- | --- | --- |
| Ask (спросить) | Только смотрит, ничего не меняет | Поиск информации, анализ документов |
| Plan (обдумать) | Сначала предлагает план, файлы меняет после подтверждения | Сложные или рискованные задачи |
| Craft (сделать) | Сразу выполняет и создаёт файлы | Цель уже ясна |

![Главный экран](https://ru.llmoxy.com/docs-assets/migrated/tutorial-workbuddy/layout.png)

Пример запроса:

```
Прочитай файл «Данные продаж.xlsx» на рабочем столе, суммируй продажи по регионам за каждый месяц, построй столбчатую диаграмму и выведи новый Excel-файл.
```

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

## Частые вопросы

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

**Интерфейс возвращает 404**
Убедитесь, что адрес — `https://llmoxy.com/v1`: не пропускайте `/v1` и не указывайте один лишь домен. Адрес с `/v1/chat/completions` из примера указывается целиком только при включённом «Пользовательском протоколе».

**Неверное название модели**
Скопируйте полный ID из списка моделей [консоли LLMoxy](https://llmoxy.com/); регистр символов должен совпадать.

**Видит ли он все файлы на моём компьютере?**
Нет. Он имеет доступ только к папкам, которые вы разрешили, а системные конфиденциальные каталоги блокируются.

Это markdown-версия страницы https://ru.llmoxy.com/docs/code-tutorials/workbuddy.
