Documentation

Documentação do DeepTask Sandbox

Uma sandbox segura e local que conecta seu assistente de IA ao seu ambiente.
4 min read
Updated Jan 26, 2026

DeepTask Sandbox é uma aplicação desktop local que oferece ao seu assistente de IA um ambiente seguro e programável na sua máquina. Através de conversação natural (via MCP), seu assistente pode executar scripts, acessar capacidades locais aprovadas e orquestrar fluxos de trabalho de forma confiável — com execução opcional baseada em navegador quando uma tarefa realmente precisa de uma página real.

Princípios Fundamentais

  • Privacidade em Primeiro Lugar: Toda a automação é executada localmente. Seus dados nunca saem da sua máquina.
  • Pronto para Assistentes: Construído nativamente para o Model Context Protocol (MCP). Funciona perfeitamente com Claude, Cursor e mais.
  • Sandbox Programável: Execute lógica Javascript leve e opte por um runtime baseado em navegador (Puppeteer) apenas quando necessário.
  • Proteções Integradas: Agendamento, histórico de tarefas, limites de recursos, listas brancas de domínio e configurações/credenciais criptografadas.

01. Início Rápido

Começar a usar leva menos de cinco minutos.

Passo 1: Instalar a Aplicação Desktop

Baixe e execute o instalador para o seu sistema operacional.

Baixar DeepTask Sandbox

Passo 2: Conectar Seu Assistente

DeepTask usa o Model Context Protocol (MCP) para se comunicar com sua IA. Siga as instruções para o seu ambiente favorito:

SO Tipo de Instalação Caminho do Comando
Windows Sistema (Padrão) C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
Windows Usuário C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
macOS Padrão /Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp
Linux Padrão /opt/deeptask-sandbox/resources/mcp/deeptask-mcp

Exemplo de Bloco de Configuração (Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "COLE_O_CAMINHO_DO_COMANDO_AQUI"
    }
  }
}

Passo 3: Seu Primeiro Script

Uma vez conectado, simplesmente peça ao seu assistente para criar e executar um pequeno script dentro da sandbox.

Experimente este prompt:

"Usando DeepTask, escreva um pequeno script javascript que busca o título de https://example.com e o retorna como saída estruturada."

02. Guia de Scripting

Os scripts DeepTask são poderosos, seguros em tipos e fáceis de construir. Sua IA pode gerá-los para você, ou você pode escrevê-los você mesmo.

Anatomia de um Script

Cada script consiste em duas partes: Metadados (a configuração) e a Função Principal (a lógica).

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // "javascript" para lógica pura, "puppeteer" quando você precisa de um navegador real
    description: "Extrai informações básicas de uma página web (baseado em 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
    };
}

Recursos Avançados

Upload de Arquivos

Você pode definir entradas que aceitam arquivos (PDFs, Imagens, etc.) que são passados para o seu script como strings Base64.

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "Faça upload de um PDF para análise"
        }
    }
}

Configurações Criptografadas

Armazene configuração sensível com segurança. Os usuários são solicitados a fornecer esses valores na UI, e eles são criptografados em repouso.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "Chave OpenAI"
        }
    }
}
// Acesso via: const { apiKey } = browser.currentScript.settings;

03. Recursos Pro

Agendamento Inteligente

Automatize seus fluxos de trabalho com suporte Cron integrado.

  • Relatórios Diários: 0 9 * * * (Toda manhã às 9h)
  • Limpeza Semanal: 0 0 * * 0 (Todo domingo à meia-noite)

Segurança e Isolamento

DeepTask é construído para empresas:

  • Lista Branca de Domínios: Scripts não podem acessar a internet a menos que você permita explicitamente domínios específicos.
  • Limites de Recursos: Limites configuráveis de CPU (50-100%) e RAM (64MB-2GB) por script.
  • Proteção de Timeout: Previne processos descontrolados com terminação automática de scripts.

04. Referência de API e Ferramentas

APIs Globais

API Descrição
browser.getPage() (Apenas Puppeteer) Retorna o objeto de página ativo.
browser.scripts.run(name, params) Execute outro script instalado.
browser.downloads.download({url, filename}) Salve arquivos na máquina local.
browser.currentScript.settings Acesse as configurações definidas do script.

Ferramentas MCP para Assistentes

Seu assistente de IA pode interagir com DeepTask usando estas ferramentas padrão:

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

Suporte e Recursos