ufy2024/AuC

해결하는 문제

AuC (Agents-ufy-Core)는 높은 엔지니어링 규율을 갖춘 자율 에이전트를 구축하도록 설계된 Python 기반 싱글 에이전트 프레임워크입니다. 로컬 파일, 셸 및 외부 API와 상호 작용하면서 고위험 작업에 대해 엄격한 제어를 유지할 수 있는 안전하고 관찰 가능하며 진화 가능한 AI 에이전트의 필요성을 해결합니다.

작동 방식

이 프레임워크는 asyncio를 기반으로 구축되었으며 스트리밍 추론 및 병렬 도구 호출을 위한 ReAct (Reasoning and Acting) 루프를 구현합니다. 보안을 보장하기 위해 계층화된 도구 권한 시스템(L1 읽기 전용, L2 샌드박스 쓰기, L3 2차 승인)을 제공합니다. 고위험 명령은 자동으로 L3로 업그레이드되어 Telegram, QQ 또는 Web UI와 같은 통합 플랫폼을 통한 수동 승인이 필요합니다.

주요 기술 구성 요소는 다음과 같습니다:

• Au-Context Slicer: 시맨틱 슬라이싱을 통해 컨텍스트 윈도우 효율성을 관리합니다.
• Au-Rules Matrix: .aurules 파일을 통해 프로젝트별 규칙을 구현합니다.
• Checkpointing: 사용자가 파일 변경 또는 명령 실행을 취소할 수 있도록 합니다.
• Evolution Memory: .auc/evolution.yaml을 사용하여 경험을 회상하고 지식의 "골드 너겟"을 고착화합니다.
• Sandbox: 파일 I/O, 셸 실행 및 SSRF 보호가 포함된 URL 가져오기를 위한 격리된 환경을 제공합니다.

대상 사용자

안전 우선 접근 방식으로 코드베이스를 자율적으로 관리하거나 시스템 작업을 수행할 수 있는 에이전트를 구축하고자 하는 개발자 및 AI 엔지니어, 그리고 제어된 에이전트 워크플로우를 통해 LLM과 상호 작용하기 위한 즉시 사용 가능한 CLI 또는 Web UI를 원하는 사용자.

주요 특징

• 계층화된 권한: 우발적이거나 악의적인 시스템 변경을 방지하기 위한 L1/L2/L3 승인 수준.
• 멀티 모델 지원: OpenAI, Anthropic 및 DeepSeek와의 네이티브 통합.
• 멀티 채널 승인: Telegram, QQ 또는 Web UI로 전송되는 2차 승인 요청.
• 진화하는 메모리: 에이전트가 자신의 실행으로부터 학습하고 시간이 지남에 따라 동작을 개선하기 위한 메커니즘.
• 포괄적인 UI: 전문적인 터미널 REPL과 워크스페이스 관리가 가능한 FastAPI 기반 Web UI를 모두 포함합니다.
• 안전 우선 설계: 내장된 SSRF 보호, 경로 샌드박싱 및 Docker 격리 지원.