agentdojo

搭建 LLM 智能体攻防演练场,量化安全风险

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 278 🐛 待处理 101 👀 关注 8
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1002
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,可自行部署使用。

项目预览

agentdojo 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队ethz-spylab
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型benchmark,large-language-models,prompt-injection,security
GitHub 星标★ 1002
上线时间2024-02-29 00:00:00
代码更新2026-06-02
仓库体积37.8 MB
本站数据更新2026-11-08
维护状态低维护
收录时间2026-08-09
浏览次数4

项目介绍

agentdojo 是一个用于评估 LLM 智能体攻击与防御的动态环境。它解决的核心问题是:随着 LLM 智能体被赋予调用外部工具和访问敏感数据的权限,针对这些智能体的提示注入攻击、数据窃取等安全威胁日益严重,但缺乏标准化的测试平台。该项目提供了一套可编程的环境,允许研究人员和开发者模拟各种攻击场景(如恶意工具输出、用户提示注入)并测试防御策略(如输入过滤、权限隔离)的有效性。其核心能力包括:定义任务和工具集、注入攻击向量、运行智能体并记录交互轨迹、量化安全指标(如任务成功率、攻击成功率)。它基于 Python 构建,易于扩展和集成到现有 LLM 应用开发流程中。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1002

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 20 分钟 部署方式:本地 (Python) 5 步

环境要求

  • Python 3.10+
  • 可访问的 OpenAI 兼容模型接口与 API Key

安装与启动步骤

  1. 1创建虚拟环境

    建议用独立环境,避免与其它评测框架的依赖冲突。

    python -m venv .venv && source .venv/bin/activate
  2. 2安装主体

    从 PyPI 安装评测框架;包 API 仍在演进,版本间可能有变化。

    pip install agentdojo
  3. 3可选:装检测器

    需要内置提示注入检测器时,额外安装 transformers 可选依赖。

    pip install "agentdojo[transformers]"
  4. 4跑单个套件

    以 workspace 套件的两个任务为例,指定模型、防御与攻击方式。

    python -m agentdojo.scripts.benchmark -s workspace -ut user_task_0 \
        -ut user_task_1 --model gpt-4o-2024-05-13 \
        --defense tool_filter --attack tool_knowledge
  5. 5跑全部套件

    去掉 -s/-ut 即遍历所有套件与任务,耗时明显变长。

    python -m agentdojo.scripts.benchmark --model gpt-4o-2024-05-13 \
        --defense tool_filter --attack tool_knowledge

如何确认成功

终端逐条打印任务结果,结束时给出各套件的效用与攻击成功率;无 traceback 即视为跑通。

常见问题

Q:跑 benchmark 提示模型鉴权失败?

A:需先设置 OPENAI_API_KEY(或对应 provider 的环境变量),并确认账号可访问该模型。

注意事项

  • 框架用于学术评测,不要用它去攻击第三方线上服务。
  • 脚本支持 --help,参数(模型、防御、攻击、套件)都可组合。

核心亮点

  • 提供标准化的攻击/防御评估框架,避免自建测试环境
  • 支持自定义工具和攻击场景,灵活适配不同智能体应用
  • 输出量化安全指标,便于对比不同防御策略效果

不足之处

  • 早期项目,文档和社区生态尚不完善
  • 评估维度可能偏重安全,对通用性能覆盖有限

适用场景

  • 安全团队评估 LLM 智能体的提示注入风险
  • 开发者测试自身智能体应用的防御机制
  • 学术研究对比不同攻击/防御算法的效果

替代项目

garak、PyRIT、TextAttack

上一篇:factualNLG

下一篇:awesome-data-contamination

同类项目推荐

SkillEvaluator 开源

给 Agent 技能做体检:查冲突、测安全、验效果

Multi-tier framework for evaluating AI agent skills with quality gates, semantic ove···

★ 658 2026-10-13
OPERA 开源

给多模态大模型装上防幻觉刹车,生成更可靠

[CVPR 2024 Highlight] OPERA: Alleviating Hallucination in Multi-Modal Large Language···

★ 416 2026-08-09
awesome-ai-safety 开源

一站式速查AI安全核心论文,快速入门不迷路

A curated list of papers & technical articles on AI Quality & Safety

★ 227 2026-08-09
context-bombs 开源

用现成的攻击字符串,测出你的 AI 系统抗不抗揍。

Context bomb strings

★ 164 2026-08-10
faster_coco_eval 开源

替换 pycocotools,COCO 评测提速数倍不丢精度

Continuation of an abandoned project fast-coco-eval

★ 148 2026-09-14
secure-ai-agent-boundary 开源

给 AI 代理划数据红线,越界访问直接拦住

Secure AI Engineering Framework 2026: Data-Boundary Security for Frontier Models

★ 114 2026-10-27
fake-news 开源

手把手教你从零搭一个假新闻检测模型并上线部署

Building a fake news detector from initial ideation to model deployment

★ 172 2026-08-09
GLM-5.3-Flash-J-Space-Capability··· 开源

把大模型智能体能力评测做成可读报告,一眼看清真实水平

GLM-5.3-Flash × J-Space capability realization — benchmark presentation of the J-S···

★ 1015 2026-09-25
evalscope 开源

一键评测大模型,性能基准轻松跑

A streamlined and customizable framework for efficient large model (LLM, VLM, AIGC) ···

★ 3666 2026-08-09