DeepTask Sandbox 문서

DeepTask Sandbox는 AI 어시스턴트에게 안전하고 스크립팅 가능한 환경을 제공하는 로컬 우선 데스크톱 애플리케이션입니다. 자연스러운 대화(MCP를 통해)를 통해 어시스턴트는 스크립트를 실행하고, 승인된 로컬 기능에 액세스하며, 워크플로우를 안정적으로 조율할 수 있습니다. 작업에 실제 페이지가 필요한 경우 선택적으로 브라우저 기반 실행을 사용할 수 있습니다.

핵심 원칙

프라이버시 우선: 모든 자동화는 로컬에서 실행됩니다. 데이터가 절대 컴퓨터를 벗어나지 않습니다.
어시스턴트 준비: 모델 컨텍스트 프로토콜(MCP)을 위해 네이티브로 구축되었습니다. Claude, Cursor 등과 원활하게 작동합니다.
스크립팅 가능한 샌드박스: 가벼운 Javascript 로직을 실행하고, 필요할 때만 브라우저 기반 런타임(Puppeteer)을 선택합니다.
내장 가드레일: 스케줄링, 작업 기록, 리소스 제한, 도메인 허용 목록 및 암호화된 설정/자격 증명.

01. 빠른 시작

시작하고 실행하는 데 5분도 걸리지 않습니다.

1단계: 데스크톱 앱 설치

운영 체제용 설치 프로그램을 다운로드하고 실행합니다.

DeepTask Sandbox 다운로드

2단계: 어시스턴트 연결

DeepTask는 **모델 컨텍스트 프로토콜(MCP)**을 사용하여 AI와 통신합니다. 선호하는 환경에 대한 지침을 따르세요:

OS	설치 유형	명령 경로
Windows	시스템(기본값)	`C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe`
Windows	사용자	`C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe`
macOS	표준	`/Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp`
Linux	표준	`/opt/deeptask-sandbox/resources/mcp/deeptask-mcp`

예제 구성 블록(Claude Desktop):

{
  "mcpServers": {
    "deeptask": {
      "command": "여기에_명령_경로_붙여넣기"
    }
  }
}

3단계: 첫 번째 스크립트

연결되면 어시스턴트에게 샌드박스 내에서 작은 스크립트를 만들고 실행하도록 요청하기만 하면 됩니다.

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

"DeepTask를 사용하여 https://example.com의 제목을 가져와서 구조화된 출력으로 반환하는 작은 javascript 스크립트를 작성하세요."

02. 스크립팅 가이드

DeepTask 스크립트는 강력하고 타입 안전하며 구축하기 쉽습니다. AI가 이를 생성할 수 있으며, 직접 작성할 수도 있습니다.

스크립트 구조

모든 스크립트는 메타데이터(구성)와 메인 함수(로직)의 두 부분으로 구성됩니다.

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // 순수 로직의 경우 "javascript", 실제 브라우저가 필요한 경우 "puppeteer"
    description: "웹페이지에서 기본 정보 추출(브라우저 지원, 선택 사항)",
    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: `스크랩됨: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

고급 기능

파일 업로드

파일(PDF, 이미지 등)을 허용하는 입력을 정의할 수 있으며, 이는 Base64 문자열로 스크립트에 전달됩니다.

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "분석을 위해 PDF 업로드"
        }
    }
}

암호화된 설정

민감한 구성을 안전하게 저장합니다. 사용자는 UI에서 이러한 값을 입력하라는 메시지를 받으며, 저장 시 암호화됩니다.

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "OpenAI 키"
        }
    }
}
// 액세스 방법: const { apiKey } = browser.currentScript.settings;

03. 프로 기능

스마트 스케줄링

내장된 Cron 지원으로 워크플로우를 자동화합니다.

일일 보고서: 0 9 * * * (매일 아침 9시)
주간 정리: 0 0 * * 0 (매주 일요일 자정)

보안 및 격리

DeepTask는 엔터프라이즈용으로 구축되었습니다:

도메인 화이트리스팅: 특정 도메인을 명시적으로 허용하지 않는 한 스크립트는 인터넷에 액세스할 수 없습니다.
리소스 제한: 스크립트당 구성 가능한 CPU(50-100%) 및 RAM(64MB-2GB) 제한.
타임아웃 보호: 자동 스크립트 종료로 런어웨이 프로세스를 방지합니다.

04. API 및 도구 참조

전역 API

API	설명
`browser.getPage()`	(Puppeteer만 해당) 활성 페이지 객체를 반환합니다.
`browser.scripts.run(name, params)`	설치된 다른 스크립트를 실행합니다.
`browser.downloads.download({url, filename})`	로컬 컴퓨터에 파일을 저장합니다.
`browser.currentScript.settings`	스크립트의 구성된 설정에 액세스합니다.

어시스턴트를 위한 MCP 도구

AI 어시스턴트는 다음 표준 도구를 사용하여 DeepTask와 상호 작용할 수 있습니다:

install_script / uninstall_script
list_scripts / get_script_info
run_script
update_script_settings

지원 및 리소스

웹사이트: deeptask.ai
이메일: [email protected]
문제: 앱의 피드백 메뉴를 통해 버그를 보고하거나 기능을 요청하세요.