Justin0504/Aegis

어떤 프로젝트인가요?

핵심 기능

• 01도구 주석 없이도 정책을 평가하기 전에 각 도구 호출을 종류별로 분류합니다.
• 02위험도가 높은 호출은 실행 전에 Cockpit에서 사람의 승인을 받도록 보류합니다.
• 03SQL 인젝션, 파일 접근, 네트워크 접근, 프롬프트 인젝션에 대한 기본 정책을 제공합니다.
• 04결정을 더 엄격하게만 적용할 수 있는 테넌트별 YAML 정책 DSL을 지원합니다.
• 05추적 기록을 해시 체인 방식의 감사 로그에 저장하며, Ed25519 서명을 선택적으로 적용할 수 있습니다.
• 06Python, TypeScript, Go SDK와 HTTP 프록시, MCP 프록시를 통해 사용할 수 있습니다.

활용 사례

• SQL, 셸 명령 또는 파일 작업을 실행할 수 있는 에이전트에 안전장치를 추가합니다.
• 에이전트가 패키지를 게시하거나 Kubernetes에 배포하기 전에 사람의 승인을 요구합니다.
• 변조 여부를 확인할 수 있는 로그를 통해 컴플라이언스 검토용으로 에이전트 동작을 감사할 수 있습니다.
• LLM 및 MCP 트래픽을 프록시로 라우팅해 비공개 소스 또는 컴파일된 에이전트를 제어합니다.

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone https://github.com/Justin0504/Aegis
2. 2

   프로젝트 디렉터리로 이동합니다

   cd Aegis
3. 3

   Docker Compose로 서비스를 시작합니다

   docker compose up -d
4. 4

   한 번 가져오기(import)하여 Python 에이전트에서 AEGIS를 활성화합니다

   python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"

사용 전 알아둘 점

• !데스크톱 앱 다운로드는 현재 Apple Silicon을 탑재한 macOS만 지원하며, Windows는 아직 지원되지 않습니다(WSL2 사용을 권장합니다).
• !수동 설정에는 Docker가 필요하며 여러 서비스를 로컬에서 실행해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

Aegis은(는) 무엇인가요?

AI 에이전트의 도구 호출을 실행 전에 가로채 분류하고 차단하며, 승인 절차와 변조 여부를 확인할 수 있는 감사 추적을 제공하는 런타임 방화벽입니다. AEGIS는 AI 에이전트와 에이전트가 호출하는 도구 사이에서 동작합니다. 각 도구 호출은 종류(데이터베이스, 파일, 네트워크, 셸, 프롬프트 인젝션, 공급망)에 따라 분류되고, 정책 및 이상 징후 기준과 대조한 뒤 실행 전에 허용되거나 사람의 승인을 위해 보류되거나 차단됩니다. 이 프로젝트는 에이전트가 생성하는 파괴적인 SQL, 예상치 못한 데이터 유출, 환각으로 만들어 낸 셸 명령 같은 상황을 대상으로 합니다.

Aegis은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

Aegis은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

Aegis은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. Aegis의 마지막 커밋은 2026년 10월 31일입니다.

Aegis은(는) 어디에 사용할 수 있나요?

SQL, 셸 명령 또는 파일 작업을 실행할 수 있는 에이전트에 안전장치를 추가합니다. 에이전트가 패키지를 게시하거나 Kubernetes에 배포하기 전에 사람의 승인을 요구합니다. 변조 여부를 확인할 수 있는 로그를 통해 컴플라이언스 검토용으로 에이전트 동작을 감사할 수 있습니다. LLM 및 MCP 트래픽을 프록시로 라우팅해 비공개 소스 또는 컴파일된 에이전트를 제어합니다.

Aegis는 어떻게 설치하나요?

리포지토리를 클론합니다: git clone https://github.com/Justin0504/Aegis 프로젝트 디렉터리로 이동합니다: cd Aegis Docker Compose로 서비스를 시작합니다: docker compose up -d 한 번 가져오기(import)하여 Python 에이전트에서 AEGIS를 활성화합니다: python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"

Aegis은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Justin0504/Aegis