Настройка API DeepSeek Harness

DeepSeek Harness (dsh) может добавить TokenHub в качестве пользовательского поставщика на своей странице «Модели». Каждый провайдер должен объявить один протокол, фактически предоставляемый шлюзом. Для TokenHub OpenAI Chat Completions используйте openai-completions с https://us-api.tokenhub.com/v1.

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

Когда эта интеграция подходит

DeepSeek Harness предназначен для рабочих процессов разработки, объединяющих модель, инструменты и рабочую область в агенте. В нем сохраняются поставщики, модели и настройки сеанса. Прежде чем создавать его, выберите стабильный идентификатор поставщика, чтобы впоследствии не приходилось переносить ссылки на модель по умолчанию и сеансы.

Запустить DeepSeek Harness

Используйте официальную команду, чтобы запустить локальный веб-интерфейс:

npx @deepseek-ai/dsh web

При этом запускается локальный пользовательский интерфейс и предпринимается попытка открыть его в браузере. При запуске через SSH или в удаленной среде следуйте инструкциям веб-интерфейса проекта для адреса доступа. Прежде чем настраивать поставщика, убедитесь, что пользовательский интерфейс доступен.

Подготовьте учетные данные и модель TokenHub.

Создайте ключ API на панели управления TokenHub и скопируйте точный идентификатор модели из каталога моделей. Никогда не сохраняйте ключ в репозитории и не делитесь им.

Добавьте пользовательский поставщик TokenHub.

1. Откройте Settings → Models.
2. Выберите Add a custom provider. Не настраивайте TokenHub в качестве одного из встроенных поставщиков.
3. Введите строчные буквы идентификатора поставщика, отображаемое имя, базовый протокол URL, протокол API и ключ API.
4. Добавьте хотя бы один точный идентификатор модели TokenHub в список моделей и сохраните.
5. Вернитесь к средству выбора модели, выберите сохраненного поставщика и модель и создайте новый сеанс для проверки.

Один провайдер может использовать только один протокол. Если шлюз предоставляет OpenAI Chat Completions, Responses и Anthropic Messages, создайте отдельного поставщика для каждого протокола, а не смешивайте их.

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

Добавьте модель вручную, если обнаружение не удалось

Model catalog может использовать Fetch available models для получения списка моделей. Это зависит от совместимого ответа модели списка и является удобством, а не обязательным условием.

Если выборка не удалась или возвращает пустой список:

1. Сохраните правильный базовый URL, протокол и ключ API.
2. Введите полный идентификатор модели из TokenHub вручную.
3. Сохраните провайдера и отправьте простой запрос из нового сеанса.
4. Подтвердите модель, статус и использование в журналах запросов TokenHub.

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

Расширенная настройка в settings.yaml

На странице «Модели» представлены поля маршрутизации: ключ API, отображаемое имя, базовый URL, протокол и идентификатор модели. Настройте ввод изображения, обработку рассуждений, переопределения совместимости, заголовки запросов, таймауты и политику повторных попыток в $DSH_HOME/settings.yaml.

Например, объявляйте ввод изображения только в том случае, если точная модель его поддерживает:

llm-pi-ai:
  providers:
    tokenhub:
      apiKeyEnv: TOKENHUB_API_KEY
      api: openai-completions
      baseURL: __API_BASE_URL__/v1
      models:
        - id: YOUR_TOKENHUB_MODEL_ID
          input: [text, image]

В официальном руководстве сказано, что адаптер считывает сохраненные изменения settings.yaml при следующем запросе, обычно без перезагрузки. Не добавляйте переопределения, такие как supportsDeveloperRole или maxTokensField, спекулятивно; используйте их только тогда, когда шлюз требует их или отклоняет запрос по умолчанию.

Убедитесь, что запросы достигают TokenHub.

1. Убедитесь, что поставщик и модель сохранены на странице «Модели».
2. Создайте новый сеанс и выберите модель TokenHub.
3. Запустите задачу с низким уровнем риска, например объяснение одного файла или краткое изложение короткого блока кода.
4. Подтвердите точный идентификатор модели, статус ответа и использование в журналах TokenHub.
5. Затем тестируйте инструменты, длинные задачи и ввод изображений по одной возможности за раз.

Существующий сеанс сохраняет запись модели в журнале сеанса. После изменения значения по умолчанию проверьте новый сеанс.

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

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

• Проект DeepSeek Harness
• Руководство поставщика DeepSeek Harness
• Каталог конфигурации DeepSeek Harness