> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek Harness mit CometAPI verwenden

> Konfigurieren Sie DeepSeek Harness 0.1.0-rc.8 für die Verwendung von CometAPI über Chat Completions, Responses, Anthropic Messages oder Google generateContent.

Verwenden Sie diesen Leitfaden, um [DeepSeek Harness](https://github.com/deepseek-ai/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.

<Warning>
  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.
</Warning>

Offizielle Referenzen:

* [DeepSeek-Harness-Repository](https://github.com/deepseek-ai/deepseek-harness)
* [DeepSeek-Harness-0.1.0-rc.8-Quellcode](https://github.com/deepseek-ai/deepseek-harness/tree/dsh-v0.1.0-rc.8)
* [DeepSeek-Harness-CLI](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/apps/cli/README.md)
* [DeepSeek-Harness-Provider-Leitfaden](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/docs/user/guide/providers.md)

## Voraussetzungen

* Node.js und npm
* Ein CometAPI-Konto mit einem aktiven API-Schlüssel aus dem [Dashboard](https://www.cometapi.com/console/token)
* Eine Modell-ID von der [CometAPI-Modelle-Seite](/de/overview/models) 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`         |

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

## Anbieter konfigurieren

<Steps>
  <Step title="Getestete Harness-Version bestätigen">
    Bestätigen Sie die festgeschriebene Paketversion, bevor Sie Harness konfigurieren:

    ```bash theme={null}
    npx @deepseek-ai/dsh@0.1.0-rc.8 --version
    ```

    Der Befehl sollte `0.1.0-rc.8` ausgeben.
  </Step>

  <Step title="CometAPI-API-Schlüssel festlegen">
    Speichern Sie Ihren Schlüssel vor dem Start von Harness in `COMETAPI_KEY`:

    ```bash theme={null}
    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.
  </Step>

  <Step title="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:

    ```yaml theme={null}
    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:

    ```bash theme={null}
    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.
  </Step>

  <Step title="Textinteraktion überprüfen">
    Führen Sie eine einmalige Headless-Aufgabe über das Projektverzeichnis aus, das Harness verwenden soll:

    ```bash theme={null}
    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.
  </Step>

  <Step title="Verwendung des Dateitools überprüfen">
    Erstellen Sie eine temporäre Sentinel-Datei und bitten Sie Harness dann, sie mit einem Dateitool zu lesen:

    ```bash theme={null}
    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.
  </Step>
</Steps>

## 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:

```yaml theme={null}
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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Weiterführende Ressourcen

* [CometAPI-Schnellstart](/de/overview/quick-start)
* [CometAPI-Modellseite](/de/overview/models)
* [DeepSeek-Harness-Repository](https://github.com/deepseek-ai/deepseek-harness)
* [DeepSeek-Harness-Anbieterleitfaden](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.1.0-rc.8/docs/user/guide/providers.md)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#howto",
        "name": "DeepSeek Harness mit CometAPI verwenden",
        "description": "Konfigurieren Sie DeepSeek Harness 0.1.0-rc.8 für die Verwendung von CometAPI über Chat Completions, Responses, Anthropic Messages oder Google generateContent.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-1",
            "position": 1,
            "name": "Getestete Harness-Version bestätigen",
            "text": "Bestätigen Sie die festgelegte Paketversion von DeepSeek Harness 0.1.0-rc.8."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-2",
            "position": 2,
            "name": "Ihren CometAPI-API-Schlüssel festlegen",
            "text": "Speichern Sie den CometAPI-API-Schlüssel vor dem Start von Harness in COMETAPI_KEY."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-3",
            "position": 3,
            "name": "CometAPI-Anbieter hinzufügen",
            "text": "Fügen Sie die verifizierten Anbieterrouten zur Datei settings.yaml von Harness hinzu."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-4",
            "position": 4,
            "name": "Eine Textinteraktion überprüfen",
            "text": "Führen Sie eine festgelegte Aufgabe ohne Benutzeroberfläche aus und bestätigen Sie die erwartete Textantwort."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/deepseek-harness#step-5",
            "position": 5,
            "name": "Verwendung des Dateitools überprüfen",
            "text": "Fordern Sie Harness auf, eine Sentinel-Datei zu lesen, und bestätigen Sie die exakte endgültige Antwort."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "DeepSeek Harness mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/deepseek-harness"
          }
        ]
      }
    ]
    }
    `}
</script>