코드 실행 - Cloosphere Guide

관리자 › 설정 › 코드 실행

AI 생성 코드의 실행 환경을 구성합니다.

이 페이지에서는 코드 실행 엔진(활성화 + Pyodide/Jupyter)을 설정하며, 이 엔진은 사용자 수동 실행과 에이전트의 코드 인터프리터(자동 실행)가 함께 사용합니다.

코드 실행 vs 코드 인터프리터

	코드 실행	코드 인터프리터
동작	AI가 생성한 코드 블록을 사용자가 수동 실행	AI가 자동으로 코드를 생성하고 실행
트리거	Python 코드 블록의 “실행” 버튼 클릭	AI가 데이터 분석이 필요하다고 판단 시
활성화 조건	이 설정만 켜면 됨	실행 엔진이 Jupyter + 데이터 분석 프로젝트 안에서 대화

채팅에서 AI가 생성한 코드 블록을 사용자가 직접 실행할 수 있는 기능입니다.

설정 항목	설명	기본값
코드 실행 활성화	코드 실행 기능 ON/OFF	활성화
실행 엔진	코드 실행 환경 선택	`pyodide`

브라우저 내에서 Python을 실행합니다. WebAssembly 기반으로 서버에 영향을 주지 않습니다.

Jupyter 서버에서 코드를 실행합니다. 서버 환경의 모든 패키지를 사용할 수 있습니다.

Jupyter 실행은 서버에서 임의의 코드를 실행하므로 심각한 보안 위험이 있습니다. 신뢰할 수 있는 환경에서만 사용하세요.

에이전트가 자동으로 코드를 생성·실행하여 데이터 분석, 차트 생성 등을 수행하는 기능입니다.

코드 인터프리터가 동작하려면 2가지 조건이 모두 충족되어야 합니다:

이 탭의 실행 엔진이 Jupyter 로 설정되어 있을 것 — 코드 인터프리터는 Jupyter 커널에서 실행되므로 Pyodide 로는 동작하지 않습니다
사용자가 데이터 분석 프로젝트 안에서 대화할 것

Jupyter 서버가 설정되어 있지 않으면 데이터 분석 프로젝트 생성 자체가 차단됩니다.

코드 인터프리터는 사용자가 켜고 끄는 토글이 아닙니다. 데이터 분석 프로젝트에서 AI가 분석이 필요하다고 판단하면 스스로 호출합니다. 에이전트 기능 설정에도 해당 항목이 없습니다.