6 min read

AgentKeyでDeepSeek Harnessを現実に接続

LLMの限界を超えるためのDSHとAgentKey連携ガイド。現実にデータを取り込み、トレーサブルなエージェント運用を実現。

AgentKeyでDeepSeek Harnessを現実に接続

大規模言語モデルは理解、推論、コンテンツ生成において優れています。しかし、今日のニュース、ソーシャルメディアのやり取り、製品価格、企業情報、ブロックチェーン上のアクティビティなどに依存するタスクでは、モデルの既存知識だけでは不十分です。

そこであらわれるのがエージェントハーネスです。モデルが思考し、ハーネスが実環境での作業を維持し、外部ツールが生情報をコンテキストに取り込みます。

DeepSeek Harness (DSH)およびAgentKeyは、このスタックの相互補完的な2つの部分をカバーします。DSHはオープンで構成可能、かつトレース可能なエージェントランタイムを提供します。AgentKeyは統一された生データアクセスレイヤーを提供します。これらを組み合わせることで、ローカルで動作するDSHエージェントはウェブ検索、プラットフォームの調査、市場・オンチェーンデータの照会が可能になり、すべてのツール呼び出し履歴をセッショントラジェクトリに保持できます。

DeepSeek Harnessとは？

DeepSeek Harnessは`dsh`コマンドで起動される、DeepSeekが開発したオープンソースのエージェントハーネスです。DeepSeekによると、モデルはエージェントの「魂」であり、ハーネスはそれが環境を理解し、ツールを活用し、実世界の設定で作業を継続するのを支援します。

DSHはCordis上で構築され、一つの核心的な概念を採用しています：「すべてはプラグインである」という思想。モデルアダプター、ツール、スキル、セッション、サンドボックス、ストレージ、エージェントループ、スケジューリング、さらにはUIまでもマウント、置換、再構成可能です。開発者はDSHのソースコードを変更することなく、設定のみで機能スタックを変更できます。

主な利点として以下が挙げられます：

  • 設計段階から構成可能：機能はプラグインと設定レイヤーを通じて組み立てられ、ユースケースに応じて異なるモデル、ツール、権限ポリシー、ストレージシステム、実行モードを選択できます。
  • 実行プロセスの追跡可能性：システムプロンプト、推論過程、ツール呼び出しとその結果、サブエージェントのスケジューリング、コンテキストの注入は、すべて追加専用セッショントラジェクトリに記録され、検査、再開、分岐、検索、再生に対応しています。
  • 複数のランタイムモード：Standardモードはフルエージェントワークフローを提供します。Codeモードは生成コードによる複数ツール呼び出しのオーケストレーションを可能にし、Minimalモードは集中的なモデルベンチマークをサポートします。Creatorモードは開発者がランタイムを検証し、プラグインやプリセットを構築するのに役立ちます。
  • オープンソースかつローカル実行可能：DSHはMITライセンスのもと公開されており、Web UIを利用して使用するか、ソースコードからビルド・拡張することが可能です。

DSHは現在デベロッパープレビュー中であり、プラグインAPIや設定契約には破壊的変更が含まれる可能性があります。本番環境では、アップグレード前にDSHバージョンを固定し、プロフィール、パッチ、プラグインを確認してください。

AgentKeyとは？

AgentKeyはモデルでも他のチャットアシスタントでもありません。それはAIエージェントのための外部データアクセスレイヤーです。単一のMCP接続により、ウェブ検索、コンテンツ抽出、ソーシャルメディア、金融、EC、ビジネスインテリジェンス、暗号資産やオンチェーンデータなどの機能へのアクセスをエージェントに提供します。

従来のアプローチでは、検索、ソーシャルデータ、市場フィードなどの各サービスに別々のアカウントやAPIキー、SDK、クォータ請求、エラー処理が必要でした。AgentKeyはこれらを単一アカウント、共通残高、エージェント向けワークフローの下に統合し、クラウド側ではプロバイダーとツールのカタログを更新管理しています。

モデルに固定のAPI操作名を記憶させるのではなく、AgentKeyは動的な発見用の3つのツールを公開しています：

  1. find_toolsはユーザーの完全な意図に基づいて現在のカタログを検索し、適切なツールと通話料金を返します。
  2. describe_toolは選択したツールのパラメータスキーマ、必須フィールド、確認済みのコストを返します。
  3. execute_toolは先ほど確認したスキーマを使用してツールを実行します。

これにより一貫したエージェントワークフローが構築されます：

User request
   ↓
DSH Agent + AgentKey Skill
   ↓
find_tools → describe_tool → execute_tool
   ↓
AgentKey routes the request to an appropriate data service
   ↓
The result returns to DSH and is recorded in the session trajectory

このアーキテクチャは以下の実践的な利点をもたらします：

  • 各データソースごとの個別統合不要：単一接続で複数のカテゴリにわたる生データツールを利用可能になります。
  • 継続的に進化できるカタログ：エージェントはハ〖ドコーディングされた期限切れの操作名に頼るのではなく、実行時に機能を検出します。
  • 実行前の明示的なコスト表示：エージェントが操作を実行する前に通話課金情報が確認できるため、バッチタスクの制御が容易になります。
  • ルーティングとフェールオーバーの余地：特定のデータパスが利用不可の場合、エージェントは代替インターフェース、別のバージョン、または別プロバイダーを選択できます。
  • 単一モデルやハーネスへの依存なし：AgentKeyはDSHおよびMCPとスキルをサポートするその他のエージェントにデータレイヤーとして機能します。

なぜAgentKeyとDSHは相性が良いのか？

DSHは「エージェントはどう動かすべきか？」という問いに答え、AgentKeyは「エージェントはどうやって外部のリアルタイムデータを取得すべきか？」という問いに答えます。

Layer DSH provides AgentKey provides
Reasoning and execution Agent loop, model adapters, sessions, and context —
Tool system Tool registration, policies, permissions, and call traces Dynamic discovery and execution of external data tools
Extension mechanism Cordis plugins, profiles, bundles, and patches MCP Server + AgentKey Skill
Observability Session log, trajectory, resume, fork, and replay Tool selection, parameters, cost, and results
Real-world data Connections to MCP and other tool plugins Search, web, social, finance, e-commerce, business, and on-chain data

これらを組み合わせれば、DSHはローカルでの質問応答だけでなく、タスクの理解、外部機能の選択、生情報の取得、結果の照合を行い、全体のプロセスをDSHのツールポリシーとセッション追跡で管理しながら回答を生成できます。

AgentKeyを5分で統合

ステップ1：DSHを起動

Node.jsをインストールした後、DSH Web UIを起動します：

npx @deepseek-ai/dsh web

デフォルトでは、Web UIは以下のアドレスで開始され、http://127.0.0.1:3080ブラウザで開きます。

ステップ2：AgentKeyをインストール

macOSまたはLinuxでは公式インストーラーを実行し、DSHのみを対象にしてください：

curl -fsSL https://agentkey.app/install.sh | bash -s -- --only dsh

Windows PowerShellでは以下を実行：

& ([scriptblock]::Create((irm https://agentkey.app/install.ps1))) -Only "dsh"

インストーラーは次の2つの明確で同等に重要なタスクを実行します：

  • エージェントが`find_tools → describe_tool → execute_tool`ワークフローに従えるよう、AgentKeyスキルをグローバルにインストールします。
  • また、AgentKeyのデバイスコードログインを開始し、認証済みリモートMCP設定をDSHホームレベルのパッチに書き込みます。

ブラウザが開かれたら承認手続きを完了してください。サーバー接続、スキル、認証は独立した要素です：スキルのみインストールしてもMCPツールは作成されず、MCP設定のみを書き込んでもモデルが正しい動的検出手順をたどる保証にはなりません。

各操作を明示的に確認したい場合は、代わりに次の2つの手動コマンドを実行してください：

npx -y skills add chainbase-labs/agentkey -g -a universal -s agentkey -y
npx -y @agentkey/cli --auth-login --only dsh

2つ目のコマンドは汎用MCP OAuthではなくデバイスコードフローを使用します。現在のDSH MCPクライアントはStreamable HTTPトランスポートに対して静的ヘッダーを渡しますが、`authProvider`は提供しません。そのため、AgentKeyはそのCLIを使ってDSH接続前にBearerキーを書き込みます。

ステップ3：設定ファイルの保存場所の確認

AgentKey CLIは以下のファイル内にマークされたLoaderブロックを1つ維持しています：

${DSH_HOME:-~/.dsh}/cordis.patch.yml

これはDSHホームレベルのパッチであるため、各プロフィールに同じキーを重複登録することなく、既存および将来のプロフィールに適用されます。稼働中のプロフィールはHMRで変更を観測でき、停止中または新規のプロフィールは次回起動時にこれをロードします。

これは`CLI管理型のDSH MCP統合`であり、`dsh plugin add`を通してインストールされるネイティブDSHバンドルではありません。実際のAPIキーはローカルのホームパッチ内でのみ存在する必要があります。そのキーや設定ファイルをGitにコミットしないでください。

統合が正しく動作していることを確認

プラグインページで`Mounted`というステータスが表示されたからといって、設定が完了したわけではありません。`Mounted`はCordisが設定行をロードしたことを示すだけであり、MCPの認証完了とツール同期を保証するものではありません。

次の3ステップで統合を確認します：

  1. 1. `DSH → Settings → Plugins → Plugin list`を開き、設定済みのID`agentkey`を検索します。該当行を展開すると`mcp-client`が表示され、そのバックエンドに`@deepseek-ai/dsh-mcp-client`が配置されているはずです。
  2. 2. AgentKeyを利用予定のプリセットまたはセッションで、次の3つのコアツールが表示されていることを確認します：
    • `mcp__agentkey__find_tools`
    • `mcp__agentkey__describe_tool`
    • `mcp__agentkey__execute_tool`
  3. 3. 生データが必要なタスクを送信し、トラジェクトリを検査して、発見・説明・実行が実際に発生したことを確認します。

例えば、DSHに以下のように尋ねてください：

「AgentKeyを使って今日の最新のAIニュースを探してください。まずはfind_toolsから始め、describe_toolで選択したツールを確認し、それを実行してから、出典付きで主要な動向を要約してください。」

より実践的なワークフローも試せます：

  • 「過去1ヶ月間、RedditとXでこの製品に関する議論を検索し、繰り返されている課題と機能リクエストを要約してください。」
  • 「数あるECプラットフォーム間で、この製品の現在の価格、レビュー、売上指標を比較してください。」
  • 「このウォレットの最近のオンチェーンアクティビティを検査し、プロトコルおよび資産タイプ別に要約してください。」
  • 「企業情報、最近のニュース、市場データを組み合わせて、最新の企業概要を作成してください。」

プロンプト内でプロバイダー操作名をハードコーディングしないでください。AgentKeyカタログは進化するため、`find_tools`でユーザーの全要求から機能を任せる方が、ワークフローを1つのインターフェースに固定するより一般的に信頼性が高まります。

トラブルシューティング

プラグインはMountedですが、AgentKeyツールがありません

アクティブなプリセット、セッション、サブエージェントのツール許可/拒否ポリシーを確認してください。ホームパッチはMCPクライアントをプロフィール構成に対して利用可能にしますが、すべてのコンテキストが強制的にすべてのツールを公開するわけではありません。その後、MCP接続ログを検査し、認証とツール同期が正常に完了したことを確認します。

DSHが401を返す

ローカルのBearerキーが見つからないか無効です。認証コマンドを再度実行してキーを更新し、管理対象の設定ブロックを置き換えてください：

npx -y @agentkey/cli --auth-login --only dsh

DSHが「`serverName already in use

`」を報告します。古いプリセットまたはセッションが残りのMCPクライアントを使用して`serverName: agentkey`設定を含んでいる可能性があります。現在のCLIを再度実行してレガシー設定に対処してください。既存セッションが古いプリセットを読み込んでいる場合は、そのセッションを閉じるかDSHを再起動してください。

`

DSH_HOME`が設定されているか確認してください。設定されていない場合、DSHは`~/.dsh`がデフォルトとなります。CLIは成功メッセージで実際の保存先を出力するので、そのパスを基準にしてください。（注：原文の分割位置 `s123` は `. The CLI prints...` にあたります。整合性を取るため修正）

リモートまたはヘッドレス環境でブラウザが開かない

no-browserモードを使用して、CLIが認証URLとQRコードを出力するようにしてください：

npx -y @agentkey/cli --auth-login --only dsh --no-browser

まとめ

有用なエージェントは、単に回答を生成できるモデル以上のものです。信頼性の高いランタイム、明確なツールの境界、追跡可能な実行プロセス、そして学習データ外のリアルタイム情報に到達する方法が必要です。

DSHはモデル、ツール、スキル、セッション、サンドボックス、UIコンポーネントを組み立て可能なハーネスに変えます。AgentKeyは断片化された外部データAPIを、エージェントが動的に発見して呼び出せる機能に変換します。これらはDSHの開放性、観測性、構成性を維持しつつ、検索、ソーシャル、市場、商業、業務、オンチェーンデータの追加に必要な工数を大幅に削減します。

もしすでにDeepSeek Harnessの実験を開始しているのであれば、最も簡単な第一歩はAgentKeyをインストールし、DSHに現時点の情報でしか答えられない質問を投げることです：

curl -fsSL https://agentkey.app/install.sh | bash -s -- --only dsh

これが「多くのことを知っている」エージェントから、「世界と接続して仕事をする」エージェントへの一歩です。

リファレンス