Documentation

Documentation DeepTask Sandbox

Un sandbox sécurisé et local qui connecte votre assistant IA à votre environnement.
4 min read
Updated Jan 26, 2026

DeepTask Sandbox est une application de bureau locale qui fournit à votre assistant IA un environnement sûr et scriptable sur votre machine. Grâce à une conversation naturelle (via MCP), votre assistant peut exécuter des scripts, accéder à des capacités locales approuvées et orchestrer des flux de travail de manière fiable, avec une exécution optionnelle basée sur un navigateur lorsqu'une tâche nécessite vraiment une page réelle.

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 : Construit nativement pour le Model Context Protocol (MCP). Fonctionne parfaitement avec Claude, Cursor et plus encore.
  • Sandbox Scriptable : Exécutez une logique Javascript légère et optez pour un runtime basé sur un navigateur (Puppeteer) uniquement lorsque nécessaire.
  • Garde-fous Intégrés : Planification, historique des tâches, limites de ressources, listes blanches de domaines et paramètres/identifiants cryptés.

01. Démarrage Rapide

Démarrer prend moins de cinq minutes.

Étape 1 : Installer l'Application de Bureau

Téléchargez et exécutez le programme d'installation 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 préféré :

OS Type d'Installation Chemin de Commande
Windows Système (Par défaut) C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
Windows Utilisateur C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
macOS Standard /Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp
Linux Standard /opt/deeptask-sandbox/resources/mcp/deeptask-mcp

Exemple de Bloc de Configuration (Claude Desktop) :

{
  "mcpServers": {
    "deeptask": {
      "command": "COLLEZ_LE_CHEMIN_DE_COMMANDE_ICI"
    }
  }
}

Étape 3 : Votre Premier Script

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

Essayez cette invite :

"En utilisant DeepTask, écris un petit script javascript qui récupère le titre de https://example.com et le renvoie comme sortie structurée."

02. Guide de Scripting

Les scripts DeepTask sont puissants, sécurisés en termes de types et faciles à construire. Votre IA peut les générer pour vous, ou vous pouvez les écrire vous-même.

Anatomie d'un Script

Chaque script se compose de deux parties : Métadonnées (la configuration) et la Fonction Principale (la logique).

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // "javascript" pour la logique pure, "puppeteer" lorsque vous avez besoin d'un vrai navigateur
    description: "Extrait des informations de base d'une page web (basé sur un navigateur, optionnel)",
    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: `Extrait : ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

Fonctionnalités Avancées

Téléchargement de Fichiers

Vous pouvez définir des entrées qui acceptent des fichiers (PDFs, images, etc.) qui sont transmis à votre script sous forme de chaînes Base64.

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "Téléchargez un PDF pour l'analyse"
        }
    }
}

Paramètres Cryptés

Stockez la configuration sensible en toute sécurité. Les utilisateurs sont invités à saisir ces valeurs dans l'interface utilisateur, et elles sont cryptées au repos.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "Clé OpenAI"
        }
    }
}
// Accès via : const { apiKey } = browser.currentScript.settings;

03. Fonctionnalités Pro

Planification Intelligente

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

  • Rapports Quotidiens : 0 9 * * * (Chaque matin à 9h)
  • Nettoyage Hebdomadaire : 0 0 * * 0 (Chaque dimanche à minuit)

Sécurité et Isolation

DeepTask est conçu pour l'entreprise :

  • Liste Blanche de Domaines : Les scripts ne peuvent pas accéder à Internet à moins que vous n'autorisiez explicitement des domaines spécifiques.
  • Limites de Ressources : Limites configurables de CPU (50-100%) et de RAM (64MB-2GB) par script.
  • Protection contre les Délais : Prévenez les processus incontrôlés avec une terminaison automatique des scripts.

04. Référence API et Outils

APIs Globales

API Description
browser.getPage() (Puppeteer uniquement) Renvoie l'objet de page actif.
browser.scripts.run(name, params) Exécute un autre script installé.
browser.downloads.download({url, filename}) Enregistre des fichiers sur la machine locale.
browser.currentScript.settings Accède aux paramètres configurés du script.

Outils MCP pour les Assistants

Votre assistant IA peut interagir avec DeepTask en utilisant ces outils standard :

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

Support et Ressources

  • Site Web : deeptask.ai
  • Email : [email protected]
  • Problèmes : Signalez des bugs ou demandez des fonctionnalités via le menu de feedback de l'application.