Documentación de DeepTask Sandbox

DeepTask Sandbox es una aplicación de escritorio local que proporciona a tu asistente de IA un entorno seguro y programable en tu máquina. A través de conversación natural (vía MCP), tu asistente puede ejecutar scripts, acceder a capacidades locales aprobadas y orquestar flujos de trabajo de manera confiable, con ejecución respaldada por navegador opcional cuando una tarea realmente necesita una página real.

Principios Fundamentales

Privacidad Primero: Toda la automatización se ejecuta localmente. Tus datos nunca salen de tu máquina.
Listo para Asistentes: Construido nativamente para el Protocolo de Contexto de Modelo (MCP). Funciona sin problemas con Claude, Cursor y más.
Sandbox Programable: Ejecuta lógica Javascript ligera y opta por un entorno de ejecución respaldado por navegador (Puppeteer) solo cuando sea necesario.
Protecciones Integradas: Programación, historial de tareas, límites de recursos, listas blancas de dominios y configuraciones/credenciales encriptadas.

01. Inicio Rápido

Ponerse en marcha lleva menos de cinco minutos.

Paso 1: Instalar la Aplicación de Escritorio

Descarga y ejecuta el instalador para tu sistema operativo.

Descargar DeepTask Sandbox

Paso 2: Conectar tu Asistente

DeepTask usa el Protocolo de Contexto de Modelo (MCP) para comunicarse con tu IA. Sigue las instrucciones para tu entorno favorito:

SO	Tipo de Instalación	Ruta del Comando
Windows	Sistema (Predeterminado)	`C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe`
Windows	Usuario	`C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe`
macOS	Estándar	`/Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp`
Linux	Estándar	`/opt/deeptask-sandbox/resources/mcp/deeptask-mcp`

Ejemplo de Bloque de Configuración (Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "PEGA_LA_RUTA_DEL_COMANDO_AQUÍ"
    }
  }
}

Paso 3: Tu Primer Script

Una vez conectado, simplemente pide a tu asistente que cree y ejecute un pequeño script dentro del sandbox.

Prueba este prompt:

"Usando DeepTask, escribe un pequeño script javascript que obtenga el título de https://example.com y lo devuelva como salida estructurada."

02. Guía de Scripting

Los scripts de DeepTask son potentes, seguros en tipos y fáciles de construir. Tu IA puede generarlos por ti, o puedes escribirlos tú mismo.

Anatomía de un Script

Cada script consta de dos partes: Metadatos (la configuración) y la Función Principal (la lógica).

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // "javascript" para lógica pura, "puppeteer" cuando necesitas un navegador real
    description: "Extrae información básica de una página web (respaldado por navegador, opcional)",
    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: `Extraído: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

Características Avanzadas

Carga de Archivos

Puedes definir entradas que acepten archivos (PDFs, Imágenes, etc.) que se pasan a tu script como cadenas Base64.

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "Sube un PDF para análisis"
        }
    }
}

Configuraciones Encriptadas

Almacena configuración sensible de forma segura. Los usuarios son solicitados para estos valores en la UI, y se encriptan en reposo.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "Clave OpenAI"
        }
    }
}
// Accede vía: const { apiKey } = browser.currentScript.settings;

03. Características Pro

Programación Inteligente

Automatiza tus flujos de trabajo con soporte Cron integrado.

Reportes Diarios: 0 9 * * * (Cada mañana a las 9 AM)
Limpieza Semanal: 0 0 * * 0 (Cada domingo a medianoche)

Seguridad y Aislamiento

DeepTask está construido para empresas:

Lista Blanca de Dominios: Los scripts no pueden acceder a internet a menos que permitas explícitamente dominios específicos.
Límites de Recursos: Límites configurables de CPU (50-100%) y RAM (64MB-2GB) por script.
Protección de Timeout: Previene procesos descontrolados con terminación automática de scripts.

04. Referencia de API y Herramientas

APIs Globales

API	Descripción
`browser.getPage()`	(Solo Puppeteer) Devuelve el objeto de página activo.
`browser.scripts.run(name, params)`	Ejecuta otro script instalado.
`browser.downloads.download({url, filename})`	Guarda archivos en la máquina local.
`browser.currentScript.settings`	Accede a las configuraciones del script.

Herramientas MCP para Asistentes

Tu asistente de IA puede interactuar con DeepTask usando estas herramientas estándar:

install_script / uninstall_script
list_scripts / get_script_info
run_script
update_script_settings

Soporte y Recursos

Sitio web: deeptask.ai
Email: [email protected]
Problemas: Reporta errores o solicita características a través del menú de feedback de la app.