간단한 챗봇부터 멀티 에이전트 시스템까지, 생성형 AI 에이전트 기법을 다루는 실행 가능한 Jupyter Notebook 튜토리얼 50개 이상을 모았습니다.
cuga-project/cuga-agent
비즈니스 요청을 앱, API, 문서 전반의 작업으로 전환하고 정책 제어와 프라이빗 배포 옵션을 제공하는 엔터프라이즈 에이전트 프레임워크입니다.
- 스타
- 1,137
- 포크
- 208
- 열린 이슈
- 244
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
CUGA는 엔터프라이즈 자동화를 위한 오픈소스 범용 에이전트 프레임워크입니다. 웹 인터페이스, API, 문서에 걸친 여러 단계의 작업을 수행하며, MCP 서버, OpenAPI 서비스, Python 함수로 도구를 연결합니다. 팀은 브라우저 기반 관리 UI에서 에이전트와 슈퍼바이저를 구성하고, 초안을 테스트한 뒤 버전을 게시할 수 있습니다.
이 프로젝트는 제어 기능에 중점을 둡니다. 실행 정책으로 허용되지 않은 의도를 차단하고, 선택한 도구 사용에 사람의 승인을 요구하며, 플레이북으로 워크플로를 안내하고, 도구 호출 전에 도구 수준의 보호 규칙을 적용할 수 있습니다. OpenAI 호환 프라이빗 추론 엔드포인트, Helm chart를 통한 Kubernetes 배포, 지원 모델이 미리 포함된 에어갭 이미지를 지원합니다. 선택 구성 요소를 추가하면 예약 실행과 웹훅 트리거 실행을 위한 별도 이벤트 서비스와 작업 지침을 재사용하는 Evolve 기반 메모리를 사용할 수 있습니다.
개발자는 CLI 또는 CugaAgent 및 CugaSupervisor 클래스를 사용하는 Python SDK로 CUGA를 이용할 수 있습니다. Python 3.12와 LangGraph를 기반으로 합니다.
핵심 기능
- 01MCP 서버, OpenAPI 서비스, Python 함수를 통해 도구 연결
- 02다섯 가지 정책 유형 제공: Intent Guard, Playbook, Tool Approval, Tool Guide, Output Formatter
- 03ToolGuard가 실행 전에 도구 호출을 검사하고 위반 사항을 차단
- 04OpenAI 호환 프라이빗 추론 엔드포인트 및 에어갭 배포 지원
- 05CugaSupervisor를 통한 멀티 에이전트 협업
- 06실행 기록에 토큰 사용량, 모델 호출, 도구 호출, 경과 시간 표시
활용 사례
- 계정 업데이트에 승인 절차를 적용해 CRM 및 매출 운영 자동화
- 출처를 인용해 사내 문서에 관한 질문에 답변
- 여러 애플리케이션에 걸친 워크플로에서 전문 에이전트 협업
- 프라이빗 클라우드 또는 에어갭 Kubernetes 환경에서 에이전트 실행
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/cuga-project/cuga-agent.git - 2
프로젝트 디렉터리로 이동합니다
cd cuga-agent - 3
Python 3.12에서 uv로 종속 항목을 설치합니다
uv sync --python 3.12 - 4
CRM 도구와 함께 매니저를 시작합니다
uv run cuga start manager --crm
사용 전 알아둘 점
- 에이전트를 실행하기 전에 .env에서 모델 제공자와 인증 정보를 설정해야 합니다.
- 정책, 메모리, 이벤트의 모든 기능을 사용하려면 선택적 서비스와 추가 구성이 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- cuga-agent은(는) 무엇인가요?
- 비즈니스 요청을 앱, API, 문서 전반의 작업으로 전환하고 정책 제어와 프라이빗 배포 옵션을 제공하는 엔터프라이즈 에이전트 프레임워크입니다. CUGA는 엔터프라이즈 자동화를 위한 오픈소스 범용 에이전트 프레임워크입니다. 웹 인터페이스, API, 문서에 걸친 여러 단계의 작업을 수행하며, MCP 서버, OpenAPI 서비스, Python 함수로 도구를 연결합니다. 팀은 브라우저 기반 관리 UI에서 에이전트와 슈퍼바이저를 구성하고, 초안을 테스트한 뒤 버전을 게시할 수 있습니다.
- cuga-agent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- cuga-agent은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- cuga-agent은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. cuga-agent의 마지막 커밋은 2026년 11월 5일입니다.
- cuga-agent은(는) 어디에 사용할 수 있나요?
- 계정 업데이트에 승인 절차를 적용해 CRM 및 매출 운영 자동화 출처를 인용해 사내 문서에 관한 질문에 답변 여러 애플리케이션에 걸친 워크플로에서 전문 에이전트 협업 프라이빗 클라우드 또는 에어갭 Kubernetes 환경에서 에이전트 실행
- cuga-agent는 어떻게 설치하나요?
- 저장소를 클론합니다: git clone https://github.com/cuga-project/cuga-agent.git 프로젝트 디렉터리로 이동합니다: cd cuga-agent Python 3.12에서 uv로 종속 항목을 설치합니다: uv sync --python 3.12 CRM 도구와 함께 매니저를 시작합니다: uv run cuga start manager --crm
- cuga-agent은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cuga-project/cuga-agent
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
LangGraph 기반으로 35가지 에이전트 AI 아키텍처를 구현한 Python 라이브러리이자 실행 가능한 Jupyter 교재입니다.
Codex와 Claude Code 같은 코딩 에이전트를 감싸고, 각각 별도 모델을 사용하는 선택형 감독자·리뷰어·적대자·로컬 로그 요약기를 제공하는 Python CLI입니다.
여러 머신과 도구에서 실행되는 AI 코딩 에이전트가 한곳에서 스레드, 파일, 브라우저를 공유하는 워크스페이스입니다.
전문 분야에 따라 에이전트끼리 제어를 넘기는 LangGraph 기반 스웜 스타일 멀티 에이전트 시스템을 구축하는 Python 라이브러리입니다.