agentic-radar

Содержание

1. Описание
2. Agentic Visualizer
3. Начало работы
   • Предварительные требования
   • Установка
4. Расширенная установка
   • Установка CrewAI
   • Установка OpenAI Agents
5. Использование
6. Расширенные возможности
   • Усиление промптов агентных систем
   • Тестирование на уязвимости в агентных рабочих процессах
   • CI/CD конвейер
7. Дорожная карта
8. Блоги и руководства
9. Сообщество
10. Часто задаваемые вопросы
11. Участие в разработке
12. Кодекс поведения
13. Лицензия

Описание 📝

Agentic Radar предназначен для анализа и оценки агентных систем с точки зрения безопасности и операционной эффективности. Он помогает разработчикам, исследователям и специалистам по безопасности понять, как работают агентные системы, и выявить потенциальные уязвимости.

Он позволяет пользователям создавать отчёт о безопасности для агентных систем, включая:

1. Визуализация рабочего процесса — граф рабочего процесса агентной системы✅
2. Идентификация инструментов — список всех внешних и пользовательских инструментов, используемых системой✅
3. Обнаружение MCP-серверов — список всех MCP-серверов, используемых агентами системы✅
4. Сопоставление уязвимостей — таблица, связывающая обнаруженные инструменты с известными уязвимостями, обеспечивающая обзор безопасности✅

Комплексный HTML-отчёт обобщает все результаты и позволяет легко просматривать результаты и делиться ими.

Посмотреть полный пример отчёта

Agentic Radar включает сопоставление обнаруженных уязвимостей с известными фреймворками безопасности 🛡️.

• OWASP Top 10 LLM Applications

• OWASP Agentic AI – Threats and Mitigations

Agentic Visualizer 🎆

Если вас интересует только визуализация, попробуйте Agentic Visualizer.

Это веб-инструмент, который позволяет визуализировать агентные рабочие процессы в удобном для пользователя виде.

Начало работы 🚀

Предварительные требования

Их нет! Просто убедитесь, что на вашей машине установлен Python (pip).

Установка

pip install agentic-radar

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

Некоторые функции требуют дополнительной установки в зависимости от целевого агентного фреймворка. Подробнее ниже.

Расширенная установка

Установка CrewAI

Дополнительные зависимости CrewAI необходимы при использовании одной из следующих функций в сочетании с CrewAI:

• Тест Agentic Radar
• Описания предопределённых инструментов

Вы можете установить Agentic Radar с дополнительными зависимостями CrewAI, выполнив:

pip install "agentic-radar[crewai]"

[!WARNING] Это установит пакет crewai-tools, который поддерживается только на версиях Python >= 3.10 и < 3.13. Если вы используете другую версию Python, описания инструментов будут менее подробными или полностью отсутствовать.

Установка OpenAI Agents

Дополнительные зависимости OpenAI Agents необходимы при использовании одной из следующих функций в сочетании с OpenAI Agents:

• Тест Agentic Radar

Вы можете установить Agentic Radar с дополнительными зависимостями OpenAI Agents, выполнив:

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"

Подробнее об этой функции здесь.