agentuniverse-ai/agentUniverse

agentUniverse is a LLM multi-agent framework that allows developers to easily build multi-agent applications.

agentUniverse – LLM 기반 다중 에이전트 애플리케이션을 위한 프레임워크

무엇인가요 – agentUniverse는 오픈소스 파이썬 라이브러리(≥ 3.10)로, 대규모 언어 모델(LLM) 기반의 지능형 에이전트와 에이전트 팀을 구성할 수 있게 해줍니다. 사전 정의된 협업 패턴(예: PEER – 계획/실행/표현/검토, DOE – 데이터 탐색/의견 삽입/표현)과 도구, 지식 기반, 메모리, 관찰성 확장을 위한 플러그인 스타일 아키텍처를 제공합니다. 이 프로젝트는 아ント 그룹의 실제 금융 서비스 활용 사례에서 비롯되었으며, PyPI에 패키지화되어 있습니다(v0.0.19, Apache-2.0).

핵심 개념

개념	제공하는 기능
에이전트	자체 프롬프트, 도구, 메모리, 그리고 선택적 도메인 지식을 갖춘 구성 가능한 LLM 기반 단위.
패턴(협업 모델)	여러 에이전트가 작업을 함께 수행하도록 사전 정의된 오케스트레이션(예: PEER는 문제를 계획 → 실행 → 표현 → 검토로 분할).
MCP 서버	HTTP를 통해 에이전트를 노출하는 경량 서비스로, 다른 서비스나 UI 구성 요소에서 호출 가능.
관찰성(Observability)	에이전트, LLM 호출, 도구 사용에 대한 트레이스/메트릭을 발행하는 내장된 OpenTelemetry 훅.
시각적 워크플로우 캔버스	`magent-ui` 패키지를 통해 드래그 앤 드롭으로 에이전트를 배치하고 연결하여 코드 없이 워크플로우를 구성할 수 있는 UI.

주요 기능(README에 기술됨)

다중 에이전트 협업 패턴 – PEER, DOE 및 사용자 정의 패턴을 정의할 수 있는 프레임워크.
광범위한 LLM 지원 – 간단한 설정으로 수십 개의 프로바이더 간 전환 가능(Qwen, DeepSeek, OpenAI, Claude, Gemini, Llama, Kimi, WenXin, ChatGLM, Baichuan, Doubao 등).
도메인 전문가 통합 – 프롬프트 템플릿, SOP, 지식 기반 훅을 통해 금융, 법무, 코드 생성 등 산업 전문 지식을 주입 가능.
확장 가능한 도구 – 임의의 파이썬 도구, RAG 파이프라인, 또는 외부 API를 에이전트에 연결 가능.
표준화된 관찰성 – 엔드투엔드 모니터링을 위한 OpenTelemetry 호환 트레이싱.
MCP 서버 – 에이전트를 마이크로서비스로 게시 가능하며, 외부 MCP 서버도 소비 가능.
시각적 캔버스 – magent-ui는 코드 없이 에이전트 워크플로우를 구축하고 실행할 수 있는 노코드 캔버스 제공.
문서 및 샘플 – 빠른 시작 가이드, 단계별 튜토리얼, 여러 완성된 예제 앱(법적 조언, 코드 실행, 금융 이벤트 분석 등).

일반적인 사용 사례

도메인	리포지토리 예시
금융 / 투자 리서치	분석가용 AI 어시스턴트 Zhi Xiao Zhu (PEER 기반 보고서 생성, ESG 분석).
법무	사용자 질의를 분석하고 구조화된 조언을 반환하는 법적 조언 에이전트.
소프트웨어 개발	파이썬 코드 생성 및 실행 에이전트로 코드를 작성하고 실행하여 결과를 반환.
번역 / 지식 전이	반사적 워크플로우 번역 에이전트(앤드류 닝의 데모 재현).
토론 / 브레인스토밍	다단계, 다중 에이전트 토론 그룹으로 전문가 패널을 시뮬레이션.

시작하기

# 라이브러리 설치
pip install agentUniverse

# (옵션) 시각적 UI 패키지 설치
pip install magent-ui ruamel.yaml

LLM 구성 – custom_key.toml에 프로바이더 키를 추가하고, 에이전트 설정에서 llm_model을 설정(예: default_deepseek_llm).
튜토리얼 실행 – docs/guidebook/en/Get_Start/2.Run_Your_First_Tutorial_Example.md를 따라 샘플 에이전트를 시작.
샘플 탐색 – examples/ 폴더에는 표준 프로젝트 템플릿과 완성된 앱이 포함되어 있음.
시각적 캔버스 실행 – examples/sample_apps/workflow_agent_app/bootstrap/platform 아래의 product_application.py를 실행.

문서 및 리소스

사용자 가이드 – docs/guidebook/en/Contents.md (설치, 에이전트 구축, 패턴, 관찰성 등)
API 참조 – https://agentuniverse.readthedocs.io/en/latest/ 에 호스팅
연구 논문 – PEER: Expertizing Domain-Specific Tasks with a Multi-Agent Framework and Tuning Methods (arXiv 2407.06985) – PEER 패턴의 검증에 사용된 논문.
커뮤니티 – GitHub Issues, Discord 채널, 공식 트위터 계정 @agentuniverse_ (소식 공지용).

라이선스 및 가용성

라이선스: Apache-2.0 (LICENSE 파일 참조)
패키지: PyPI(agentUniverse)에 게시, 소스 코드는 GitHub의 agentuniverse-ai 조직 아래에 있음.

빠른 평가

agentUniverse는 금융, 법무 등 도메인 전문 지식을 AI 어시스턴트에 통합해야 하는 기업을 위한 진정한 프로덕션 중심의 프레임워크입니다. 재사용 가능한 협업 패턴, 확장성, 관찰성에 중점을 두어, 단일 에이전트 챗봇을 넘어 협력적이고 작업 중심의 AI 워크플로우로 진화하고자 하는 개발자에게 안정적인 선택입니다.