Documentation

Документация DeepTask Sandbox

Безопасная локальная песочница, которая подключает вашего AI-ассистента к вашей среде.
3 min read
Updated Jan 26, 2026

DeepTask Sandbox — это локальное настольное приложение, которое предоставляет вашему AI-ассистенту безопасную, скриптуемую среду на вашей машине. Через естественный разговор (через MCP) ваш ассистент может запускать скрипты, получать доступ к одобренным локальным возможностям и надежно организовывать рабочие процессы — с опциональным выполнением на основе браузера, когда задача действительно требует реальной страницы.

Основные Принципы

  • Конфиденциальность прежде всего: Вся автоматизация работает локально. Ваши данные никогда не покидают вашу машину.
  • Готовность для ассистентов: Создан нативно для Model Context Protocol (MCP). Бесшовно работает с Claude, Cursor и другими.
  • Скриптуемая песочница: Запускайте легкую логику Javascript и выбирайте среду выполнения на основе браузера (Puppeteer) только при необходимости.
  • Встроенные ограничители: Планирование, история задач, ограничения ресурсов, белые списки доменов и зашифрованные настройки/учетные данные.

01. Быстрый Старт

Запуск и начало работы занимает менее пяти минут.

Шаг 1: Установите Настольное Приложение

Скачайте и запустите установщик для вашей операционной системы.

Скачать DeepTask Sandbox

Шаг 2: Подключите Вашего Ассистента

DeepTask использует Model Context Protocol (MCP) для связи с вашим AI. Следуйте инструкциям для вашей любимой среды:

ОС Тип Установки Путь Команды
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, напиши небольшой скрипт javascript, который получает заголовок https://example.com и возвращает его как структурированный вывод."

02. Руководство по Скриптингу

Скрипты DeepTask мощные, типобезопасные и легкие в создании. Ваш AI может генерировать их для вас, или вы можете писать их самостоятельно.

Анатомия Скрипта

Каждый скрипт состоит из двух частей: Метаданные (конфигурация) и Основная Функция (логика).

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: [email protected]
  • Проблемы: Сообщайте об ошибках или запрашивайте функции через меню обратной связи приложения.