Настройка пользовательского поставщика omp

Добавьте TokenHub в omp models.yml и выберите совместимую модель для безопасной первой задачи кодирования.

Что такое ОМП (О, мой Пи)?

omp, также известный как Oh My Pi, представляет собой агент кодирования терминала со встроенными и настраиваемыми поставщиками моделей.

В этом руководстве omp объявляется поставщик, совместимый с TokenHub OpenAI, в файле models.yml. Ключ API разрешается из переменной среды, а контекст модели и выходные значения должны соответствовать выбранной модели. Файл models.yml управляет транспортом поставщика, учетными данными среды, идентификатором модели, контекстным окном и максимальным выходом. Отступы YAML или ограничения копирования могут препятствовать загрузке или создавать недействительные запросы, поэтому проверьте провайдера с помощью моделей OMP и протестируйте небольшую задачу только для чтения, прежде чем использовать его в активной работе.

omp объединяет связанный каталог ~/.omp/agent/models.yml, обнаружение во время выполнения и модели, зарегистрированные в расширениях, в один реестр. TokenHub — это пользовательский поставщик models.yml, выбранный как tokenhub/<model-id>.

Шаг 1. Установите учетные данные, которые может разрешить omp.

export TOKENHUB_API_KEY="sk-..."

apiKey разрешается либо как имя переменной среды, либо как буквальное значение. Если TOKENHUB_API_KEY существует, omp использует его значение; в противном случае он отправляет этот текст в качестве ключа. Подтвердите, что переменная существует после ее настройки.

Шаг 2. Отредактируйте ~/.omp/agent/models.yml.

providers:
  tokenhub:
    baseUrl: __API_BASE_URL__/v1
    api: openai-completions
    apiKey: TOKENHUB_API_KEY
    authHeader: true
    models:
      - id: YOUR_TOKENHUB_MODEL_ID
        name: TokenHub / YOUR_TOKENHUB_MODEL_ID
        contextWindow: 128000
        maxTokens: 8192

authHeader: true вводит Authorization: Bearer <key> при каждом запросе. Замените contextWindow и maxTokens значениями для этой конкретной модели TokenHub.

Шаг 3: проверьте, что провайдер загружен и доступен

omp models
omp models find YOUR_TOKENHUB_MODEL_ID

Модель может войти в реестр omp, не становясь доступной для выбора. Официальное правило доступности заключается в том, что его поставщик отсутствует в действующем списке disabledProviders и либо не имеет ключа, либо имеет разрешаемые учетные данные. Действительный ключ не может восстановить поставщика, пока tokenhub остается отключенным.

Устраните конфликты учетных данных в порядке приоритета omp.

Для нескольких учетных данных у одного поставщика omp проверяет время выполнения --api-key, models.yml apiKey, локальный ключ API хранилища аутентификации, OAuth, переменную среды поставщика и, наконец, резервный вариант пользовательского поставщика. Закрепление ключа TokenHub в models.yml имеет приоритет над устаревшим OAuth, что подходит для пользовательской базы URL.

Для первого теста выберите tokenhub/YOUR_TOKENHUB_MODEL_ID, запустите задачу только для чтения и проверьте журналы TokenHub. Если провайдер отсутствует, проверьте YAML и disabledProviders. Если он присутствует, но его нельзя выбрать, проверьте разрешение клавиши. Для ошибки 401 проверьте переменную и authHeader; для 400 проверьте возможности и ограничения токенов.

Официальная ссылка

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы о провайдере omp (Oh My Pi)

Что должен содержать apiKey в файле models.yml?

Используйте TOKENHUB_API_KEY. Если эта переменная среды существует, omp разрешает ее значение как ключ поставщика.

Почему мой пользовательский поставщик недоступен?

Проверьте синтаксис файла models.yml, убедитесь, что поставщик не находится в отключенных провайдерах, и убедитесь, что переменная ключа API доступна для omp.

Могу ли я скопировать значения контекста из другой модели?

Нет. Объявите фактические contextWindow и maxTokens для выбранной вами модели TokenHub.

Являются ли omp и Oh My Pi одним и тем же инструментом?

Да. На этой странице описан агент кодирования терминала Oh My Pi и конфигурация его поставщика ~/.omp/agent/models.yml.

Как проверить, что OMP использует TokenHub?

Запустите модели OMP, выберите tokenhub/<идентификатор модели>, выполните задачу, доступную только для чтения, и подтвердите точную модель в журналах TokenHub.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。