Python 실행기 (Runner)
Python 실행기 (Runner)
파이썬 실행기(Python executor)는 코드 에이전트가 생성한 코드를 통제된 환경에서 실행하는 역할을 해요. 에이전트는 작업을 완수하기 위해 파이썬 코드를 동적으로 생성·실행하므로, 올바른 실행기를 고르는 일은 기능과 보안 양쪽에서 아주 중요해요.
코드 실행과 그 위험에 대해 더 배우려면 보안 코드 실행 튜토리얼을 꼭 읽어보세요. 이 페이지는 밑단 클래스들의 API 문서를 다뤄요. 기본 PythonExecutor 인터페이스와 사용 가능한 모든 실행기 구현체들이 여기에 있어요.
Python 실행기
smolagents.local_python_executor.PythonExecutor — 모든 실행기의 기본 인터페이스예요.
로컬 Python 실행기
smolagents.local_python_executor.LocalPythonExecutor — smolagents가 처음부터 더 안전하게 다시 만든 로컬 파이썬 실행기예요. 기본 파이썬 인터프리터 대신 AST(Abstract Syntax Tree)를 로드해 연산 단위로 실행하며 여러 안전 규칙을 따라요.
원격 Python 실행기
smolagents.remote_executors.RemotePythonExecutor — 원격 샌드박스에서 코드를 실행하는 실행기의 기반 클래스예요. 원격 실행은 코드 에이전트를 완전한 보안 격리 환경에서 돌릴 수 있게 해주죠.
BlaxelExecutor
smolagents.remote_executors.BlaxelExecutor — Blaxel 샌드박스에서 코드를 실행해요. 빠르게 뜨는 VM(25ms 미만)을 제공해 빠르고 안전한 코드 실행이 필요한 에이전트 애플리케이션에 좋아요.
E2BExecutor
smolagents.remote_executors.E2BExecutor — E2B 샌드박스에서 코드를 실행해요.
ModalExecutor
smolagents.remote_executors.ModalExecutor — Modal 샌드박스에서 코드를 실행해요.
DockerExecutor
smolagents.remote_executors.DockerExecutor — Docker 컨테이너에서 코드를 실행해요.
출처 인용
- 원문: smolagents - Python code executors (reference, Hugging Face Docs)
- 원본 파일: huggingface/smolagents - docs/source/en/reference/python_executors.md