DeepTask Sandbox 문서

DeepTask Sandbox는 안전하고 격리된 환경에서 자동화 도구를 실행하기 위한 크로스 플랫폼 데스크톱 애플리케이션입니다. Electron으로 빌드되고 Go 기반 MCP(Model Context Protocol) 서버와 통합되어, AI 어시스턴트가 머신에서 안전하고 도구를 사용할 수 있는 환경을 제공합니다. 자연스러운 대화를 통해(MCP 사용) 어시스턴트는 도구를 실행하고, 승인된 로컬 기능에 액세스하며, 작업에 실제 페이지가 필요할 때 선택적 브라우저 기반 실행(Puppeteer)으로 신뢰할 수 있게 워크플로를 조율할 수 있습니다.

참고: DeepTask Sandbox는 개인 및 교육적 용도로 무료입니다. 상업적 사용에는 사용자 수를 기반으로 한 월간 구독료가 적용되는 유료 라이선스가 필요합니다.

핵심 원칙

• 프라이버시 우선: 모든 자동화는 로컬에서 실행됩니다. 데이터는 절대 머신을 벗어나지 않습니다.
• 어시스턴트 준비 완료: Model Context Protocol (MCP)에 맞게 기본 제공됩니다. Claude, Cursor 등과 원활하게 작동합니다.
• 도구 사용 가능한 샌드박스: 백엔드 자동화를 위한 Node 도구와 브라우저 자동화 및 웹 스크래핑을 위한 Puppeteer 도구를 각각 격리된 워커 프로세스에서 실행합니다.
• 내장 가드레일: 스케줄링(cron), 작업 기록, 리소스 제한(메모리 64–2048 MB, CPU 임계값), 도메인 허용 목록, 암호화된 설정/자격 증명.

01. 빠른 시작

시작하는 데 5분 미만이 걸립니다.

1단계: 데스크톱 앱 설치

운영 체제용 설치 프로그램을 다운로드하여 실행하세요.

DeepTask Sandbox 다운로드

2단계: 어시스턴트 연결

DeepTask는 AI와 통신하기 위해 **Model Context Protocol (MCP)**를 사용합니다. 선호하는 환경에 맞는 지침을 따르세요:

예시 설정 블록 (Claude Desktop):

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

3단계: 첫 번째 도구

연결되면 어시스턴트에게 샌드박스 안에서 작은 도구를 만들고 실행하라고 요청하세요.

이 프롬프트를 시도해 보세요:

"DeepTask를 사용하여 https://example.com의 제목을 가져와 구조화된 출력으로 반환하는 작은 node 도구를 작성해 주세요."

02. 도구 가이드

DeepTask 도구는 강력하고 타입 안전하며 쉽게 빌드할 수 있습니다. AI가 대신 생성해 줄 수도 있고, 직접 작성할 수도 있습니다.

도구의 구조

모든 도구는 두 부분으로 구성됩니다: 메타데이터(구성)와 메인 함수(로직). 도구 이름은 snake_case를 사용해야 합니다(소문자, 숫자, 밑줄만; 예: web_scraper). 도구는 ESM(.mjs) 모듈이어야 하며; Node.js 24+가 지원됩니다.

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

고급 기능

파일 업로드

JSON Schema를 사용하여 파일(PDF, 이미지 등)을 허용하는 입력을 정의할 수 있습니다: contentEncoding: "base64", contentMediaType(예: application/pdf), 크기 제한을 위한 maxLength(base64는 약 33% 더 큼; 예: ~5MB → maxLength: 6990506).

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

도구에서 atob(input.document)로 디코딩하세요(또는 바이너리의 경우 new Uint8Array(atob(input.document).split('').map(c=>c.charCodeAt(0))))하고 필요에 따라 처리하세요. 크기 제한: maxLength = Math.ceil(bytes/3)*4(예: 1MB → 1398101, 5MB → 6990506).

암호화된 설정

민감한 구성을 안전하게 저장하세요. 사용자는 UI에서 이러한 값을 입력하라는 메시지를 받으며, 저장 시 암호화됩니다. 비밀번호 필드에 format: "password"를 사용하세요.

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

03. 보안 및 격리

모든 플랜에 이 안전 조치가 포함됩니다. DeepTask는 안정성과 보안을 위해 구축되었습니다:

• 도메인 허용 목록: networkEnabled: true를 설정하고 domainsAllowed를 지정하지 않으면 도구가 네트워크에 액세스할 수 없습니다(모든 호스트 허용: ["*"]). URL이 차단되면 fetch()가 요청 전에 throw합니다 — fetch()를 try/catch로 감싸세요.
• 리소스 제한: 구성 가능한 메모리(64–2048 MB; Node 기본 256 MB, Puppeteer 512 MB)와 CPU 임계값(50–100%, 기본 95%). 제한을 초과하는 도구는 자동으로 종료됩니다.
• 타임아웃 보호: defaultTimeout을 통해 도구별로 구성 가능(기본 5분).
• 파일시스템: 폴더 /Temp, /Documents, /Images, /Videos, /Audios, /Downloads가 있는 가상 파일시스템(루트 /)에 대한 선택적 읽기/쓰기 액세스. 호스트 파일시스템 액세스 없음; 경로는 루트를 벗어날 수 없음. fsEnabled 및 fsWriteEnabled 사용. fs/promises 사용 — readFileSync 같은 동기 메서드는 차단됨. 파일은 도구 호출 간에 유지됨; /Temp는 앱 시작 시 및 24시간마다 정리됨(최대 48시간).

04. Pro 기능

스마트 스케줄링

내장 Cron 지원으로 워크플로를 자동화하세요.

• 일일 리포트: 0 9 * * *(매일 오전 9시)
• 주간 정리: 0 0 * * 0(매주 일요일 자정)

05. API 및 도구 참조

Sandbox API

@deeptask/sandbox에서 가져오기:

Puppeteer: page.goto()는 http/https만 허용합니다. try/catch로 감싸세요. 응답 바이트에는 response.buffer() 사용(body() 아님).

document

import { document } from "@deeptask/sandbox"

문서 변환, PDF 조작 및 전문 검색. 모든 메서드는 { files, data, isError, message }를 반환합니다. files 또는 data 사용 전에 항상 isError를 확인하세요.

참고: protectPdf는 구현되지 않음 — 사용하지 마세요.

image

import { image } from "@deeptask/sandbox"

Sharp/libvips를 사용한 이미지 처리. 모든 메서드는 { files, data, isError, message }를 반환합니다.

audio

import { audio } from "@deeptask/sandbox"

오디오 변환 및 처리. 모든 메서드는 { files, data, isError, message }를 반환합니다.

참고: voiceToText는 구현되지 않음 — 사용하지 마세요.

video

import { video } from "@deeptask/sandbox"

비디오 변환, 자르기 및 효과. 모든 메서드는 { files, data, isError, message }를 반환합니다.

model

import { model } from "@deeptask/sandbox"

LLM 텍스트 생성, 이미지 생성 및 비디오 생성. networkEnabled 및 API 키 필요. format: "password"로 settingsSchema에 apiKey 저장; tool.self.settings.apiKey로 액세스. 키 하드코딩 금지.

archive

import { archive } from "@deeptask/sandbox"

파일 압축 및 압축 해제. 모든 메서드는 { files, data, isError, message }를 반환합니다.

어시스턴트용 MCP 도구

AI 어시스턴트가 다음 MCP 도구를 통해 DeepTask와 상호작용합니다:

• install_tool — 재사용을 위해 도구 설치. 이후 call_tool로 실행.
• uninstall_tool — 설치된 도구 제거.
• call_tool — 설치된 도구 실행. 도구 defaultTimeout에 따라 동기/비동기(>60s = 비동기).
• get_call_tool_result — 비동기 call_tool의 결과 폴링(taskId로).
• eval_tool_script — 설치 없이 한 번만 도구 실행(1회용). 매개변수: type, content, 선택적 sandboxId.
• batch_call_tools — 한 요청에서 여러 도구 호출.
• list_more_tools — 설치된 도구 목록. 도구 구문에 get_tool_script_syntax 사용(섹션: document, image, audio, video, model, archive).

지원 및 리소스

• 웹사이트: deeptask.ai
• 이메일: [email protected]
• 이슈: 앱의 피드백 메뉴를 통해 버그 신고 또는 기능 요청.