Skip to main content
DeepSeek Harness はローカルで動作するプログラミングエージェントです。作業スペースを読み取り、ツールを呼び出し、コマンドを実行し、OpenAI互換のChat Completionsインターフェースを介してモデルを呼び出します。
本文は deepseek-harness-sdk==0.1.0rc6 と deepseek-harness-runtime-bin==0.1.0rc6 に適用されます。クライアントをアップグレードした後は、下記の読み取り専用ファイルテストを再度実行してください。

サポート範囲

モデルディレクトリは変更される可能性があります。実行前にCoding Plan専用キーを使用してリアルタイムディレクトリを確認してください:
応答に deepseek-v4-pro が含まれていることを確認してください。deepseek-v4-flash を本文のツールモードの同等の代替として使用しないでください;今回の固定バージョン検証では、その多段推論履歴とツール再生は通過しませんでした。

1. 専用キーの準備

コーディングプランアプリを開き、購入したCoding Applicationに入り、そのアプリの専用APIキーを作成またはコピーします。Coding Planは一般的な残高を使用せず、他のアプリのキーはパッケージ権限を代表することはできません。 キーを現在のシェルにのみ配置してください:
実際のキーをスクリプト、設定リポジトリ、ターミナルのスクリーンショット、またはセッション記録に書き込まないでください。

2. 隔離された作業スペースの作成

HarnessのバンドルされたランタイムにはローカルBashツールが含まれています。最初の検証では実際のプロジェクトやホームディレクトリを指さないでください;秘密のない一時的なディレクトリを作成します:
会社のネットワークがプライベートPyPIミラーを使用している場合は、ミラーに同じバージョンの deepseek-harness-runtime-bin が存在することを確認してください。danger-full-access を使用してファイルアクセス範囲を拡大しないでください;本文の例では一時的なディレクトリのみを cwd に渡します。

3. 公式Python SDKの実行

以下の内容を /tmp/deepseek-harness-demo/run.py として保存します:
実行:
期待される結果:
このステップではBearer認証、/v1/chat/completions、SSE、推論内容、ツール呼び出しとツール結果の返却を同時に検証します。完了後は /tmp/deepseek-harness-demo を削除できます;もしセッションディレクトリにプロジェクトコンテキストが含まれている場合は、コードリポジトリと同等の機密レベルで保管する必要があります。

よくある質問

  • 401:ACEDATACLOUD_API_KEY がPythonを実行している同じシェルにエクスポートされているか確認してください。
  • 403 またはクォータの提示:キーが現在のCoding Applicationに属し、パッケージが有効で残高があることを確認してください。
  • モデルが利用できない:/v1/models を再度確認し、古いスクリーンショットに基づいてモデル名を推測しないでください。
  • reasoning_content / ツール再生エラー:SDK/runtimeが本文の固定バージョンであり、deepseek-v4-pro を使用していることを確認してください。
  • ツール実行回数の異常:副作用を引き起こす可能性のあるタスクの実行を停止し、まずは本文の読み取り専用フィクスチャで現在のサービスバージョンを検証してください。
  • インストール失敗:Python 3.10+、オペレーティングシステムアーキテクチャが現在のホイールでサポートされていることを確認し、SDK/runtimeのバージョンが一致しているか確認してください。

機能の限界

本文はローカルPython SDKからChat Completionsへのテキストとツールループのみを検証します。画像、Files API、/v1/responses、/v1/messages、リモート作業スペースおよびホスティングされたサンドボックスは本チュートリアルの約束範囲外です;作業スペースの権限とローカルコマンドのリスクは、Harnessを実行するマシンと設定が責任を負います。

公式リファレンス

Coding Plan 設定センターに戻る。