agentic-radar

Tabla de contenidos

1. Descripción
2. Visualizador agéntico
3. Primeros pasos
   • Requisitos previos
   • Instalación
4. Instalación avanzada
   • Instalación de CrewAI
   • Instalación de OpenAI Agents
5. Uso
6. Funciones avanzadas
   • Endurecimiento de prompts agénticos
   • Prueba de vulnerabilidades en flujos de trabajo agénticos
   • Flujo de trabajo CI/CD
7. Hoja de ruta
8. Blogs y tutoriales
9. Comunidad
10. Preguntas frecuentes
11. Contribuir
12. Código de conducta
13. Licencia

Descripción 📝

Agentic Radar está diseñado para analizar y evaluar sistemas agénticos en busca de información sobre seguridad y operaciones. Ayuda a desarrolladores, investigadores y profesionales de la seguridad a comprender cómo funcionan los sistemas agénticos e identificar posibles vulnerabilidades.

Permite a los usuarios crear un informe de seguridad para sistemas agénticos, que incluye:

1. Visualización del flujo de trabajo - un grafo del flujo de trabajo del sistema agéntico✅
2. Identificación de herramientas - una lista de todas las herramientas externas y personalizadas utilizadas por el sistema✅
3. Detección de servidores MCP - una lista de todos los servidores MCP utilizados por los agentes del sistema✅
4. Mapeo de vulnerabilidades - una tabla que conecta las herramientas identificadas con vulnerabilidades conocidas, proporcionando una visión general de seguridad✅

El completo informe HTML resume todos los hallazgos y permite una fácil revisión y compartición.

Ver ejemplo de informe completo aquí

Agentic Radar incluye el mapeo de las vulnerabilidades detectadas a marcos de seguridad reconocidos 🛡️.

• OWASP Top 10 LLM Applications

• OWASP Agentic AI – Threats and Mitigations

Agentic Visualizer 🎆

Si solo te interesa la visualización, prueba el Agentic Visualizer.

Es una herramienta basada en web que te permite visualizar flujos de trabajo agénticos de forma intuitiva.

Primeros pasos 🚀

Requisitos previos

¡No hay ninguno! Solo asegúrate de tener Python (pip) instalado en tu máquina.

Instalación

pip install agentic-radar

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

Algunas funciones requieren instalaciones adicionales, dependiendo del framework agéntico objetivo. Ver más abajo.

Instalación avanzada

Instalación de CrewAI

Se necesitan los extras de CrewAI cuando se utiliza una de las siguientes funciones en combinación con CrewAI:

• Agentic Radar Test
• Descripciones para herramientas predefinidas

Puedes instalar Agentic Radar con las dependencias adicionales de CrewAI ejecutando:

pip install "agentic-radar[crewai]"

[!WARNING] Esto instalará el paquete crewai-tools, que solo es compatible con versiones de Python >= 3.10 y < 3.13. Si estás usando una versión diferente de Python, las descripciones de las herramientas serán menos detalladas o faltarán por completo.

Instalación de OpenAI Agents

Los extras de OpenAI Agents son necesarios cuando se utiliza una de las siguientes funciones en combinación con OpenAI Agents:

• Agentic Radar Test

Puedes instalar Agentic Radar con las dependencias adicionales de OpenAI Agents ejecutando:

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

Uso

Agentic Radar ahora admite dos comandos principales:

1. scan

Escanea el código en busca de flujos de trabajo agénticos y genera un informe.

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

Ejemplo:

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

2. test

Prueba agentes en un flujo de trabajo agéntico para diversas vulnerabilidades. Requiere que OPENAI_API_KEY esté configurada como variable de entorno.

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