Molayo

© 2026 Molayo

GitHub요약2026. 06. 09. 20:06

atid-college/q-ace-agentic-framework

요약

Q-ACE는 FastAPI와 최신 LLM Provider를 활용하여 구축된 모듈형 AI 에이전트 엔진입니다. 이 프레임워크는 QA 작업을 자동화하며, 브라우저, 데이터베이스, REST API 등 다양한 환경에 특화된 지능형 에이전트를 제공합니다. 또한, 여러 주요 LLM(Gemini, OpenAI, Ollama 등)을 지원하고 통합적인 툴 오케스트레이션을 가능하게 합니다.

핵심 포인트

  • QA 작업을 위한 모듈형 AI 에이전트 엔진입니다.
  • 브라우저, DB, API 등 다양한 환경에 특화된 에이전트를 제공합니다.
  • Gemini, OpenAI, Ollama 등 다중 LLM Provider를 지원합니다.
  • FastAPI 기반으로 구축되어 확장성이 높습니다.

FastAPI와 최신 LLM Provider를 사용하여 구축된 품질 보증(QA) 작업을 위한 모듈형 AI 에이전트 엔진입니다. Q-ACE는 표준 QA 도구를 분석, 검증 및 자동 오케스트레이션을 수행할 수 있는 지능형 에이전트로 변환합니다.

모듈식 아키텍처 (Modular Architecture): core를 통한 오케스트레이션, 툴 로직을 위한 handlers, LLM을 위한 providers, 저수준 실행을 위한 tools 간의 명확한 분리가 이루어집니다.역할 기반 접근 제어 (Role-Based Access Control, RBAC): admin과 tester 역할을 가진 보안 로그인 시스템으로, 특정 툴 및 분석에 대한 권한을 관리합니다.AI 기반 에이전트 (AI-Powered Agents):

  • Browser Agent: 실시간 피드백 및 AI 분석 기능을 갖춘 고수준 웹 자동화 기능입니다.
  • Database Agent: 자연어 쿼리 실행과 결과의 AI 검증을 제공합니다.
  • REST API Agent: 자연어 프롬프트를 사용하여 데이터를 가져오고, 생성하고, 편집하며, 검증하는 REST 엔드포인트와의 지능형 상호작용을 수행합니다.
  • Test Generator Agent: 고급 테스트 기법을 사용하여 명세로부터 포괄적인 테스트 케이스(기능성, 보안 등)를 자동 생성합니다.
  • Mobile Agent: Appium을 통한 AI 기반 Android/iOS 장치 자동화로, 자연어 작업 실행, 실시간 UI 계층 파싱, 지속적인 실행 기록 유지가 가능합니다.

확장된 툴 통합 (Extended Tool Integration) (구현 예정):

  • Jenkins, GitHub Actions, Jira, Slack, Qase, Postman, GitHub에 대한 내장 플레이스홀더가 제공됩니다.
  • LLM Provider 전환 기능: Google Gemini, 로컬 Ollama, OpenAI, Anthropic, DeepSeek 등 다양한 LLM을 지원합니다.
  • 통합 Ollama 관리: 인터페이스에서 로컬 Ollama 서버(시작/중지/상태)를 직접 관리할 수 있습니다.
  • 현대적인 UI (Modern UI): 프리미엄하고 반응성이 뛰어난 채팅 기반 오케스트레이션 허브입니다.

core/: 오케스트레이터, 컨텍스트 관리, 툴 레지스트리, 인증 유틸리티 및 LLM 클라이언트가 포함됩니다. handlers/: 툴(SQLite, API, Spec Analyzer, Browser 등)의 로직 계층을 담당합니다. providers/: LLM Provider 구현체(Gemini, Ollama)를 제공합니다. tools/: 저수준 실행 플러그인을 담고 있습니다. static/

Modern HTML/JS 프론트엔드(Alpine.js, TailwindCSS)를 사용합니다. data/: SQLite 데이터베이스(q-ace.db), 테스트 사양, 브라우저 에이전트 문서/히스토리, 그리고 모바일 에이전트 문서/히스토리가 포함되어 있습니다. main.py: FastAPI 애플리케이션 진입점입니다.

  • Python 3.9 이상
  • Ollama (로컬 LLM 지원용)
  • Google API Key (Gemini 지원용)

먼저, 저장소를 클론하고 해당 디렉터리로 이동합니다:

git clone https://github.com/atid-college/q-ace-framework.git
cd q-ace-framework

그런 다음, 제공된 설치 스크립트를 실행하기만 하면 됩니다. 이 스크립트는 가상 환경(특화된 브라우저 에이전트의 .venv 포함), 종속성 및 데이터베이스 초기화를 처리합니다:

Windows:

win-install.bat

MacOS / Linux:

chmod +x mac-install.sh
./mac-install.sh

다음부터는 실행 스크립트를 사용하여 프레임워크를 실행하기만 하면 됩니다:

Windows:

win-run.bat

MacOS / Linux:

chmod +x mac-run.sh
./mac-run.sh

브라우저에서 http://localhost:8090을 엽니다.

  • 브라우저 에이전트 가이드: 설정, 구성 및 자동화 기능.
  • 데이터베이스 에이전트 가이드: Text-to-SQL, 샘플 데이터베이스 및 검증.
  • REST API 에이전트 가이드: 자연어 API 상호작용 및 분석.
  • 테스트 생성기 에이전트 가이드: 사양 분석 및 테스트 케이스 생성.
  • 모바일 에이전트 가이드: Appium 설정, 장치 구성, AI 기반 모바일 자동화 및 히스토리 분석.

이 프레임워크는 JWT 기반 인증을 사용합니다. 설치 프로그램은 초기 데이터베이스를 자동으로 설정합니다.

초기 자격 증명:

사용자 이름:admin

비밀번호:admin123

중요

첫 로그인 후에는 비밀번호를 변경하는 것이 강력히 권장됩니다. 이는 대시보드의 사용자 관리(User Management) 섹션에서 수행할 수 있습니다.

관리자(Admin): 모든 도구 및 관리 분석에 대한 전체 접근 권한.
테스터(Tester): 할당된 도구(예: API, SQLite)로 제한된 접근 권한.

핸들러(Handlers)는 도구의 고수준 로직과 UI 정의를 관리합니다. handlers/ 디렉터리에 있는 BaseHandler를 상속받아 새 파일을 생성하십시오.

Tools는 실행 계층(execution layer)을 제공합니다 (예: 실제 HTTP 요청 수행). tools/ 디렉터리에 있는 BaseTool을 상속받아 새 파일을 생성하십시오.

from core.base_tool import BaseTool
class CustomTool(BaseTool):
@property
...

기여를 환영합니다! 시작하려면 기여 가이드(Contributing Guide)를 참조해 주십시오. 모든 참여자는 행동 강령(Code of Conduct)을 준수해야 합니다.

ATID College가 애정을 담아 제작했습니다 ❤️

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0