Documentation DeepTask Sandbox

DeepTask Sandbox est une application de bureau multiplateforme pour exécuter des outils d'automatisation dans des environnements sécurisés et isolés. Construite avec Electron et intégrée à un serveur MCP (Model Context Protocol) basé sur Go, elle offre à votre assistant IA un environnement sûr et outillé sur votre machine. Par une conversation naturelle (via MCP), votre assistant peut exécuter des outils, accéder aux capacités locales autorisées et orchestrer des flux de travail de manière fiable — avec une exécution optionnelle via navigateur (Puppeteer) lorsque une tâche nécessite une vraie page.

Note : DeepTask Sandbox est gratuit pour un usage personnel et éducatif. L'usage commercial nécessite une licence payante avec tarification par abonnement mensuel selon le nombre d'utilisateurs.

Principes fondamentaux

• Confidentialité d'abord : Toute l'automatisation s'exécute localement. Vos données ne quittent jamais votre machine.
• Prêt pour les assistants : Conçu nativement pour le Model Context Protocol (MCP). Fonctionne avec Claude, Cursor et plus.
• Sandbox outillable : Exécutez des outils Node pour l'automatisation backend et des outils Puppeteer pour l'automatisation navigateur et le web scraping — chacun dans des processus isolés.
• Garde-fous intégrés : Planification (cron), historique des tâches, limites de ressources (mémoire 64–2048 Mo, seuils CPU), listes blanches de domaines, et paramètres/identifiants chiffrés.

01. Démarrage rapide

La mise en route prend moins de cinq minutes.

Étape 1 : Installer l'application de bureau

Téléchargez et exécutez l'installateur pour votre système d'exploitation.

Télécharger DeepTask Sandbox

Étape 2 : Connecter votre assistant

DeepTask utilise le Model Context Protocol (MCP) pour communiquer avec votre IA. Suivez les instructions pour votre environnement :

Exemple de bloc de configuration (Claude Desktop) :

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

Étape 3 : Votre premier outil

Une fois connecté, demandez simplement à votre assistant de créer et exécuter un petit outil dans le sandbox.

Essayez cette invite :

"En utilisant DeepTask, écris un petit outil node qui récupère le titre de https://example.com et le retourne en sortie structurée."

02. Guide des outils

Les outils DeepTask sont puissants, type-safe et faciles à créer. Votre IA peut les générer pour vous, ou vous pouvez les écrire vous-même.

Anatomie d'un outil

Chaque outil se compose de deux parties : les Metadata (la configuration) et la fonction principale (la logique). Les noms d'outils doivent utiliser snake_case (minuscules, chiffres, tirets bas uniquement ; ex. web_scraper). Les outils doivent être des modules ESM (.mjs) ; Node.js 24+ est pris en charge.

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
    };
}

Fonctions avancées

Téléversement de fichiers

Vous pouvez définir des entrées acceptant des fichiers (PDF, images, etc.) via JSON Schema : contentEncoding: "base64", contentMediaType (ex. application/pdf) et maxLength pour les limites de taille (base64 est ~33 % plus grand ; ex. ~5 Mo → maxLength: 6990506).

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

Dans votre outil, décodez avec atob(input.document) (ou new Uint8Array(atob(input.document).split('').map(c=>c.charCodeAt(0))) pour le binaire) et traitez selon besoin. Pour les limites de taille : maxLength = Math.ceil(bytes/3)*4 (ex. 1 Mo → 1398101, 5 Mo → 6990506).

Paramètres chiffrés

Stockez la configuration sensible en toute sécurité. Les utilisateurs sont invités à saisir ces valeurs dans l'interface, et elles sont chiffrées au repos. Utilisez format: "password" pour les champs de mot de passe.

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

03. Sécurité et isolation

Tous les plans incluent ces protections. DeepTask est conçu pour la fiabilité et la sécurité :

• Listes blanches de domaines : Les outils ne peuvent pas accéder au réseau sauf si vous définissez networkEnabled: true et spécifiez domainsAllowed (utilisez ["*"] pour autoriser tous les hôtes). Quand une URL est bloquée, fetch() lance avant toute requête — enveloppez fetch() dans try/catch.
• Limites de ressources : Mémoire configurable (64–2048 Mo ; par défaut 256 Mo pour Node, 512 Mo pour Puppeteer) et seuil CPU (50–100 %, défaut 95 %). Les outils dépassant les limites sont automatiquement terminés.
• Protection par timeout : Configurable par outil via defaultTimeout (par défaut 5 minutes).
• Système de fichiers : Accès lecture/écriture optionnel à un système de fichiers virtuel (racine /) avec les dossiers /Temp, /Documents, /Images, /Videos, /Audios, /Downloads. Pas d'accès au système de fichiers hôte ; les chemins ne peuvent pas s'échapper de la racine. Utilisez fsEnabled et fsWriteEnabled. Utilisez fs/promises — les méthodes sync comme readFileSync sont bloquées. Les fichiers persistent entre les invocations ; /Temp est nettoyé au démarrage de l'app et toutes les 24 h (âge max 48 h).

04. Fonctions Pro

Planification intelligente

Automatisez vos flux de travail avec le support Cron intégré.

• Rapports quotidiens : 0 9 * * * (Chaque matin à 9 h)
• Nettoyage hebdomadaire : 0 0 * * 0 (Chaque dimanche à minuit)

05. API et référence des outils

Sandbox API

Importez depuis @deeptask/sandbox :

Puppeteer : page.goto() n'accepte que http/https. Enveloppez dans try/catch. Utilisez response.buffer() (pas body()) pour les octets de réponse.

document

import { document } from "@deeptask/sandbox"

Conversion de documents, manipulation PDF et recherche plein texte. Toutes les méthodes renvoient { files, data, isError, message }. Toujours vérifier isError avant d'utiliser files ou data.

Note : protectPdf n'est pas implémenté — ne pas utiliser.

image

import { image } from "@deeptask/sandbox"

Traitement d'images avec Sharp/libvips. Toutes les méthodes renvoient { files, data, isError, message }.

audio

import { audio } from "@deeptask/sandbox"

Conversion et traitement audio. Toutes les méthodes renvoient { files, data, isError, message }.

Note : voiceToText n'est pas implémenté — ne pas utiliser.

video

import { video } from "@deeptask/sandbox"

Conversion, découpage et effets vidéo. Toutes les méthodes renvoient { files, data, isError, message }.

model

import { model } from "@deeptask/sandbox"

Génération de texte LLM, d'images et de vidéos. Nécessite networkEnabled et des clés API. Stockez apiKey dans settingsSchema avec format: "password" ; accès via tool.self.settings.apiKey. Ne jamais hardcoder les clés.

archive

import { archive } from "@deeptask/sandbox"

Zipper et dézipper des fichiers. Toutes les méthodes renvoient { files, data, isError, message }.

Outils MCP pour les assistants

Votre assistant IA interagit avec DeepTask via ces outils MCP :

• install_tool — Installer un outil pour réutilisation. Exécuter avec call_tool ensuite.
• uninstall_tool — Supprimer un outil installé.
• call_tool — Exécuter un outil installé. Sync/async selon defaultTimeout de l'outil (>60 s = async).
• get_call_tool_result — Interroger le résultat de call_tool async (par taskId).
• eval_tool_script — Exécuter un outil une fois sans installation (ponctuel). Paramètres : type, content, sandboxId optionnel.
• batch_call_tools — Appeler plusieurs outils en une requête.
• list_more_tools — Lister les outils installés. Utilisez get_tool_script_syntax pour la syntaxe des outils (sections : document, image, audio, video, model, archive).

Support et ressources

• Site web : deeptask.ai
• E-mail : [email protected]
• Incidents : Signaler des bugs ou demander des fonctionnalités via le menu de feedback de l'app.