Agentic Radar

查看演示 · 文档 · 报告 Bug · 功能请求

---

目录

• 描述
• Agentic 可视化工具
• 快速入门
  • 前提条件
  • 安装
• 高级安装
  • CrewAI 安装
  • OpenAI Agents 安装
• 使用说明
  • 高级功能
    • Agentic 提示词加固
    • Agentic 工作流漏洞测试
    • CI/CD 工作流
• 路线图
• 博客与教程
• 社区
• 常见问题
• 贡献指南
• 行为准则
• 许可证

描述 📝

Agentic Radar 旨在分析和评估 Agent 系统，以提供安全性和运维方面的洞察。它能够帮助开发人员、研究人员和安全专家深入理解 Agent 系统的工作方式，并识别潜在漏洞。

它允许用户为 Agent 系统创建安全报告，包括：

1. 工作流可视化 - Agent 系统工作流的图形展示 ✅
2. 工具识别 - 系统使用的所有外部和自定义工具列表 ✅
3. MCP Server 检测 - 系统 Agent 使用的所有 MCP 服务器列表 ✅
4. 漏洞映射 - 将识别出的工具与已知漏洞关联的表格，提供安全概览 ✅

综合 HTML 报告汇总了所有发现，便于查看和分享。

点击此处查看完整报告示例

Agentic Radar 包含将检测到的漏洞映射到知名安全框架的功能 🛡️：

• OWASP Top 10 LLM 应用安全风险
• OWASP Agentic AI – 威胁与缓解措施

Agentic 可视化工具 🎆

如果您仅需要可视化功能，请尝试 Agentic Visualizer。

这是一个基于 Web 的工具，允许您以用户友好的方式可视化 Agent 工作流。

快速入门 🚀

前提条件

无需特殊准备！只需确保您的机器上安装了 Python (pip)。

安装

pip install agentic-radar

# 检查是否安装成功
agentic-radar --version

根据目标 Agent 框架的不同，某些功能需要额外的安装。详情请见下方。

高级安装

CrewAI 安装

当结合 CrewAI 使用以下功能时，需要安装 CrewAI 扩展包：

• Agentic Radar 测试
• 预定义工具的描述

您可以通过运行以下命令安装包含 CrewAI 依赖的 Agentic Radar：

pip install "agentic-radar[crewai]"

[!WARNING] 这将安装 crewai-tools 包，该包仅支持 Python >= 3.10 版本。如果您使用其他 Python 版本，工具描述将不够详细或完全缺失。

OpenAI Agents 安装

当结合 OpenAI Agents 使用以下功能时，需要安装 OpenAI Agents 扩展包：

• Agentic Radar 测试

您可以通过运行以下命令安装包含 OpenAI Agents 依赖的 Agentic Radar：

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

使用说明

Agentic Radar 目前支持两个主要命令：

1. scan

扫描代码中的 Agent 工作流并生成报告。

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

测试 Agent 工作流中的 Agent 以查找各类漏洞。 要求设置 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 提示词加固 (Agentic Prompt Hardening)

Agentic 提示词加固功能可自动优化 Agent 工作流中检测到的系统提示词，并将其显示在报告中。它将简单的 Agent 指令转换为符合最佳提示工程实践的高质量结构化系统提示词。

[!NOTE]
目前支持的框架（未来会支持更多）：OpenAI Agents, CrewAI, Autogen

使用方法非常简单：

1. 通过运行 export OPENAI_API_KEY= 设置您的 OPENAI_API_KEY 环境变量。
2. 运行 Agentic Radar 时添加 --harden-prompts 参数，例如：