DeepSeek Harness gebruiken met CometAPI

Gebruik deze handleiding om DeepSeek Harness met CometAPI uit te voeren. DeepSeek Harness laadt aangepaste modelproviders uit $DSH_HOME/settings.yaml, met als standaardwaarde ~/.dsh/settings.yaml. De configuraties op deze pagina zijn geverifieerd met @deepseek-ai/dsh@0.1.0-rc.8. Elke route voltooide een streaming-tekstbeurt en een tool-loop voor het lezen van bestanden met één representatief model. Dit betekent niet dat elk CometAPI-model elke API-indeling accepteert.

DeepSeek Harness bevindt zich in Developer Preview en kan incompatibele wijzigingen introduceren. Zet de geteste pakketversie vast wanneer je deze handleiding volgt en bekijk de upstream-releaseopmerkingen voordat je upgradet.

Officiële referenties:

Vereisten

Node.js en npm
Een CometAPI-account met een actieve API-sleutel van het dashboard
Een model-ID van de CometAPI Models-pagina voor elke API-indeling die je wilt gebruiken

De providerroutes begrijpen

De waarde api selecteert de wireformat. baseURL stopt vóór het bewerkingspad dat Harness toevoegt.

Provider-ID	`api` waarde	`baseURL`	Aanvraagpad
`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`

Vervang elke waarde your-model-id onafhankelijk. Kies een model dat de API-indeling van de bijbehorende providervermelding accepteert.

De providers configureren

Bevestig de geteste Harness-versie

Bevestig de vastgezette pakketversie voordat u Harness configureert:

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

De opdracht moet 0.1.0-rc.8 afdrukken.

Stel uw CometAPI API-sleutel in

Sla uw sleutel op in COMETAPI_KEY voordat u Harness start:

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

Stel de variabele in in elke shellsessie waarmee Harness wordt gestart. Commit geen API-sleutels naar versiebeheer.

Voeg de CometAPI-providers toe

Maak $DSH_HOME/settings.yaml. Als het bestand al een sectie llm-pi-ai bevat, voegt u deze providervermeldingen samen in de bestaande map 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

Het voorbeeld selecteert standaard de Responses-provider. Wijzig agent-default-model.provider en agent-default-model.model om een andere geconfigureerde vermelding te selecteren.Als u liever de Web UI gebruikt, start deze dan nadat u COMETAPI_KEY hebt geëxporteerd en gebruik vervolgens de modelinstellingen om providervermeldingen toe te voegen of te bewerken en het standaardmodel te selecteren:

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

Het standaard lokale adres is http://127.0.0.1:3080. YAML blijft de directe manier om de routenamen en basis-URL’s in deze handleiding overeen te laten komen.

Verifieer een tekstbeurt

Voer vanuit de projectmap die u door Harness wilt laten gebruiken een eenmalige headless-taak uit:

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

Een geslaagde uitvoering geeft COMETAPI_DSH_OK weer. Werk agent-default-model bij en voer de opdracht opnieuw uit om een andere provider te controleren.

Verifieer het gebruik van bestandstools

Maak een tijdelijk sentinelbestand en vraag Harness om het met een bestandstool te lezen:

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."

Bevestig dat het eindantwoord COMETAPI_DSH_TOOL_OK is. Voer Harness alleen uit in een werkruimte waarin u de bestands-, proces- en netwerktoegang van Harness accepteert.

Optionele route

Harness heeft één ingebouwde providerroute met de naam google. De onderstaande configuratie verwijst die route naar CometAPI, waardoor deze het systeemeigen Google-eindpunt van de route vervangt in plaats van een tweede Google-route toe te voegen. Voeg deze vermelding samen in llm-pi-ai.providers en selecteer deze vervolgens in 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

Voeg geen veld api toe aan deze vermelding. De ingebouwde route google behoudt het systeemeigen Google-protocol en verstuurt Streaming-verzoeken naar /v1beta/models/{model}:streamGenerateContent?alt=sse met x-goog-api-key-authenticatie.

Problemen oplossen

Harness meldt dat de API-sleutel ontbreekt

Controleer of COMETAPI_KEY is ingesteld in dezelfde shell die Harness start. Start Harness opnieuw nadat u de omgevingsvariabele hebt gewijzigd.

Harness toont het geconfigureerde model niet

Controleer of $DSH_HOME/settings.yaml geldige YAML is, of de provider onder llm-pi-ai.providers staat en of het model onder de models van die provider wordt vermeld. De standaardwaarde voor DSH_HOME is ~/.dsh.

Chat Completions of Responses gebruikt het verkeerde pad

Gebruik https://api.cometapi.com/v1 als baseURL. Voeg /chat/completions of /responses niet toe; Harness voegt het bewerkingspad toe.

Anthropic Messages retourneert een padfout

Gebruik https://api.cometapi.com zonder /v1 als de Messages-baseURL. De Anthropic-adapter voegt /v1/messages toe.

Google genereert een dubbel v1beta-pad

Gebruik https://api.cometapi.com/v1beta precies zo. Voeg geen modelpad toe en voeg geen veld api toe aan de ingebouwde route google.

Een model werkt bij de ene provider maar niet bij de andere

De beschikbaarheid van modellen en geaccepteerde API-indelingen kunnen verschillen. Kies een model voor elke providervermelding in plaats van aan te nemen dat één model in alle vier indelingen werkt.

De configuratie werkt niet meer na een upgrade

DeepSeek Harness bevindt zich in Developer Preview. Keer terug naar @deepseek-ai/dsh@0.1.0-rc.8 en bekijk vervolgens upstream-wijzigingen voordat u de configuratie aanpast aan een andere versie.

Overzicht

AI-codeeragents

AI-agents

AI-chatclients

Vertaling en taal

Automatiseringsplatforms

Observeerbaarheid en evaluatie

AI-frameworks

DeepSeek Harness gebruiken met CometAPI

Vereisten

De providerroutes begrijpen

De providers configureren

Optionele route

Problemen oplossen

Gerelateerde bronnen

​Vereisten

​De providerroutes begrijpen

​De providers configureren

​Optionele route

​Problemen oplossen

​Gerelateerde bronnen

Vereisten

De providerroutes begrijpen

De providers configureren

Optionele route

Problemen oplossen

Gerelateerde bronnen