Flaq AI エージェントガイド

Flaq AI の OpenAI 互換 API で DeepSeek Harness を使用するための実践ガイド

オープンソースの DeepSeek Harness Web UI を Flaq AI の OpenAI 互換エンドポイントで実行し、対応する DeepSeek v4 モデルを接続して、リポジトリ分析やコーディングのワークフローに活用します。DeepSeek Harness は「すべてがプラグイン」というアーキテクチャを採用しており、モデルアダプター、ツール、エージェントループ、セッションストレージ、権限、サンドボックス、テレメトリ、Web UI をプラグインと設定によって組み合わせたり置き換えたりできます。

エージェントガイド

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

インストール

DeepSeek Harness を実行する

DeepSeek Harness には Node.js 22.19 以降、または 24 以降のリリースが必要です。デフォルトのファイルシステムの場所として使用したいプロジェクトディレクトリから起動してください。公式の npm コマンドでは、デフォルトで http://127.0.0.1:3080 に Web UI が起動します。

1

DeepSeek Harness Web UI を実行する

公式 npm パッケージを使用して Web UI を起動します。DeepSeek Harness の使用中は、このターミナルを実行したままにしてください。

初回実行時に、最新の @deepseek-ai/dsh パッケージがダウンロードされ、Web UI プロファイルが初期化されます。

公式 npm コマンド

npx @deepseek-ai/dsh web

リポジトリ：最新のインストール手順、リリース、互換性に関する注意事項、ソースコードは、DeepSeek Harness の公式 GitHub リポジトリで確認してください。

設定

DeepSeek Harness を Flaq AI に接続する

DeepSeek Harness で Settings → Models を開き、Flaq AI をカスタムプロバイダーとして追加して、Flaq API キーを入力します。Provider ID は保存後に変更できないため、意図的に別のルート名が必要な場合を除き、flaq を使用してください。プロバイダーを保存したら、セッションを開始する前にワークスペースを選択します。

リポジトリ分析、コーディングタスク、より高度な推論が役立つワークフローに推奨される DeepSeek v4 Pro モデルです。

Settings → Models で Add provider → Add a custom provider を選択します。以下の値を入力し、Fetch available models は使用せず、選択したモデル ID を手動で追加してください。プロバイダーを保存し、新しいセッションでそのモデルを選択します。追加のモダリティを宣言しない限り、DeepSeek Harness は手動で入力されたモデルをテキスト専用として扱います。

Flaq のベース URL と openai-completions プロトコルを正確に使用してください。プレースホルダーを Flaq API キーに置き換え、モデル ID は表示どおり正確に入力します。

Flaq AI カスタムプロバイダー

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

検証

DeepSeek Harness で Flaq を検証する

Web UI を開き、DeepSeek Harness を起動したプロジェクトディレクトリを選択し、設定済みの Flaq モデルを選んで新しいセッションを作成します。ワークスペースが選択されるまで、コンポーザーは使用できません。

DeepSeek Harness はアクティブな URL をターミナルに表示します。デフォルトのローカルアドレスを以下に示します。

Web UI を開く

http://127.0.0.1:3080

最初に読み取り専用タスクを送信します。選択したワークスペースの内容を反映した通常の回答が返れば、DeepSeek Harness が Flaq エンドポイントにアクセスし、設定したモデルを使用できることを確認できます。

リポジトリアクセスをテストする

Summarize this repository and identify its main packages. Do not modify any files.

プラグインの例

DeepSeek Harness プラグインをインストールする

DeepSeek Harness の「すべてがプラグイン」アーキテクチャの具体例として、DSH OpenPencil を使用します。上記の Flaq プロバイダーの設定と検証を完了し、実行中の Web UI を停止してから、web プロファイルにプラグインを追加し、同じバージョンの DeepSeek Harness を再起動します。DSH OpenPencil は、会話内で .op デザインドキュメントを作成、プレビュー、検査、編集するためのツールを追加します。

1

DSH OpenPencil をインストールする

プラグインで現在テスト済みの DeepSeek Harness バージョンを使用して、公開 OpenPencil パッケージを web プロファイルに追加します。DeepSeek Harness に使用しているものと同じプロジェクトディレクトリから、このコマンドを実行してください。

DSH OpenPencil をインストールする

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

リポジトリ：ソースコード、セットアップ要件、リリース、互換性に関する注意事項は、DSH OpenPencil GitHub リポジトリで確認してください。

2

Web UI を再起動する

テスト済みの DeepSeek Harness バージョンを再度起動し、web プロファイルが DSH OpenPencil を読み込めるようにします。Web UI を再度開いている間は、このターミナルを実行したままにしてください。

Web UI を再起動する

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Flaq AI で DSH OpenPencil をテストする

設定済みの Flaq モデルとワークスペースを選択し、新しいセッションを開始して、以下のリクエストを送信します。OpenPencil バイナリが利用可能な場合、プラグインは .op ドキュメントを作成し、会話内に編集可能なプレビューを表示します。

Flaq AI で DSH OpenPencil をテストする

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

オープンソース

DeepSeek Harness 公式リポジトリを調べる

DeepSeek Harness は、DeepSeek AI が開発したオープンソースのエージェントハーネスです。公式リポジトリにアクセスして、ソースコードの確認、リリースや互換性の変更の追跡、最新ドキュメントの閲覧、デベロッパープレビュー中の問題報告を行えます。

GitHub 上の DeepSeek Harness

DeepSeek Harness の公式リポジトリを開いて、ソースコード、セットアップドキュメント、開発ノート、ディスカッション、プロジェクトの更新情報を確認してください。

オープンソースガイド

Flaq AI のオープンソース DeepSeek Harness ガイドを調べる

初期セットアップの先へ進み、Flaq AI が独自にコミュニティで管理している DeepSeek Harness ガイドを活用しましょう。そのプラグインツリー、プロファイル、バンドル、パッチレイヤー、置き換え可能なエージェントループ、モデルアダプター、ツール、セッションサービス、権限ポリシー、サンドボックス、Web UI 拡張機能が、カスタムエージェントのワークフローをどのように支えるかを学べます。

GitHub 上の DeepSeek Harness ガイド

DeepSeek Harness を理解し、拡張し、その上に構築するための実践的なアーキテクチャノート、使用ハンドブック、プラグイン開発レシピ、多言語ドキュメント、再利用可能なエージェントスキルを確認できます。

トラブルシューティング

DeepSeek Harness よくある質問

このガイドの設定で使用すると、token 使用量が大幅に増える可能性があります。

X（Twitter）での DeepSeek Harness に関するディスカッション

オープンソースのエージェントハーネスである DeepSeek Harness（DSH）について、開発者や初期参加者によるディスカッションを確認できます。「すべてがプラグイン」アーキテクチャ、構成可能なランタイム、プラグインエコシステム、実際の利用体験などが取り上げられています。