Documentation

DeepTask Sandbox Dokumentation

Eine sichere, lokal-erste Sandbox, die Ihren KI-Assistenten mit Ihrer Umgebung verbindet.
3 min read
Updated Jan 26, 2026

DeepTask Sandbox ist eine lokal-erste Desktop-Anwendung, die Ihrem KI-Assistenten eine sichere, skriptfähige Umgebung auf Ihrem Computer bietet. Durch natürliche Konversation (über MCP) kann Ihr Assistent Skripte ausführen, auf genehmigte lokale Funktionen zugreifen und Workflows zuverlässig orchestrieren – mit optionaler Browser-gestützter Ausführung, wenn eine Aufgabe wirklich eine echte Seite benötigt.

Kernprinzipien

  • Datenschutz zuerst: Alle Automatisierung läuft lokal. Ihre Daten verlassen niemals Ihren Computer.
  • Assistenten-bereit: Native Unterstützung für das Model Context Protocol (MCP). Funktioniert nahtlos mit Claude, Cursor und mehr.
  • Skriptfähige Sandbox: Führen Sie leichtgewichtige Javascript-Logik aus und entscheiden Sie sich nur bei Bedarf für eine Browser-gestützte Laufzeitumgebung (Puppeteer).
  • Eingebaute Schutzmaßnahmen: Planung, Aufgabenverlauf, Ressourcenlimits, Domain-Whitelists und verschlüsselte Einstellungen/Anmeldedaten.

01. Schnellstart

Der Einstieg dauert weniger als fünf Minuten.

Schritt 1: Desktop-App installieren

Laden Sie den Installer für Ihr Betriebssystem herunter und führen Sie ihn aus.

DeepTask Sandbox herunterladen

Schritt 2: Ihren Assistenten verbinden

DeepTask verwendet das Model Context Protocol (MCP), um mit Ihrer KI zu kommunizieren. Folgen Sie den Anweisungen für Ihre bevorzugte Umgebung:

OS Installationstyp Befehlspfad
Windows System (Standard) C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
Windows Benutzer 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

Beispiel-Konfigurationsblock (Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "BEFEHLSPFAD_HIER_EINFÜGEN"
    }
  }
}

Schritt 3: Ihr erstes Skript

Sobald verbunden, bitten Sie Ihren Assistenten einfach, ein kleines Skript in der Sandbox zu erstellen und auszuführen.

Probieren Sie diesen Prompt:

"Schreibe mit DeepTask ein kleines javascript-Skript, das den Titel von https://example.com abruft und als strukturierte Ausgabe zurückgibt."

02. Skripting-Leitfaden

DeepTask-Skripte sind leistungsstark, typsicher und einfach zu erstellen. Ihre KI kann diese für Sie generieren, oder Sie können sie selbst schreiben.

Anatomie eines Skripts

Jedes Skript besteht aus zwei Teilen: Metadaten (die Konfiguration) und der Hauptfunktion (die Logik).

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // "javascript" für reine Logik, "puppeteer" wenn Sie einen echten Browser benötigen
    description: "Extrahiert grundlegende Informationen von einer Webseite (Browser-gestützt, optional)",
    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: `Extrahiert: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

Erweiterte Funktionen

Datei-Uploads

Sie können Eingaben definieren, die Dateien (PDFs, Bilder usw.) akzeptieren, die als Base64-Strings an Ihr Skript übergeben werden.

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "PDF zur Analyse hochladen"
        }
    }
}

Verschlüsselte Einstellungen

Speichern Sie sensible Konfigurationen sicher. Benutzer werden in der UI nach diesen Werten gefragt, und sie werden im Ruhezustand verschlüsselt.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "OpenAI-Schlüssel"
        }
    }
}
// Zugriff über: const { apiKey } = browser.currentScript.settings;

03. Pro-Funktionen

Intelligente Planung

Automatisieren Sie Ihre Workflows mit integrierter Cron-Unterstützung.

  • Tägliche Berichte: 0 9 * * * (Jeden Morgen um 9 Uhr)
  • Wöchentliche Bereinigung: 0 0 * * 0 (Jeden Sonntag um Mitternacht)

Sicherheit und Isolation

DeepTask ist für Unternehmen konzipiert:

  • Domain-Whitelisting: Skripte können nicht auf das Internet zugreifen, es sei denn, Sie erlauben explizit bestimmte Domains.
  • Ressourcenlimits: Konfigurierbare CPU- (50-100%) und RAM-Limits (64MB-2GB) pro Skript.
  • Timeout-Schutz: Verhindert außer Kontrolle geratene Prozesse durch automatische Skriptbeendigung.

04. API- und Tool-Referenz

Globale APIs

API Beschreibung
browser.getPage() (Nur Puppeteer) Gibt das aktive Seitenobjekt zurück.
browser.scripts.run(name, params) Führt ein anderes installiertes Skript aus.
browser.downloads.download({url, filename}) Speichert Dateien auf dem lokalen Computer.
browser.currentScript.settings Greift auf die konfigurierten Einstellungen des Skripts zu.

MCP-Tools für Assistenten

Ihr KI-Assistent kann mit DeepTask über diese Standard-Tools interagieren:

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

Support und Ressourcen