Как настроить свою модель в WorkBuddy

В этом руководстве используется текущий интерфейс пользовательской модели WorkBuddy. Перед открытием WorkBuddy подготовьте ключ OmniaKey API и один точный идентификатор модели.

Форма, сохраненные сведения о модели и средство выбора модели были проверены в приложении macOS, работающем под управлением WorkBuddy v5.3.14. Официальные инструкции Tencent Cloud требуют для этой функции не ниже v4.22.15.

Прежде чем приступить к работе, подготовьте два предмета.

Ключ OmniaKey API

Войдите в OmniaKey и откройте страницу API Keys:

1. Выберите Создать ключ.
2. Назовите его WorkBuddy, затем установите подходящий лимит и срок действия.
3. Создайте его и сразу скопируйте новый ключ.

Держите диалоговое окно ключа открытым, пока вы не вставите учетные данные в WorkBuddy. Не помещайте ключ в скриншоты, сообщения чата или общедоступные файлы.

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

Точный идентификатор модели

Откройте каталог моделей OmniaKey, выберите доступную в данный момент модель и скопируйте идентификатор модели, показанный на странице. Для первого теста используйте:

deepseek-v4-flash

Идентификатор должен точно совпадать. Не вводите отображаемое имя DeepSeek V4 Flash, не удаляйте дефисы и не придумывайте более короткий псевдоним.

Шаг 1: откройте «Добавить модель».

Запустите WorkBuddy и откройте:

System Settings → Models → + Add model

На странице «Модели» выберите + Добавить модель в правом верхнем углу.

Вы также можете ввести снизу новую задачу:

Model picker → + Configure custom model

Если ни одна из записей недоступна, обновите WorkBuddy до версии v4.22.15 или более поздней. Текущие инструкции Tencent Cloud требуют как минимум эту версию интерфейса.

Шаг 2: выберите «Пользовательский» и заполните четыре поля.

Заполните форму сверху вниз.

1. Выберите индивидуального поставщика

Откройте меню «Провайдер» и выберите:

Custom

В v5.3.14 он отображается в группе Другие. Не выбирайте встроенный OpenAI, план Tencent Cloud Token или другого поставщика, поскольку эти профили не используют адрес интерфейса OmniaKey.

2. Введите адрес через /v1

В поле Адрес интерфейса или Base URL введите точно:

https://api.omniakey.com/v1

3. Вставьте ключ API.

Вставьте ключ, скопированный из OmniaKey, в API Key. Не добавляйте кавычки, пробелы или слово Bearer; введите только ключевое значение.

4. Введите название модели

В разделе Название модели или Model ID введите точный идентификатор каталога:

deepseek-v4-flash

Основная форма теперь должна выглядеть следующим образом:

Provider: Custom
Interface address: https://api.omniakey.com/v1
API Key: [your OmniaKey API key]
Model name: deepseek-v4-flash

Для первой проверки соединения оставьте для остальных полей значения по умолчанию и убедитесь, что Пользовательский протокол отключен. В v5.3.14 новая форма начинается с включения Tool calling, отключения ввода изображения, отключения режима рассуждения, отключения пользовательского протокола и ограничений ввода и вывода по умолчанию для поставщика. Ниже показан проверенный пресет deepseek-v4-flash.

Шаг 3: сохраните, выберите модель и протестируйте ее.

Выберите Сохранить и вернитесь к новой задаче. Откройте средство выбора модели внизу, найдите раздел пользовательской модели и выберите deepseek-v4-flash.

Отправьте одно короткое тестовое сообщение:

Reply with exactly: Connection successful

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

1. WorkBuddy сохранил пользовательского поставщика.
2. Base URL верен.
3. Ключ API принят и имеет доступный кредит.
4. Ключ может получить доступ к выбранному идентификатору модели.

Наконец, откройте OmniaKey Usage и убедитесь, что вызов отображается с ожидаемой моделью. Это замыкает цикл проверки от WorkBuddy до OmniaKey.

Если сохраненная модель не появляется сразу, закройте и снова откройте средство выбора. Полностью закройте и перезапустите WorkBuddy, если он по-прежнему не появляется.

Рекомендуемые расширенные настройки для первого теста

Не меняйте некоторые элементы управления возможностями, пока не заработает базовый чат. Новая кастомная модель в WorkBuddy v5.3.14 начинается с:

Используйте эти значения по умолчанию, чтобы сначала проверить URL-адрес, ключ и название модели. Затем настройте возможности модели.

Проверенная предустановка deepseek-v4-flash

Сохраненная модель и успешные локальные ответы использовали следующую конфигурацию:

WorkBuddy показывает только рассуждение, разрешает отключение рассуждения и контроль усилий после включения режима рассуждения. Оставьте настройку «Авто» для первого теста.

Когда включать вызов инструмента

Включите Tool calling, когда WorkBuddy необходимо читать файлы, использовать соединители или выполнять задачи агента. Модель также должна поддерживать структурированные вызовы инструментов. deepseek-v4-flash в настоящее время имеет поддержку инструментов в каталоге OmniaKey, поэтому включите ее после работы основного чата и начните с задачи, доступной только для чтения. Его можно оставить выключенным для проверки чата только с подключением.

Когда включать ввод изображений

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

Когда включать режим рассуждения

Включите его, если в каталоге или документации модели явно указаны рассуждения, размышления или аналогичный режим. Сохраните автоматическое усилие и разрешите отключение рассуждений. Не добавляйте неподдерживаемые значения усилий и не делайте режим «только рассуждение» режимом по умолчанию для обычных задач.

Добавляем еще одну модель

Не перезаписывайте запись рабочей модели. Снова откройте Добавить модель, сохраните тот же URL-адрес OmniaKey и ключ API, замените только точный идентификатор модели и сохраните ее как другую пользовательскую модель.

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

Устранение неполадок по симптомам

Настройка пользовательской модели отсутствует

Сначала проверьте версию WorkBuddy. Обновите v4.22.15 или более позднюю версию, затем просмотрите средство выбора модели новой задачи или выберите Настройки системы → Модели.

HTTP 401, Неавторизованный или неверный ключ API

Скопируйте ключ OmniaKey еще раз. Проверьте наличие пробелов и убедитесь, что вы не вставили вместе с ними Bearer. Убедитесь, что ключ активен и срок его действия еще не истек, а также что баланс счета и лимит ключа можно использовать.

Изменение идентификатора модели не устраняет проблему 401; аутентификация не удалась до того, как выбор модели имел значение.

HTTP 404 или конечная точка не найдена

Адрес должен быть именно:

https://api.omniakey.com/v1

Не используйте пустой домен, не дублируйте /v1 и не добавляйте /chat/completions. Также убедитесь, что параметр Пользовательский протокол отключен.

Модель не найдена или UNKNOWN_MODEL

Скопируйте идентификатор еще раз из каталога активных моделей. Отображаемое имя, предполагаемый псевдоним или устаревший идентификатор не являются действительным идентификатором текущей модели.

Чат работает, но инструменты не работают

Подключение базовой модели уже работает. Проверьте переключатель Tool calling WorkBuddy и возможности инструмента модели. Повторный ввод ключа или URL-адреса API не добавит поддержку инструмента.

Не удалось ввести изображение

Оба условия должны быть истинными: модель поддерживает изображения и в WorkBuddy включен элемент управления вводом изображений.

Модель отсутствует после сохранения.

Подтвердите, что вы выбрали Сохранить, затем снова откройте окно выбора модели. При необходимости перезапустите WorkBuddy. Если сама запись конфигурации недоступна, проверьте версию клиента еще раз.

Часто задаваемые вопросы

Какой URL-адрес OmniaKey должен использовать WorkBuddy?

Используйте только https://api.omniakey.com/v1. Это Base URL; WorkBuddy добавляет путь операции.

Нужен ли мне файл models.json?

Нет. Это руководство соответствует текущему интерфейсу Настройка пользовательской модели. В старых инструкциях локального файла конфигурации описан другой путь установки.

Могу ли я настроить GPT, Claude, Gemini или другую модель?

Да, если модель в настоящее время указана в OmniaKey и поддерживает маршрут, совместимый с OpenAI. Сохраните тот же URL-адрес и используйте точный идентификатор модели из каталога.

Настроен ли MCP в этой форме?

Нет. Эта форма настраивает модель API. MCP и разъемы — это отдельные настройки WorkBuddy. Прежде чем добавлять эти инструменты, определите базовую реакцию модели.

Проверенные ссылки

• Tencent Cloud: настройка и использование WorkBuddy
• OmniaKey OpenAI-совместимый справочник API
• OmniaKey каталог моделей в реальном времени