Documentation

DeepTask Sandbox ドキュメント

AIアシスタントを環境に接続する安全なローカルファーストのサンドボックス。
2 min read
Updated Jan 26, 2026

DeepTask Sandbox は、AIアシスタントにマシン上で安全でスクリプト可能な環境を提供するローカルファーストのデスクトップアプリケーションです。自然な会話(MCPを通じて)により、アシスタントはスクリプトを実行し、承認されたローカル機能にアクセスし、ワークフローを確実に調整できます。タスクが実際のページを必要とする場合には、オプションでブラウザベースの実行を使用できます。

核心原則

  • プライバシー第一: すべての自動化はローカルで実行されます。データがマシンから出ることはありません。
  • アシスタント対応: Model Context Protocol (MCP) 用にネイティブに構築されています。Claude、Cursorなどとシームレスに連携します。
  • スクリプト可能なサンドボックス: 軽量なJavascriptロジックを実行し、必要な場合のみブラウザベースのランタイム(Puppeteer)を選択します。
  • 組み込みガードレール: スケジューリング、タスク履歴、リソース制限、ドメイン許可リスト、および暗号化された設定/資格情報。

01. クイックスタート

起動と実行には5分もかかりません。

ステップ1: デスクトップアプリをインストール

お使いのオペレーティングシステム用のインストーラーをダウンロードして実行します。

DeepTask Sandbox をダウンロード

ステップ2: アシスタントを接続

DeepTaskは**Model Context Protocol (MCP)**を使用してAIと通信します。お好みの環境の手順に従ってください:

OS インストールタイプ コマンドパス
Windows システム(デフォルト) C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
Windows ユーザー C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
macOS 標準 /Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp
Linux 標準 /opt/deeptask-sandbox/resources/mcp/deeptask-mcp

設定ブロックの例 (Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "ここにコマンドパスを貼り付け"
    }
  }
}

ステップ3: 最初のスクリプト

接続したら、アシスタントにサンドボックス内で小さなスクリプトを作成して実行するように依頼するだけです。

このプロンプトを試してください:

"DeepTaskを使用して、https://example.comのタイトルを取得し、構造化された出力として返す小さなjavascriptスクリプトを書いてください。"


02. スクリプティングガイド

DeepTaskスクリプトは強力で、型安全で、構築が簡単です。AIがこれらを生成することも、自分で書くこともできます。

スクリプトの構造

各スクリプトは2つの部分で構成されています:メタデータ(設定)とメイン関数(ロジック)。

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // 純粋なロジックには"javascript"、実際のブラウザが必要な場合は"puppeteer"
    description: "ウェブページから基本情報を抽出(ブラウザベース、オプション)",
    networkEnabled: true,
    domainsAllowed: ["example.com"],
    inputSchema: {
        type: "object",
        properties: {
            url: {type: "string", format: "uri"}
        },
        required: ["url"]
    }
};

export async function main({url}) {
    const page = await browser.getPage();
    await page.goto(url, {waitUntil: "networkidle0"});

    const title = await page.title();
    return {
        content: [{type: "text", text: `スクレイピング済み: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

高度な機能

ファイルアップロード

ファイル(PDF、画像など)を受け入れる入力を定義でき、これらはBase64文字列としてスクリプトに渡されます。

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "分析用のPDFをアップロード"
        }
    }
}

暗号化された設定

機密設定を安全に保存します。ユーザーはUIでこれらの値を入力するように求められ、保存時に暗号化されます。

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "OpenAI キー"
        }
    }
}
// アクセス方法: const { apiKey } = browser.currentScript.settings;

03. プロ機能

スマートスケジューリング

組み込みのCronサポートでワークフローを自動化します。

  • 毎日のレポート: 0 9 * * * (毎朝9時)
  • 週次クリーンアップ: 0 0 * * 0 (毎週日曜日の深夜)

セキュリティと分離

DeepTaskは企業向けに構築されています:

  • ドメインホワイトリスト: 特定のドメインを明示的に許可しない限り、スクリプトはインターネットにアクセスできません。
  • リソース制限: スクリプトごとに設定可能なCPU(50-100%)とRAM(64MB-2GB)の上限。
  • タイムアウト保護: 自動スクリプト終了により暴走プロセスを防止します。

04. API とツールリファレンス

グローバル API

API 説明
browser.getPage() (Puppeteerのみ) アクティブなページオブジェクトを返します。
browser.scripts.run(name, params) 別のインストール済みスクリプトを実行します。
browser.downloads.download({url, filename}) ローカルマシンにファイルを保存します。
browser.currentScript.settings スクリプトの設定にアクセスします。

アシスタント用のMCPツール

AIアシスタントは、これらの標準ツールを使用してDeepTaskと対話できます:

  • install_script / uninstall_script
  • list_scripts / get_script_info
  • run_script
  • update_script_settings

サポートとリソース

  • ウェブサイト: deeptask.ai
  • メール: [email protected]
  • 問題: アプリのフィードバックメニューからバグを報告したり機能をリクエストしたりできます。