agentic-radar

Índice

1. Descrição
2. Agentic Visualizer
3. Começando
   • Pré-requisitos
   • Instalação
4. Instalação Avançada
   • Instalação do CrewAI
   • Instalação do OpenAI Agents
5. Uso
6. Recursos Avançados
   • Agentic Prompt Hardening
   • Teste de Vulnerabilidades em Fluxos de Trabalho Agênticos
   • Fluxo de Trabalho CI/CD
7. Roadmap
8. Blogs e Tutoriais
9. Comunidade
10. Perguntas Frequentes
11. Contribuindo
12. Código de Conduta
13. Licença

Descrição 📝

O Agentic Radar é projetado para analisar e avaliar sistemas agênticos, fornecendo insights de segurança e operacionais. Ele ajuda desenvolvedores, pesquisadores e profissionais de segurança a entender como os sistemas agênticos funcionam e a identificar possíveis vulnerabilidades.

Ele permite que os usuários criem um relatório de segurança para sistemas agênticos, incluindo:

1. Visualização do Fluxo de Trabalho - um grafo do fluxo de trabalho do sistema agêntico✅
2. Identificação de Ferramentas - uma lista de todas as ferramentas externas e personalizadas utilizadas pelo sistema✅
3. Detecção de Servidores MCP - uma lista de todos os servidores MCP usados pelos agentes do sistema✅
4. Mapeamento de Vulnerabilidades - uma tabela conectando as ferramentas identificadas a vulnerabilidades conhecidas, fornecendo uma visão geral de segurança✅

O relatório HTML abrangente resume todas as descobertas e facilita a revisão e o compartilhamento.

Veja um Exemplo Completo do Relatório Aqui

O Agentic Radar inclui o mapeamento de vulnerabilidades detectadas para estruturas de segurança conhecidas 🛡️.

• Aplicações OWASP Top 10 para LLM

• OWASP Agentic AI – Ameaças e Mitigações

Agentic Visualizer 🎆

Se você se preocupa apenas com visualização, experimente o Agentic Visualizer.

É uma ferramenta baseada na web que permite visualizar fluxos de trabalho agênticos de forma amigável.

Começando 🚀

Pré-requisitos

Não há nenhum! Apenas certifique-se de ter o Python (pip) instalado na sua máquina.

Instalação

pip install agentic-radar

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

Alguns recursos exigem instalações adicionais, dependendo da estrutura agêntica alvo. Veja mais abaixo.

Instalação Avançada

Instalação do CrewAI

Os extras do CrewAI são necessários ao usar um dos seguintes recursos em combinação com o CrewAI:

• Teste do Agentic Radar
• Descrições para ferramentas predefinidas

Você pode instalar o Agentic Radar com dependências extras do CrewAI executando:

pip install "agentic-radar[crewai]"

[!WARNING] Isso instalará o pacote crewai-tools, que só é suportado nas versões Python >= 3.10 e < 3.13. Se você estiver usando uma versão diferente do Python, as descrições das ferramentas serão menos detalhadas ou totalmente ausentes.

Instalação do OpenAI Agents

Os extras do OpenAI Agents são necessários ao usar um dos seguintes recursos em combinação com o OpenAI Agents:

• Teste do Agentic Radar

Você pode instalar o Agentic Radar com dependências extras do OpenAI Agents executando:

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

Uso

O Agentic Radar agora suporta dois comandos principais:

1. scan

Escaneie o código em busca de fluxos de trabalho agênticos e gere um relatório.

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

Exemplo:

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

---

2. test

Teste agentes em um fluxo de trabalho agêntico em busca de várias vulnerabilidades. Requer OPENAI_API_KEY definida como variável de ambiente.

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

Exemplo:

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