3가지 실행 모드와 10개의 프로덕션 플러그인을 갖춘 에이전트 프레임워크 - NucleusIQ v0.6.0

실용적 조언

간단한 Q&A 작업에는 DIRECT 모드를 사용하여 지연 시간과 비용을 최소화하라.
민감한 데이터를 다루는 경우 내장된 PII 가드 플러그인을 활성화하여 보안을 강화하라.
@tool 데코레이터를 사용하여 기존 Python 함수를 수정 없이 에이전트 도구로 재사용하라.

섹션별 상세

NucleusIQ는 'Gearbox Strategy'를 통해 세 가지 실행 모드를 제공한다. DIRECT 모드는 단일 LLM 호출로 최대 5개의 도구를 사용하며, STANDARD는 도구 루프를 통해 30개까지, AUTONOMOUS는 계획과 비평 과정을 거쳐 100개까지 도구 호출이 가능하다. 사용자는 설정 파일의 모드 변경만으로 동일한 에이전트 로직을 다양한 복잡도의 작업에 재사용할 수 있다. 이는 개발자가 작업 특성에 맞춰 추론 비용과 정확도 사이의 균형을 쉽게 조절할 수 있게 한다.

이 프레임워크는 기존의 복잡한 체인이나 그래프 아키텍처를 배제하고 SOLID 설계 원칙을 최우선으로 한다. 에이전트는 클래스로, 도구는 함수로, 설정은 데이터 클래스로 정의되어 Python 개발자에게 익숙한 구조를 제공한다. 모든 데이터 처리에 Pydantic 모델을 사용하여 타입 안정성을 확보하고 'God Class'를 방지하는 단일 책임 원칙(SRP)을 적용했다. 이러한 설계는 프레임워크의 내부 작동 방식을 투명하게 유지하여 디버깅과 확장을 용이하게 만든다.

v0.6.0 버전에서는 실무 적용을 위한 10가지 핵심 플러그인과 다중 모델 지원이 강화됐다. PII 가드와 인간 승인 워크플로우를 통해 보안 및 제어 기능을 제공하며, 호출당 비용 추정 기능으로 운영 비용 모니터링이 가능하다. Google Gemini 프로바이더가 추가되어 코드 한 줄로 OpenAI와 Gemini 간의 전환이 가능해졌다. 2,323개의 테스트를 통과한 안정성을 바탕으로 재시도 및 폴백 메커니즘을 프레임워크 수준에서 지원한다.

python

@tool
def calculate(expression: str) -> float:
    """Evaluate a math expression."""
    return eval(expression)

@tool 데코레이터를 사용하여 일반 Python 함수를 에이전트가 인식할 수 있는 도구로 변환하는 예시

용어 해설

SOLID 원칙(SOLID Principles): — 객체 지향 설계의 다섯 가지 핵심 원칙으로, 소프트웨어의 유지보수성과 확장성을 높이기 위한 지침이다. NucleusIQ는 이 원칙을 준수하여 복잡한 추상화 대신 명확한 클래스 구조와 단일 책임 원칙을 강조한다.
개인정보 보호 가드(PII Guard): — 개인 식별 정보(Personally Identifiable Information)가 LLM으로 전송되거나 출력되는 것을 탐지하고 차단하는 보안 기능이다. 기업용 에이전트 구축 시 데이터 유출 방지를 위해 필수적으로 요구되는 안전 장치이다.
실행 모드(Execution Mode): — 에이전트가 작업을 수행하는 전략적 단계를 의미한다. NucleusIQ는 작업의 복잡도에 따라 단일 호출부터 복잡한 계획 및 비평 루프까지 세 가지 단계를 제공하여 자원 효율성을 최적화한다.
데이터 클래스(Dataclass): — Python에서 데이터를 저장하기 위해 설계된 특수 클래스로, 보일러플레이트 코드를 줄이고 데이터 구조를 명확히 정의한다. NucleusIQ에서는 에이전트 설정을 관리하는 핵심 구조로 사용된다.

언급된 도구

NucleusIQ추천링크

Python 기반 오픈소스 에이전트 프레임워크

Gemini중립

LLM 프로바이더 지원

언급된 리소스

GitHubNucleusIQ GitHub Repository

문서NucleusIQ Documentation

API DocsNucleusIQ on PyPI