DeepSeek Harness mit CometAPI verwenden

Verwenden Sie diesen Leitfaden, um DeepSeek Harness mit CometAPI auszuführen. DeepSeek Harness lädt benutzerdefinierte Modell-Provider aus $DSH_HOME/settings.yaml, wobei standardmäßig ~/.dsh/settings.yaml verwendet wird. Die Konfigurationen auf dieser Seite wurden mit @deepseek-ai/dsh@0.1.0-rc.8 überprüft. Jede Route führte mit einem repräsentativen Modell eine Streaming-Textinteraktion und eine Tool-Schleife zum Lesen von Dateien aus. Dieser Umfang bedeutet nicht, dass jedes CometAPI-Modell jedes API-Format akzeptiert.

DeepSeek Harness befindet sich in der Developer Preview und kann Breaking Changes einführen. Fixieren Sie beim Befolgen dieses Leitfadens die getestete Paketversion und prüfen Sie vor einem Upgrade die Upstream-Release Notes.

Offizielle Referenzen:

Voraussetzungen

Node.js und npm
Ein CometAPI-Konto mit einem aktiven API-Schlüssel aus dem Dashboard
Eine Modell-ID von der CometAPI-Modelle-Seite für jedes API-Format, das Sie verwenden möchten

Die Provider-Routen verstehen

Der Wert api wählt das Wire-Format aus. baseURL endet vor dem Operationspfad, den Harness anhängt.

Provider-ID	`api` Wert	`baseURL`	Anfragepfad
`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`

Ersetzen Sie jeden Wert your-model-id unabhängig. Wählen Sie ein Modell, das das API-Format seines Provider-Eintrags akzeptiert.

Anbieter konfigurieren

Getestete Harness-Version bestätigen

Bestätigen Sie die festgeschriebene Paketversion, bevor Sie Harness konfigurieren:

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

Der Befehl sollte 0.1.0-rc.8 ausgeben.

CometAPI-API-Schlüssel festlegen

Speichern Sie Ihren Schlüssel vor dem Start von Harness in COMETAPI_KEY:

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

Setzen Sie die Variable in jeder Shell-Sitzung, die Harness startet. Übertragen Sie API-Schlüssel nicht in die Versionsverwaltung.

CometAPI-Anbieter hinzufügen

Erstellen Sie $DSH_HOME/settings.yaml. Falls die Datei bereits einen Abschnitt llm-pi-ai enthält, führen Sie diese Anbietereinträge in ihrer bestehenden Map providers zusammen:

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

Das Beispiel wählt standardmäßig den Responses-Anbieter aus. Ändern Sie agent-default-model.provider und agent-default-model.model, um einen anderen konfigurierten Eintrag auszuwählen.Wenn Sie die Web UI bevorzugen, starten Sie sie nach dem Exportieren von COMETAPI_KEY und verwenden Sie dann die Modelleinstellungen, um Anbietereinträge hinzuzufügen oder zu bearbeiten und das Standardmodell auszuwählen:

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

Die standardmäßige lokale Adresse ist http://127.0.0.1:3080. YAML bleibt der direkte Weg, um die Routennamen und Basis-URLs in diesem Leitfaden abzugleichen.

Textinteraktion überprüfen

Führen Sie eine einmalige Headless-Aufgabe über das Projektverzeichnis aus, das Harness verwenden soll:

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

Bei erfolgreicher Ausführung wird COMETAPI_DSH_OK ausgegeben. Um einen anderen Anbieter zu prüfen, aktualisieren Sie agent-default-model und führen Sie den Befehl erneut aus.

Verwendung des Dateitools überprüfen

Erstellen Sie eine temporäre Sentinel-Datei und bitten Sie Harness dann, sie mit einem Dateitool zu lesen:

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

Vergewissern Sie sich, dass die endgültige Antwort COMETAPI_DSH_TOOL_OK lautet. Führen Sie Harness nur in einem Workspace aus, in dem Sie dessen Datei-, Prozess- und Netzwerkzugriff akzeptieren.

Optionale Route

Harness verfügt über eine integrierte Anbieterroute namens google. Die folgende Konfiguration verweist diese Route auf CometAPI, sodass sie den nativen Google-Endpunkt der Route ersetzt, statt eine zweite Google-Route hinzuzufügen. Führen Sie diesen Eintrag in llm-pi-ai.providers zusammen und wählen Sie ihn dann in agent-default-model aus:

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

Fügen Sie diesem Eintrag kein Feld api hinzu. Die integrierte Route google behält ihr natives Google-Protokoll bei und sendet Streaming-Anfragen an /v1beta/models/{model}:streamGenerateContent?alt=sse mit x-goog-api-key-Authentifizierung.

Fehlerbehebung

Harness meldet, dass der API-Schlüssel fehlt

Vergewissern Sie sich, dass COMETAPI_KEY in derselben Shell gesetzt ist, die Harness startet. Starten Sie Harness nach dem Ändern der Umgebungsvariablen neu.

Harness zeigt das konfigurierte Modell nicht an

Vergewissern Sie sich, dass $DSH_HOME/settings.yaml gültiges YAML ist, der Provider unter llm-pi-ai.providers steht und das Modell unter models dieses Providers aufgeführt ist. Der Standardwert für DSH_HOME ist ~/.dsh.

Chat Completions oder Responses verwenden den falschen Pfad

Verwenden Sie https://api.cometapi.com/v1 als baseURL. Hängen Sie weder /chat/completions noch /responses an; Harness fügt den Operationspfad an.

Anthropic Messages gibt einen Pfadfehler zurück

Verwenden Sie https://api.cometapi.com ohne /v1 als baseURL für Messages. Der Anthropic-Adapter fügt /v1/messages an.

Google erzeugt einen doppelten v1beta-Pfad

Verwenden Sie https://api.cometapi.com/v1beta genau so. Hängen Sie keinen Modellpfad an und fügen Sie kein api-Feld zur integrierten google-Route hinzu.

Ein Modell funktioniert bei einem Provider, aber nicht bei einem anderen

Modellverfügbarkeit und akzeptierte API-Formate können sich unterscheiden. Wählen Sie für jeden Provider-Eintrag ein Modell, statt anzunehmen, dass ein Modell in allen vier Formaten funktioniert.

Die Konfiguration funktioniert nach einem Upgrade nicht mehr

DeepSeek Harness befindet sich in der Developer Preview. Kehren Sie zu @deepseek-ai/dsh@0.1.0-rc.8 zurück und prüfen Sie anschließend Upstream-Änderungen, bevor Sie die Konfiguration an eine andere Version anpassen.

Überblick

AI-Coding-Agenten

AI-Agenten

AI-Chat-Clients

Übersetzung und Sprache

Automatisierungsplattformen

Observability und Evaluierung

AI-Frameworks

DeepSeek Harness mit CometAPI verwenden

Voraussetzungen

Die Provider-Routen verstehen

Anbieter konfigurieren

Optionale Route

Fehlerbehebung

Weiterführende Ressourcen

​Voraussetzungen

​Die Provider-Routen verstehen

​Anbieter konfigurieren

​Optionale Route

​Fehlerbehebung

​Weiterführende Ressourcen

Voraussetzungen

Die Provider-Routen verstehen

Anbieter konfigurieren

Optionale Route

Fehlerbehebung

Weiterführende Ressourcen