Cloudflare Sandbox AI 코드 실행은 생성 코드를 주 애플리케이션에 직접 넣지 않고도 도우미가 파일을 변환하거나 계산하게 해 줍니다. 중요한 결정은 실행 환경이 어디에 접근할 수 있느냐입니다. 코드는 환경에 제공한 파일, 자격 증명, 네트워크 경로, 도구를 사용할 수 있습니다.

작업 부하에 맞게 선택한 실행 경계 안에서 생성 코드를 실행하고 입력, 네트워크 접근, 앱 기능을 의도적으로 제한하세요. 중요한 업무 작업은 환경 밖에 유지하고 반환 산출물은 사용하기 전에 검증해야 합니다. 접근을 넓히기 전에 정상 코드뿐 아니라 악의적인 코드로 격리, 자원 처리, 정리를 시험하세요.

분석가가 도우미에게 허용된 CSV 내보내기를 합치고 차트를 만들라고 요청하는 사례를 생각해 보세요. 도우미는 그 입력 파일과 출력 위치가 필요합니다. 회사 전체 저장소 계정이나 원본 시스템을 수정할 수 있는 자격 증명은 필요하지 않습니다.

이 글은 그 작업을 위한 아키텍처 제안입니다. 격리가 모든 위험을 없앤다거나 같은 샌드박스 환경이 모든 언어와 의존성에 맞는다고 주장하지 않습니다.

Cloudflare Sandbox AI 코드 실행 경계 정의하기

Cloudflare의 Sandboxes 개요 는 컨테이너 기반 환경과 Dynamic Workers를 구분합니다. 적절한 환경은 실행 요구에 따라 달라집니다. 오래된 Sandbox SDK 예제가 현재 인터페이스를 설명한다고 가정하지 말고 최신 문서에서 선택하세요.

분석가의 변환 작업에 필요한 언어, 라이브러리, 입력 형식, 출력 종류, 네트워크 목적지를 나열하세요. 제공한 파일의 로컬 계산만 필요하다면 추가 외부 접근에는 별도 이유가 있어야 합니다.

조율 Worker가 어떤 작업이 어떤 인증된 사용자에게 속하는지 판단하게 하세요. 코드 실행 환경에는 해당 작업에 허용된 자료만 전달해야 합니다. 더 많은 자료를 탐색할 수 있는 계정 전체의 자격 증명 집합을 넘기면 안 됩니다.

기능예시에 필요한가요?정의할 경계
선택 입력 파일 읽기예인가된 작업 입력만
결과 파일 쓰기예전용 출력 위치
공개 인터넷 접근반드시 필요하지 않음이유가 있는 지정 목적지만
운영 자격 증명 읽기아니요서비스 권한은 작업 밖에 유지
원본 업무 기록 수정아니요별도 검토된 앱 작업

실행 요구로 환경 선택하기

Cloudflare의 환경 선택 안내 는 사용 가능한 접근 방식을 비교하는 출발점입니다. 실제 작업이 요구하는 언어, 의존성, 수명 조건이 지원되는지 확인하세요.

도구 체인에 꼭 필요하다면 완전한 명령 환경이 유용할 수 있습니다. 동시에 파일, 프로세스, 의존성 동작을 고려해야 합니다. 제한된 변환만 필요하다면 더 좁은 실행 범위가 검토하기 쉬울 수 있습니다.

첫 시연이 쉬워진다는 이유만으로 가장 강력한 환경을 고르지 마세요. 구매 단계에서는 팀이 설명하고 유지할 수 있는 제어로 허용된 작업을 수행하는지 확인해야 합니다.

선택 플랫폼이 지원한다면 실행 이미지나 의존성 설정을 고정하세요. 결과와 함께 설정을 기록해 나중의 실패를 실제 코드를 실행한 환경에 연결할 수 있게 해야 합니다.

제안 흐름: 인가된 입력을 준비하고 제한된 실행 환경을 선택하며 명시적인 파일 및 네트워크 정책으로 실행한 뒤 산출물을 검증하고 정리합니다.
제안 설계. 의도적으로 부여한 기능만 경계 안으로 들어갑니다. 전체 크기 다이어그램 보기

비밀과 업무 권한을 앱에 유지하기

Cloudflare의 자격 증명 및 네트워크 지침 은 관련 제어 범위를 설명합니다. 선택 환경이 승인 서비스에 도달하는 방식을 확립하고 테스트 설정에서 그 동작을 직접 검증하세요.

분석가 작업에서는 조율 앱이 인가된 내보내기를 얻어 입력으로 전달할 수 있습니다. 생성 프로그램은 그 사본을 처리합니다. 다른 데이터 원본이 필요하면 신원과 권한 검사를 계속 수행하는 앱에 요청을 돌려보내야 합니다.

넓은 저장소 자격 증명을 주고 프롬프트로 허용 폴더를 지정하는 데 의존하지 마세요. 실제 권한은 자격 증명과 실행 경계입니다. 모델 지시가 얼마나 정중한지는 권한을 제한하지 않습니다.

출력에도 같은 원칙을 쓰세요. 작업은 파일이나 결과를 제안할 수 있고, 게시, 이메일, 가져오기 여부는 별도 앱 구성 요소가 결정합니다. 이렇게 하면 생성 코드가 변환 요청을 검토 없는 업무 작업으로 바꾸지 못합니다.

입력과 출력 파일을 모두 신뢰하지 않기

실행 전에 합의한 정책으로 입력 종류와 크기를 검증하세요. 정확히 어떤 파일이 들어갔는지 확인할 입력 목록을 남겨야 합니다. 검증된 격리 설계 없이 공유 작업 공간에서 서로 다른 사용자 입력을 섞지 마세요.

출력 파일도 검사해야 합니다. 예상 확장자를 가진 파일에 다른 형식, 숨은 내용, 오해를 부르는 계산이 있을 수 있습니다. 완료 결과로 보여 주기 전에 산출물 종류, 허용 위치, 의미 검사를 확인하세요.

재무 차트라면 합계를 원본 데이터와 비교하고 제외 항목을 설명하세요. 깔끔하게 렌더링한 이미지는 계산의 정확성을 증명하지 않습니다. 압축 파일이나 문서 내보내기라면 실제로 어떤 파일과 데이터가 들어 있는지 검사해야 합니다.

산출물 단계제안 검사막는 문제
입력 수락인가된 원본과 예상 형식실수로 다른 사용자 데이터 처리
작업 공간 준비작업별 경로와 제한 내용다른 작업 자료 재사용
출력 수집예상 종류, 경로, 크기 정책예상 밖 파일을 납품
의미 검증합계, 참조, 작업별 조건그럴듯하지만 잘못된 결과
게시명시적인 앱 권한생성 코드의 독자적 데이터 배포

허용된 테스트 환경에서 악의적인 코드 시험하기

인수 집합에는 제공 작업 공간 밖 읽기, 미승인 목적지 접속, 과도한 자원 소비 시도를 포함해야 합니다. 합성 데이터와 전용 환경을 사용해 시험 자체가 운영 자료를 노출하지 않게 하세요.

실제로 설정한 제어를 시험하세요. 인터넷 연결이 없는 다이어그램은 외부 접근 차단의 증거가 아닙니다. 접근 시도 결과와 환경이 반환한 이유를 수집해야 합니다.

Cloudflare의 샌드박스 보안 지침 은 환경 경계의 주요 기준입니다. 앱 제어도 인증, 작업 라우팅, 출력 게시를 포함해 별도 시험이 필요합니다.

일반적인 실패도 시험하세요. 의존성 가져오기 오류, 잘못된 CSV, 끝나지 않는 프로세스, 앱 정책보다 큰 출력 등이 있습니다. 운영자에게는 명확한 실패 분류와 안전하게 작업을 끝내거나 검사할 방법이 필요합니다.

제안 판단: 작업에 안전하고 유용한 결과인가요? 검증된 산출물과 실패 또는 예상 밖 결과를 구분하고 앱 경계를 통해 반환합니다.
제안 설계. 의도적으로 부여한 기능만 경계 안으로 들어갑니다. 전체 크기 다이어그램 보기

수명과 정리를 관찰 가능하게 만들기

작업 시작, 종료 이벤트, 이후 남을 것을 정의하세요. 실행 환경을 보관 결과 파일과 운영 증거에서 구분해야 합니다. 프로세스를 끝내도 다른 저장 서비스로 복사한 파일이 없어지는 것은 아닙니다.

작업 공간을 복원하거나 재사용한다면 어떤 작업 데이터가 다시 나타나는지 확립하세요. 편리한 영속 작업 공간도 라우팅이나 정리 가정이 틀리면 작업 간 데이터 문제를 일으킬 수 있습니다.

작업 책임자, 원본 목록, 실행 설정, 완료 이유, 수집 출력을 기록하세요. 작업과 합의한 검토 정책에 필요한 내용만 보관해야 합니다.

실패 작업 뒤의 취소와 정리를 연습하세요. 다음 작업이 이전 입력을 볼 수 없고, 모든 파일의 불필요한 사본을 남기지 않으면서도 앱이 실패를 설명할 수 있는지 확인해야 합니다.

통제된 실행 서비스 비용 추정하기

개발 비용에는 조율, 신원, 입력 준비, 실행 제어, 산출물 검증, 운영이 들어갑니다. 명령 한 번을 실행하는 코드보다 큰 범위입니다.

지원 작업 종류와 언어를 정의한 GBP 제안을 요청하세요. 회사 시스템에서 임의 프로그램을 돌리는 일반 도우미보다 제한된 CSV 변환 서비스가 더 명확한 첫 범위입니다.

반복 비용은 환경, 실행 시간, 저장, 모델 사용, 실패 처리에 따라 다릅니다. 해당 환경의 현재 플랫폼 요금을 확인하세요. 컨테이너 추정을 Dynamic Workers 설계에 가져오거나 유휴, 실패, 복원 작업이 무료라고 생각하면 안 됩니다.

파일럿은 유용한 산출물을 만들고 주변 경계를 증명해야 합니다. 정상 작업, 차단된 기능, 취소, 정리, 거부된 출력을 보여 주세요. 이 결과로 책임자는 다른 작업 유형을 안전하게 추가할 수 있는지 판단할 수 있습니다.

당사의 AI 통합 파일럿 으로 서비스 범위를 정할 수 있습니다. 입력 예시, 필수 도구, 별도 권한 없이 도우미가 절대 하면 안 되는 행동을 포함해 샌드박스 실행 제안 요청 을 보내 주세요.

자주 묻는 질문

샌드박스가 AI 생성 코드를 자동으로 안전하게 만드나요? 아닙니다. 격리는 유용한 경계지만 코드는 환경에 준 기능과 데이터를 쓸 수 있습니다. 파일, 자격 증명, 네트워크 접근, 자원 정책, 출력 처리를 정의하고 시험하세요.

생성 코드에 운영 API 키를 줘야 하나요? 넓은 서비스 권한은 피하세요. 접근을 검사할 수 있는 앱 계층에 자격 증명을 유지하고 필요한 제한 작업만 노출하세요. 선택 플랫폼이 지원하는 인증과 네트워크 제어를 검증해야 합니다.

모든 작업에 Linux 컨테이너가 필요한가요? 아닙니다. 언어, 의존성, 실행 요구로 환경을 선택하세요. Cloudflare는 서로 다른 방식을 설명하며 제한된 작업에는 좁은 실행 범위로 충분할 수 있습니다.

도우미가 만든 파일을 자동 게시해도 되나요? 별도 합의한 앱 정책이 있을 때만 가능합니다. 파일을 만드는 것과 배포하는 것은 다릅니다. 가져오기, 이메일, 공개 전에 출력과 게시 권한을 확인하세요.

격리 시험에는 무엇이 필요한가요? 전용 환경과 합성 데이터로 미인가 파일 접근, 미승인 네트워크, 과도한 자원 사용, 취소, 정리를 시험하세요. 구조도에 기대지 말고 실제 설정의 증거를 남겨야 합니다.

작업 사이에 공간을 재사용해도 되나요? 의도적인 격리와 보관 설계가 있을 때만 가능합니다. 재사용은 유용한 맥락을 남기지만 다른 작업의 데이터도 남길 수 있습니다. 의존하기 전에 라우팅, 복원 내용, 정리를 시험하세요.

구현 비용은 무엇으로 결정되나요? 지원 언어, 의존성 요구, 입력 준비, 기능 제어, 산출물 검증, 지원 요구가 작업량을 결정합니다. 제한된 업무부터 시작하고 실패 시험과 운영 인계가 포함된 GBP 제안을 요청하세요.