Використання DeepSeek Harness із CometAPI

Скористайтеся цим посібником, щоб запустити DeepSeek Harness із CometAPI. DeepSeek Harness завантажує користувацьких постачальників моделей із $DSH_HOME/settings.yaml, значенням за замовчуванням для якого є ~/.dsh/settings.yaml. Конфігурації на цій сторінці перевірено з @deepseek-ai/dsh@0.1.0-rc.8. Кожен маршрут виконав потокову текстову взаємодію та цикл інструмента читання файлів з однією репрезентативною моделлю. Це не означає, що кожна модель CometAPI підтримує кожен формат API.

DeepSeek Harness перебуває в попередньому перегляді для розробників і може вносити несумісні зміни. Використовуйте перевірену версію пакета, дотримуючись цього посібника, і переглядайте примітки до випусків першоджерела перед оновленням.

Офіційні посилання:

Передумови

Node.js і npm
Обліковий запис CometAPI з активним ключем API з панелі керування
Ідентифікатор моделі з сторінки моделей CometAPI для кожного формату API, який ви плануєте використовувати

Огляд маршрутів постачальників

Значення api визначає формат обміну даними. baseURL не включає шлях операції, який додає Harness.

Ідентифікатор постачальника	`api` значення	`baseURL`	Шлях запиту
`cometapi-chat`	`openai-completions`	`https://api.cometapi.com/v1`	`/v1/chat/completions`
`cometapi-responses`	`openai-responses`	`https://api.cometapi.com/v1`	`/v1/responses`
`cometapi-messages`	`anthropic-messages`	`https://api.cometapi.com`	`/v1/messages`

Замініть кожне значення your-model-id окремо. Виберіть модель, яка підтримує формат API запису свого постачальника.

Налаштуйте провайдерів

Підтвердьте протестовану версію Harness

Перш ніж налаштовувати Harness, підтвердьте закріплену версію пакета:

npx @deepseek-ai/dsh@0.1.0-rc.8 --version

Команда має вивести 0.1.0-rc.8.

Установіть свій ключ API CometAPI

Перед запуском Harness збережіть свій ключ у COMETAPI_KEY:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Установлюйте цю змінну в кожному сеансі оболонки, з якого запускається Harness. Не додавайте ключі API до системи контролю версій.

Додайте провайдерів CometAPI

Створіть $DSH_HOME/settings.yaml. Якщо файл уже містить розділ llm-pi-ai, об’єднайте ці записи провайдерів із його наявною мапою providers:

llm-pi-ai:
  providers:
    cometapi-chat:
      displayName: CometAPI Chat Completions
      apiKeyEnv: COMETAPI_KEY
      api: openai-completions
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-responses:
      displayName: CometAPI Responses
      apiKeyEnv: COMETAPI_KEY
      api: openai-responses
      baseURL: https://api.cometapi.com/v1
      models:
        - id: your-model-id
    cometapi-messages:
      displayName: CometAPI Anthropic Messages
      apiKeyEnv: COMETAPI_KEY
      api: anthropic-messages
      baseURL: https://api.cometapi.com
      models:
        - id: your-model-id

agent-default-model:
  provider: cometapi-responses
  model: your-model-id

У прикладі за замовчуванням вибрано провайдера Responses. Змініть agent-default-model.provider і agent-default-model.model, щоб вибрати інший налаштований запис.Якщо ви надаєте перевагу Web UI, запустіть його після експортування COMETAPI_KEY, а потім використайте налаштування моделі, щоб додати або змінити записи провайдерів і вибрати модель за замовчуванням:

npx @deepseek-ai/dsh@0.1.0-rc.8 web

Локальна адреса за замовчуванням — http://127.0.0.1:3080. YAML залишається прямим способом узгодження назв маршрутів і базових URL-адрес у цьому посібнику.

Перевірте текстовий запит

Запустіть одноразове завдання без інтерфейсу з каталогу проєкту, який має використовувати Harness:

npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Reply exactly with: COMETAPI_DSH_OK"

У разі успішного виконання буде виведено COMETAPI_DSH_OK. Щоб перевірити іншого провайдера, оновіть agent-default-model і запустіть команду ще раз.

Перевірте використання інструмента для файлів

Створіть тимчасовий файл-маркер, а потім попросіть Harness прочитати його за допомогою інструмента для файлів:

printf 'COMETAPI_DSH_TOOL_OK\n' > /tmp/cometapi-dsh-sentinel.txt
npx @deepseek-ai/dsh@0.1.0-rc.8 \
  --profile headless \
  "Read /tmp/cometapi-dsh-sentinel.txt with a file tool, then reply with only its contents."

Переконайтеся, що остаточна відповідь — COMETAPI_DSH_TOOL_OK. Запускайте Harness лише в робочому просторі, де ви погоджуєтеся на його доступ до файлів, процесів і мережі.

Необов’язковий маршрут

Harness має один вбудований маршрут провайдера з назвою google. Наведена нижче конфігурація спрямовує цей маршрут до CometAPI, тому він замінює власну кінцеву точку Google цього маршруту, а не додає другий маршрут Google. Об’єднайте цей запис із llm-pi-ai.providers, а потім виберіть його в agent-default-model:

llm-pi-ai:
  providers:
    google:
      displayName: CometAPI Google generateContent
      apiKeyEnv: COMETAPI_KEY
      baseURL: https://api.cometapi.com/v1beta
      models:
        - id: your-model-id

agent-default-model:
  provider: google
  model: your-model-id

Не додавайте поле api до цього запису. Вбудований маршрут google зберігає власний протокол Google і надсилає Streaming-запити до /v1beta/models/{model}:streamGenerateContent?alt=sse з автентифікацією x-goog-api-key.

Усунення несправностей

Harness повідомляє про відсутність API-ключа

Переконайтеся, що COMETAPI_KEY задано в тій самій оболонці, з якої запускається Harness. Після зміни змінної середовища перезапустіть Harness.

Harness не відображає налаштовану модель

Переконайтеся, що $DSH_HOME/settings.yaml є дійсним YAML, постачальник указано в розділі llm-pi-ai.providers, а модель перелічено в models цього постачальника. Типове значення DSH_HOME — ~/.dsh.

Chat Completions або Responses використовує неправильний шлях

Використовуйте https://api.cometapi.com/v1 як baseURL. Не додавайте /chat/completions або /responses; Harness додає шлях операції.

Anthropic Messages повертає помилку шляху

Використовуйте https://api.cometapi.com без /v1 як baseURL для Messages. Адаптер Anthropic додає /v1/messages.

Google генерує дубльований шлях v1beta

Використовуйте саме https://api.cometapi.com/v1beta. Не додавайте шлях моделі та не додавайте поле api до вбудованого маршруту google.

Модель працює з одним постачальником, але не з іншим

Доступність моделей і підтримувані формати API можуть відрізнятися. Вибирайте модель для кожного запису постачальника, а не припускайте, що одна модель працює в усіх чотирьох форматах.

Конфігурація перестає працювати після оновлення

DeepSeek Harness перебуває на етапі попереднього перегляду для розробників. Поверніться до @deepseek-ai/dsh@0.1.0-rc.8, а потім перегляньте зміни у вихідному проєкті, перш ніж адаптувати конфігурацію до іншої версії.

Огляд

AI агенти для програмування

AI-агенти

AI чат-клієнти

Переклад і мова

Платформи автоматизації

Спостережуваність та оцінювання

AI фреймворки

Використання DeepSeek Harness із CometAPI

Передумови

Огляд маршрутів постачальників

Налаштуйте провайдерів

Необов’язковий маршрут

Усунення несправностей

Пов’язані ресурси

​Передумови

​Огляд маршрутів постачальників

​Налаштуйте провайдерів

​Необов’язковий маршрут

​Усунення несправностей

​Пов’язані ресурси

Передумови

Огляд маршрутів постачальників

Налаштуйте провайдерів

Необов’язковий маршрут

Усунення несправностей

Пов’язані ресурси