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

DeepTask Sandbox — это кроссплатформенное desktop-приложение для запуска инструментов автоматизации в безопасных изолированных средах. Создано на Electron и интегрировано с MCP (Model Context Protocol) сервером на Go. Оно даёт вашему AI-ассистенту безопасную среду для инструментов на вашем компьютере. Через естественный диалог (через MCP) ассистент может запускать инструменты, использовать одобренные локальные возможности и координировать рабочие процессы надёжно — с опциональным выполнением в браузере (Puppeteer), когда задаче нужна реальная страница.

Примечание: DeepTask Sandbox бесплатен для личного и образовательного использования. Коммерческое использование требует платной лицензии с ежемесячной подпиской по количеству пользователей.

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

• Приватность прежде всего: Вся автоматизация выполняется локально. Ваши данные никогда не покидают ваш компьютер.
• Готов к ассистенту: Нативно интегрирован с Model Context Protocol (MCP). Работает с Claude, Cursor и другими.
• Инструментальная песочница: Запускайте Node-инструменты для backend-автоматизации и Puppeteer-инструменты для браузерной автоматизации и веб-скрапинга — каждый в изолированном рабочем процессе.
• Встроенные ограничения: Планирование (cron), история задач, лимиты ресурсов (память 64–2048 МБ, пороги CPU), белые списки доменов и зашифрованные настройки/учётные данные.

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

На запуск уходит менее пяти минут.

Шаг 1: Установите desktop-приложение

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

Скачать DeepTask Sandbox

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

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

Пример конфигурации (Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "PASTE_THE_COMMAND_PATH_HERE"
    }
  }
}

Шаг 3: Первый инструмент

После подключения попросите ассистента создать и запустить небольшой инструмент в песочнице.

Попробуйте этот запрос:

"Используя DeepTask, напиши небольшой node инструмент, который получает заголовок страницы https://example.com и возвращает его структурированным выводом."

02. Руководство по инструментам

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

Структура инструмента

Каждый инструмент состоит из двух частей: Метаданные (конфигурация) и Основная функция (логика). Имена инструментов должны быть в snake_case (строчные буквы, цифры, подчёркивания; напр. web_scraper). Инструменты должны быть ESM (.mjs) модулями; поддерживается Node.js 24+.

import { browser } from "@deeptask/sandbox";

export const metadata = {
    name: "web_scraper",
    type: "puppeteer", // "node" for pure logic, "puppeteer" when you need a real browser
    description: "Extracts basic info from a webpage",
    networkEnabled: true,
    domainsAllowed: ["example.com"],
    inputSchema: {
        type: "object",
        properties: {
            url: {type: "string", format: "uri"}
        },
        required: ["url"]
    }
};

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

    const title = await page.title();
    return {
        content: [{type: "text", text: `Scraped: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

Расширенные возможности

Загрузка файлов

Можно определить входы, принимающие файлы (PDF, изображения и т.д.) через JSON Schema: contentEncoding: "base64", contentMediaType (напр. application/pdf) и maxLength для ограничения размера (base64 примерно на 33% больше; напр. ~5MB → maxLength: 6990506).

inputSchema: {
    properties: {
        document: {
            type: "string",
            contentEncoding: "base64",
            contentMediaType: "application/pdf",
            maxLength: 6990506,  // ~5MB file
            description: "Upload a PDF for analysis"
        }
    }
}

В инструменте декодируйте через atob(input.document) (или new Uint8Array(atob(input.document).split('').map(c=>c.charCodeAt(0))) для бинарных) и обрабатывайте. Для лимитов размера: maxLength = Math.ceil(bytes/3)*4 (напр. 1MB → 1398101, 5MB → 6990506).

Зашифрованные настройки

Храните конфиденциальные настройки надёжно. Пользователи вводят значения в UI, они шифруются при хранении. Используйте format: "password" для полей пароля.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
            format: "password",
            title: "API Key"
        }
    }
}

03. Безопасность и изоляция

Эти меры включены во все планы. DeepTask создан для надёжности и безопасности:

• Белые списки доменов: Инструменты не могут обращаться к сети, пока вы не зададите networkEnabled: true и domainsAllowed (используйте ["*"] для всех хостов). При блокировке URL fetch() выбрасывает исключение до запроса — оборачивайте fetch() в try/catch.
• Лимиты ресурсов: Настраиваемая память (64–2048 МБ; по умолчанию 256 МБ для Node, 512 МБ для Puppeteer) и порог CPU (50–100%, по умолчанию 95%). Инструменты сверх лимита автоматически завершаются.
• Защита таймаутом: Настраивается на инструмент через defaultTimeout (по умолчанию 5 минут).
• Файловая система: Опциональный доступ чтения/записи к виртуальной ФС (корень /) с папками /Temp, /Documents, /Images, /Videos, /Audios, /Downloads. Доступа к хост-ФС нет; пути не могут выйти за пределы корня. Используйте fsEnabled и fsWriteEnabled. Используйте fs/promises — синхронные методы вроде readFileSync заблокированы. Файлы сохраняются между вызовами инструментов; /Temp очищается при запуске и каждые 24 часа (максимум 48 часов).

04. Pro функции

Умное планирование

Автоматизируйте рабочие процессы встроенной поддержкой Cron.

• Ежедневные отчёты: 0 9 * * * (каждое утро в 9:00)
• Еженедельная очистка: 0 0 * * 0 (каждое воскресенье в полночь)

05. API и справочник инструментов

Sandbox API

Импорт из @deeptask/sandbox:

Puppeteer: page.goto() принимает только http/https. Оборачивайте в try/catch. Для байтов ответа используйте response.buffer() (не body()).

document

import { document } from "@deeptask/sandbox"

Конвертация документов, работа с PDF и полнотекстовый поиск. Все методы возвращают { files, data, isError, message }. Всегда проверяйте isError перед использованием files или data.

Примечание: protectPdf не реализован — не используйте.

image

import { image } from "@deeptask/sandbox"

Обработка изображений с Sharp/libvips. Все методы возвращают { files, data, isError, message }.

audio

import { audio } from "@deeptask/sandbox"

Конвертация и обработка аудио. Все методы возвращают { files, data, isError, message }.

Примечание: voiceToText не реализован — не используйте.

video

import { video } from "@deeptask/sandbox"

Конвертация, обрезка и эффекты видео. Все методы возвращают { files, data, isError, message }.

model

import { model } from "@deeptask/sandbox"

Генерация текста LLM, генерация изображений и видео. Требуются networkEnabled и API-ключи. Сохраняйте apiKey в settingsSchema с format: "password"; доступ через tool.self.settings.apiKey. Никогда не хардкодируйте ключи.

archive

import { archive } from "@deeptask/sandbox"

Архивирование и распаковка файлов. Все методы возвращают { files, data, isError, message }.

MCP-инструменты для ассистентов

Ваш AI-ассистент взаимодействует с DeepTask через эти MCP-инструменты:

• install_tool — Установить инструмент для повторного использования. Затем запускать через call_tool.
• uninstall_tool — Удалить установленный инструмент.
• call_tool — Запустить установленный инструмент. Синхронный/асинхронный по defaultTimeout инструмента (>60s = async).
• get_call_tool_result — Опрос результата асинхронного call_tool (по taskId).
• eval_tool_script — Запустить инструмент разово без установки. Параметры: type, content, опционально sandboxId.
• batch_call_tools — Вызов нескольких инструментов в одном запросе.
• list_more_tools — Список установленных инструментов. Для синтаксиса инструмента используйте get_tool_script_syntax (разделы: document, image, audio, video, model, archive).

Поддержка и ресурсы

• Сайт: deeptask.ai
• Email: [email protected]
• Инциденты: Сообщайте об ошибках и запрашивайте функции через меню обратной связи приложения.