에이전틱 워크플로를 위한 보안 스캐너!

데모 보기 · 문서 · 버그 신고 · 기능 요청

설명
Agentic Visualizer
시작하기
- 사전 요구사항
- 설치
고급 설치
- CrewAI 설치
- OpenAI Agents 설치
사용법
고급 기능
로드맵
블로그 및 튜토리얼
커뮤니티
자주 묻는 질문
기여하기
행동 강령
라이선스

설명 📝

Agentic Radar는 에이전틱 시스템을 보안 및 운영 인사이트 측면에서 분석하고 평가하도록 설계되었습니다. 개발자, 연구자, 보안 전문가가 에이전틱 시스템이 어떻게 작동하는지 이해하고 잠재적인 취약점을 식별하는 데 도움을 줍니다.

사용자가 에이전틱 시스템에 대한 보안 보고서를 생성할 수 있게 해주며, 다음을 포함합니다:

워크플로 시각화 - 에이전틱 시스템 워크플로의 그래프✅
도구 식별 - 시스템이 사용하는 모든 외부 및 커스텀 도구 목록✅
MCP 서버 탐지 - 시스템의 에이전트가 사용하는 모든 MCP 서버 목록✅
취약점 매핑 - 식별된 도구를 알려진 취약점과 연결하는 표로, 보안 개요를 제공합니다✅

포괄적인 HTML 보고서는 모든 결과를 요약하며, 쉽게 검토하고 공유할 수 있습니다.

전체 보고서 예시 보기

Agentic Radar는 탐지된 취약점을 잘 알려진 보안 프레임워크에 매핑하는 기능을 포함합니다 🛡️.

Agentic Visualizer 🎆

시각화에만 관심이 있다면 Agentic Visualizer를 사용해 보세요.

에이전틱 워크플로를 사용자 친화적인 방식으로 시각화할 수 있는 웹 기반 도구입니다.

시작하기 🚀

사전 요구사항

없습니다! 컴퓨터에 Python(pip)만 설치되어 있으면 됩니다.

설치

pip install agentic-radar

# Check that it is installed
agentic-radar --version

일부 기능은 대상 에이전틱 프레임워크에 따라 추가 설치가 필요합니다. 자세한 내용은 아래를 참조하세요.

고급 설치

CrewAI 설치

CrewAI와 함께 다음 기능 중 하나를 사용할 때 CrewAI 추가 패키지가 필요합니다:

Agentic Radar 테스트
사전 정의된 도구에 대한 설명

다음 명령으로 추가 CrewAI 의존성이 포함된 Agentic Radar를 설치할 수 있습니다:

pip install "agentic-radar[crewai]"

[!WARNING] 이렇게 하면 Python 버전 >= 3.10 및 < 3.13에서만 지원되는 crewai-tools 패키지가 설치됩니다. 다른 Python 버전을 사용하는 경우 도구 설명이 덜 상세해지거나 완전히 누락될 수 있습니다.

OpenAI Agents 설치

OpenAI Agents와 함께 다음 기능 중 하나를 사용할 때 OpenAI Agents 추가 패키지가 필요합니다:

Agentic Radar 테스트

다음 명령으로 추가 OpenAI Agents 의존성이 포함된 Agentic Radar를 설치할 수 있습니다:

pip install "agentic-radar[openai-agents]"

사용법

Agentic Radar는 이제 두 가지 주요 명령을 지원합니다:

1. `scan`

에이전틱 워크플로 코드를 스캔하고 보고서를 생성합니다.

agentic-radar scan [OPTIONS] FRAMEWORK:{langgraph|crewai|n8n|openai-agents|autogen}

예시:

agentic-radar scan langgraph -i path/to/langgraph/example/folder -o report.html

2. `test`

에이전틱 워크플로의 에이전트를 다양한 취약점에 대해 테스트합니다. OPENAI_API_KEY를 환경 변수로 설정해야 합니다.

agentic-radar test [OPTIONS] FRAMEWORK:{openai-agents} ENTRYPOINT_SCRIPT_WITH_ARGS

예시:

agentic-radar test openai-agents "path/to/openai-agents/example.py"

이 기능에 대한 자세한 내용은 여기를 참조하세요.

고급 기능 ✨

Agentic Prompt Hardening

Agentic Prompt Hardening은 에이전틱 워크플로에서 감지된 시스템 프롬프트를 자동으로 개선하여 보고서에 표시합니다. 단순한 에이전트 지침을 모범 프롬프트 엔지니어링 관행을 따르는 고품질의 구조화된 시스템 프롬프트로 변환합니다.

[!NOTE]
현재 지원되는 프레임워크(추후 더 추가 예정): OpenAI Agents, CrewAI, Autogen

사용법은 매우 간단합니다:

export OPENAI_API_KEY=<api_key>를 실행하여 OPENAI_API_KEY 환경 변수를 설정합니다.
--harden-prompts 플래그와 함께 Agentic Radar를 실행합니다. 예를 들어:

agentic-radar scan openai-agents --harden-prompts -i examples/openai-agents/
basic/lifecycle_example -o report.html

생성된 보고서에서 강화된 시스템 프롬프트를 확인합니다:

🔍 에이전틱 워크플로 취약점 테스트

Agentic Radar는 이제 시뮬레이션된 적대적 입력을 통해 에이전트 워크플로를 런타임에 테스트하여 중요한 취약점을 식별하는 기능을 지원합니다.

여기에는 다음에 대한 자동화된 테스트가 포함됩니다:

프롬프트 인젝션
PII 유출
유해 콘텐츠 생성
가짜 뉴스 생성

현재 지원 대상:

OpenAI Agents ✅ (더 많은 프레임워크가 곧 추가될 예정)

🛠 작동 방식

test 명령은 악의적이거나 적대적인 입력을 시뮬레이션하도록 설계된 테스트 스위트로 에이전틱 워크플로를 실행합니다. 이러한 테스트는 OWASP LLM Top 10에 부합하는 실제 공격 시나리오를 기반으로 설계되었습니다.

[!NOTE]
이 기능은 OPENAI_API_KEY 또는 AZURE_OPENAI_API_KEY를 환경 변수로 설정해야 합니다. 명령줄이나 .env 파일 내에서 설정할 수 있습니다.

테스트는 다음과 같이 실행합니다:

agentic-radar test <framework> "<path/to/the/workflow/main.py any-necessary-args>"

예를 들어:

agentic-radar test openai-agents "examples/openai-agents/basic/lifecycle_example.py"

이 도구는 사용자가 제공한 에이전틱 워크플로에 스스로를 주입하고 필요한 정보를 감지하여 준비된 테스트를 실행합니다.

agentic-radar

인기