smolagents
행동을 파이썬 코드로 쓰게 하는 최소 에이전트 라이브러리
pip install "smolagents[toolkit]"허깅페이스가 만든 작은 에이전트 라이브러리입니다. 도구 호출을 JSON 대신 파이썬 코드로 쓰게 해 반복과 조합을 한 번에 표현합니다. 핵심 로직이 작아 프레임워크를 다 읽고 시작할 수 있습니다.
판단
이럴 때 씁니다
- 에이전트 프레임워크 내부 동작을 전부 읽고 시작하고 싶을 때
- 도구 호출을 JSON 대신 코드로 표현해 반복과 조합을 간단히 하고 싶을 때
- 허깅페이스 생태계의 모델과 도구를 그대로 붙이고 싶을 때
- 학습이나 실험용으로 가벼운 뼈대가 필요할 때
이럴 땐 쓰지 마세요
- 운영 환경에서 상태 관리와 재시도, 관측을 프레임워크가 맡아 주길 바랄 때
- 생성된 코드를 실행하는 방식이 보안 정책상 곤란할 때
- 벤더 공식 지원이 필요할 때
차별점
- 행동을 파이썬 코드로 표현해 반복과 조건, 조합을 한 번에 씁니다.
- 핵심 코드가 작아 프레임워크 전체를 읽고 시작할 수 있습니다.
- 허깅페이스 모델과 도구 생태계에 바로 붙습니다.
- 여러 프로바이더를 어댑터로 지원합니다.
워크플로
- 01pip install "smolagents[toolkit]" 로 기본 도구까지 함께 설치합니다.
- 02모델과 도구를 지정해 CodeAgent 를 만듭니다.
- 03작업을 실행하면 에이전트가 파이썬 코드를 써서 도구를 조합합니다.
- 04코드 실행은 샌드박스 환경에서 하도록 구성합니다.
주요 명령
| 명령 | 설명 |
|---|---|
pip install "smolagents[toolkit]" | 기본 도구 집합과 함께 설치합니다. |
함정
설치 전에 확인하세요
- 에이전트가 파이썬 코드를 만들어 실행합니다. 실행 환경을 격리하지 않으면 위험합니다.
- 최근 릴리스 간격이 이전보다 벌어졌습니다. 도입 전 저장소 활동을 확인하는 편이 좋습니다.
- 원격 WebAssembly 실행기가 제거되는 등 실행 환경 옵션이 정리되고 있습니다.
비교
OpenAI Agents SDK 가 핸드오프와 가드레일을 갖춘 운영 지향이라면, smolagents 는 최소 뼈대를 보여 주는 쪽입니다. 코드로 행동을 표현하는 접근은 도구를 여러 번 조합해야 하는 작업에서 유리하지만, 실행 격리를 직접 챙겨야 합니다.
최근 변경
v1.26.0 에서 WebSearchTool 의 검색 엔진 선택지에 Exa 가 추가됐고 원격 WebAssembly 실행기가 제거됐습니다. 이 릴리스는 2026-05-29 에 나왔고 그 뒤로는 태그 없이 저장소 커밋만 이어지고 있으므로, 도입 전 최신 커밋과 릴리스 계획을 함께 확인하는 편이 좋습니다.