CircuitManus: Python 기반 범용 에이전트 플랫폼 84

CircuitManus란 무엇인가요?

CircuitManus는 Python으로 개발된 플랫폼으로, 주로 회로 설계에 사용되지만 다른 분야로도 확장할 수 있습니다. 대규모 언어 모델과 다양한 도구를 결합하여 복잡한 작업을 자동화하는 데 도움이 됩니다. 이 플랫폼은 인식, 계획, 행동, 관찰, 응답 등의 단계를 포함하는 고전적인 모델을 기반으로 하며, 뛰어난 내결함성 및 자체 수정 기능을 갖추고 있습니다. 또한 FastAPI WebSocket 서버와 현대적인 웹 인터페이스를 갖추고 있어 백엔드와 프론트엔드가 실시간으로 상호작용할 수 있으며, Windows 환경에서 최적화되었습니다.

CircuitManus 핵심 기능

• 범용 에이전트 아키텍처: 인식 -> 계획 -> 행동 -> 관찰 -> 응답 생성의 고전적인 에이전트 루프 모델을 따르며, 강력한 내결함성 및 자체 수정 기능을 갖추고 있습니다. 대규모 언어 모델(LLM)과 확장 가능한 도구 세트를 통합하여 다양한 복잡한 작업을 지원하고 자동화할 수 있습니다.

• 회로 설계 도구 세트: 첫 번째 도구 세트는 회로 설계 분야에 중점을 두며, 부품 추가, 부품 연결, 회로 설명, 회로 비우기 등 11개의 도구를 포함하고 있어 자연어 명령을 통해 회로 설계 관련 작업을 수행할 수 있습니다.

• 실시간 상호작용 웹 인터페이스: FastAPI WebSocket 서버와 현대적인 웹 UI를 통합하여 완전한 지능형 상호작용 경험을 제공하며, 실시간 상호작용, 세션 관리, 동적 상태 표시 등의 기능을 지원합니다.

• 지능형 계획 및 재계획: LLM을 활용하여 복잡한 명령을 이해하고 구조화된 JSON 계획을 생성하며, 도구 실행 실패 시 자동으로 재계획하여 작업 성공률을 높입니다.

• 정확한 도구 실행 및 내결함성: 동적 도구 등록, 비동기 도구 실행, 도구 수준 재시도 및 실패 중단을 지원하여 시스템의 안정성과 신뢰성을 보장합니다.

• 상태 및 메모리 관리: 계층적 메모리 시스템을 채택하여 단기 대화 기록, 장기 지식 조각을 관리하며, 회로 인스턴스와 같은 특정 영역의 상태 객체를 보유할 수 있습니다.

• 엔지니어링 실무의 장점: Pythonic 비동기 코어, 높은 모듈성 설계, 상세한 등급별 로그 등의 엔지니어링 사례를 채택하여 코드의 유지보수성과 확장성을 향상시킵니다.

CircuitManus 기술 아키텍처

• 백엔드: Python 3.8+ 기반, FastAPI를 사용하여 WebSocket 서버를 구축하고, 智谱ai의 glm-z1-flash 모델을 통합하여 LLM 상호작용을 수행하며, asyncio를 사용하여 비동기 처리를 구현합니다.

• 프론트엔드: HTML5, CSS3 및 기본 JavaScript를 사용하여 현대적인 웹 UI를 구축하고, 실시간 상호작용 및 동적 상태 표시를 제공합니다.

• 도구 세트: 도구는 기능 영역별로 분리되어 새로운 영역의 도구를 쉽게 확장할 수 있으며, 현재 회로 작업 및 네트워크 검색이라는 두 가지 범주의 도구를 포함하고 있습니다.

• 메모리 관리: 계층적 메모리 시스템으로 대화 기록 및 영역별 상태를 관리하며, 영역에 구애받지 않는 핵심 오케스트레이션 로직을 지원합니다.

CircuitManus 배포 단계

1. 저장소 복제

git clone https://github.com/singularguy/CircuitManus
cd IDT_AGENT_NATIVE

2. 가상 환경 생성 및 활성화

python -m venv venv
.\venv\Scripts\activate

3. 의존성 설치

pip install -r requirements.txt

4. API 키 구성

智谱 AI API 키를 .env 파일에 추가하세요:

ZHIPUAI_API_KEY="YOUR_ZHIPU_API_KEY"

프로젝트 링크

https://github.com/singularguy/CircuitManus