DeepSeek Harness を CometAPI で使用する

このガイドを使用して、 DeepSeek Harness を CometAPI で実行します。DeepSeek Harness は、カスタムモデルプロバイダーを $DSH_HOME/settings.yaml から読み込みます。デフォルトは ~/.dsh/settings.yaml です。このページの設定は @deepseek-ai/dsh@0.1.0-rc.8 で検証されています。各ルートでは、代表的なモデルを1つ使用して、ストリーミング（Streaming）テキストターンとファイル読み取りツールループを完了しました。この範囲は、すべての CometAPI モデルがすべての API 形式を受け入れることを意味するものではありません。

DeepSeek Harness は開発者プレビュー段階であり、破壊的変更が導入される可能性があります。このガイドに従う際はテスト済みのパッケージバージョンを固定し、アップグレード前にアップストリームのリリースノートを確認してください。

公式リファレンス：

前提条件

Node.js と npm
以下のダッシュボードから取得した有効な API キーを持つ CometAPI アカウント
以下の CometAPI Models ページから、使用予定の各 API 形式に対応するモデル ID

プロバイダールートを理解する

api の値でワイヤ形式を選択します。baseURL では、Harness が追加する操作パスの直前までを指定します。

プロバイダー ID	`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 が出力されるはずです。

CometAPI API キーを設定する

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

この例では、デフォルトでレスポンスプロバイダーを選択します。別の設定済みエントリを選択するには、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 です。このガイドのルート名とベース URL に合わせるには、YAML が直接的な方法です。

テキストターンを検証する

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 という名前の組み込みプロバイダールートが 1 つあります。以下の設定はそのルートを CometAPI に向けるため、2 つ目の 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 プロトコルを維持し、/v1beta/models/{model}:streamGenerateContent?alt=sse にストリーミング（Streaming）リクエストを x-goog-api-key 認証で送信します。

トラブルシューティング

Harness で API キーが見つからないと報告される

Harness を起動するのと同じシェルで COMETAPI_KEY が設定されていることを確認してください。環境変数を変更した後は Harness を再起動してください。

Harness に設定したモデルが表示されない

$DSH_HOME/settings.yaml が有効な YAML であること、プロバイダーが llm-pi-ai.providers の下にあること、モデルがそのプロバイダーの models の下にリストされていることを確認してください。デフォルトの DSH_HOME は ~/.dsh です。

チャット補完またはレスポンスで誤ったパスが使用される

https://api.cometapi.com/v1 を baseURL として使用してください。/chat/completions や /responses を追加しないでください。Harness が操作パスを追加します。

Anthropic メッセージでパスエラーが返される

https://api.cometapi.com を /v1 なしで Messages の baseURL として使用してください。Anthropic アダプターが /v1/messages を追加します。

Google で v1beta パスが重複して生成される

https://api.cometapi.com/v1beta をそのまま使用してください。モデルパスを追加せず、組み込みの api ルートに google フィールドを追加しないでください。

あるプロバイダーではモデルが動作するが、別のプロバイダーでは動作しない

モデルの可用性と受け入れられる API 形式は異なる場合があります。1 つのモデルが 4 つすべての形式で動作すると仮定せず、プロバイダーのエントリごとにモデルを選択してください。

アップグレード後に設定が動作しなくなる

DeepSeek Harness はデベロッパープレビューです。@deepseek-ai/dsh@0.1.0-rc.8 に戻り、別のバージョンに合わせて設定を変更する前にアップストリームの変更を確認してください。

概要

AIコーディングエージェント

AIエージェント

AIチャットクライアント

翻訳と言語

自動化プラットフォーム

可観測性と評価

AIフレームワーク

DeepSeek Harness を CometAPI で使用する

前提条件

プロバイダールートを理解する

プロバイダーを設定する

任意のルート

トラブルシューティング

関連リソース

​前提条件

​プロバイダールートを理解する

​プロバイダーを設定する

​任意のルート

​トラブルシューティング

​関連リソース

前提条件

プロバイダールートを理解する

プロバイダーを設定する

任意のルート

トラブルシューティング

関連リソース