Bruk DeepSeek Harness med CometAPI

Bruk denne veiledningen til å kjøre DeepSeek Harness med CometAPI. DeepSeek Harness laster inn egendefinerte modellleverandører fra $DSH_HOME/settings.yaml, som som standard er ~/.dsh/settings.yaml. Konfigurasjonene på denne siden ble verifisert med @deepseek-ai/dsh@0.1.0-rc.8. Hver rute fullførte en Streaming-tekstutveksling og en verktøysløyfe for fillesing med én representativ modell. Dette omfanget betyr ikke at alle CometAPI-modeller godtar alle API-formater.

DeepSeek Harness er i utviklerforhåndsvisning og kan introdusere uforenlige endringer. Lås den testede pakkeversjonen når du følger denne veiledningen, og gjennomgå oppstrøms utgivelsesnotater før du oppgraderer.

Offisielle referanser:

Forutsetninger

Node.js og npm
En CometAPI-konto med en aktiv API-nøkkel fra kontrollpanelet
En modell-ID fra CometAPI Models-siden for hvert API-format du planlegger å bruke

Forstå leverandørrutene

Verdien api velger wire-formatet. baseURL stopper før operasjonsstien som Harness legger til.

Leverandør-ID	`api` verdi	`baseURL`	Forespørselssti
`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`

Erstatt hver your-model-id-verdi uavhengig av de andre. Velg en modell som godtar API-formatet i leverandøroppføringen.

Konfigurer leverandørene

Bekreft den testede Harness-versjonen

Bekreft den låste pakkeversjonen før du konfigurerer Harness:

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

Kommandoen skal skrive ut 0.1.0-rc.8.

Angi CometAPI API-nøkkelen

Lagre nøkkelen i COMETAPI_KEY før du starter Harness:

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

Angi variabelen i hver shell-økt som starter Harness. Ikke legg API-nøkler inn i versjonskontroll.

Legg til CometAPI-leverandørene

Opprett $DSH_HOME/settings.yaml. Hvis filen allerede har en llm-pi-ai-seksjon, fletter du disse leverandøroppføringene inn i det eksisterende providers-kartet:

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

Eksemplet velger Responses-leverandøren som standard. Endre agent-default-model.provider og agent-default-model.model for å velge en annen konfigurert oppføring.Hvis du foretrekker webgrensesnittet, starter du det etter å ha eksportert COMETAPI_KEY, og bruker deretter modellinnstillingene til å legge til eller redigere leverandøroppføringer og velge standardmodellen:

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

Den lokale standardadressen er http://127.0.0.1:3080. YAML er fortsatt den direkte metoden for å samsvare med rutenavnene og basis-URL-ene i denne veiledningen.

Kontroller en tekstutveksling

Kjør en enkeltstående oppgave uten brukergrensesnitt fra prosjektkatalogen du vil at Harness skal bruke:

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

En vellykket kjøring skriver ut COMETAPI_DSH_OK. For å kontrollere en annen leverandør oppdaterer du agent-default-model og kjører kommandoen på nytt.

Kontroller bruk av filverktøy

Opprett en midlertidig kontrollfil, og be deretter Harness lese den med et filverktøy:

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

Bekreft at det endelige svaret er COMETAPI_DSH_TOOL_OK. Kjør Harness kun i et arbeidsområde der du godtar Harness’ tilgang til filer, prosesser og nettverk.

Valgfri rute

Harness har én innebygd leverandørrute med navnet google. Konfigurasjonen nedenfor peker denne ruten mot CometAPI, slik at den erstatter rutens opprinnelige Google-endepunkt i stedet for å legge til en ny Google-rute. Flett denne oppføringen inn i llm-pi-ai.providers, og velg den deretter i 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

Ikke legg til et api-felt i denne oppføringen. Den innebygde google-ruten beholder den opprinnelige Google-protokollen og sender Streaming-forespørsler til /v1beta/models/{model}:streamGenerateContent?alt=sse med x-goog-api-key-autentisering.

Feilsøking

Harness rapporterer at API-nøkkelen mangler

Bekreft at COMETAPI_KEY er angitt i det samme skallet som starter Harness. Start Harness på nytt etter at du har endret miljøvariabelen.

Harness viser ikke den konfigurerte modellen

Bekreft at $DSH_HOME/settings.yaml er gyldig YAML, at leverandøren er under llm-pi-ai.providers, og at modellen er oppført under den leverandørens models. Standardverdien for DSH_HOME er ~/.dsh.

Chat Completions eller Responses bruker feil bane

Bruk https://api.cometapi.com/v1 som baseURL. Ikke legg til /chat/completions eller /responses; Harness legger til operasjonsbanen.

Anthropic Messages returnerer en banefeil

Bruk https://api.cometapi.com uten /v1 som Messages-baseURL. Anthropic-adapteren legger til /v1/messages.

Google genererer en duplisert v1beta-bane

Bruk https://api.cometapi.com/v1beta nøyaktig som angitt. Ikke legg til en modellbane, og ikke legg til et api-felt i den innebygde google-ruten.

En modell fungerer hos én leverandør, men ikke hos en annen

Modelltilgjengelighet og godtatte API-formater kan variere. Velg en modell for hver leverandøroppføring i stedet for å anta at én modell fungerer på tvers av alle fire formatene.

Konfigurasjonen slutter å fungere etter en oppgradering

DeepSeek Harness er i Developer Preview. Gå tilbake til @deepseek-ai/dsh@0.1.0-rc.8, og gjennomgå deretter endringer oppstrøms før du tilpasser konfigurasjonen til en annen versjon.

Oversikt

AI-kodeagenter

AI-agenter

AI-chatklienter

Oversettelse og språk

Automatiseringsplattformer

Observerbarhet og evaluering

AI-rammeverk

Forutsetninger

Forstå leverandørrutene

Konfigurer leverandørene

Valgfri rute

Feilsøking

Relaterte ressurser

​Forutsetninger

​Forstå leverandørrutene

​Konfigurer leverandørene

​Valgfri rute

​Feilsøking

​Relaterte ressurser

Forutsetninger

Forstå leverandørrutene

Konfigurer leverandørene

Valgfri rute

Feilsøking

Relaterte ressurser