为 AI 编程代理提供运行时守卫,在工具调用执行前判定放行、需人工确认或拦截。
superagent-ai/superagent
一个开源 SDK,用于防范提示词注入、脱敏 PII 与密钥,并扫描仓库中针对 AI 智能体的攻击。
- Star
- 6,847
- Fork
- 966
- 未关闭 Issue
- 21
- 最近提交
- 2个月前
这是什么?
Superagent SDK 是一个为基于大语言模型的应用增加安全检查的工具包。其 guard 方法在运行时检测用户输入,识别并拦截提示词注入、恶意指令和不安全的工具调用。redact 方法可从文本中去除 PII、PHI 和密钥,并以 <EMAIL_REDACTED> 等占位符替换。
SDK 还提供 scan 方法,用于分析代码仓库中针对 AI 智能体的攻击,例如仓库投毒和嵌入的恶意指令。针对生产环境智能体的红队测试功能目前仍在开发中。
项目提供 TypeScript 和 Python SDK、命令行工具,以及可配合 Claude Code 和 Claude Desktop 使用的 MCP 服务器。支持 OpenAI、Anthropic、Google、Groq、Bedrock 等模型,并提供开放权重模型,可将 Guard 部署在自有基础设施上运行。
核心功能
- 01运行时检测并拦截提示词注入和不安全的工具调用
- 02从文本中脱敏 PII、PHI 和密钥
- 03扫描代码仓库,识别仓库投毒和恶意智能体指令
- 04提供 TypeScript 与 Python SDK 以及命令行工具
- 05提供适用于 Claude Code 和 Claude Desktop 的 MCP 服务器
适用场景
- 在聊天机器人将用户输入交给模型前进行过滤
- 在提示词或日志中脱敏客户敏感数据
- 检查 AI 编码智能体将要读取的第三方仓库
- 使用开放权重模型在自有基础设施上运行 Guard
快速上手
- 1
在 superagent.sh 注册以获取 API 密钥
- 2
安装 TypeScript SDK
npm install safety-agent - 3
设置你的 API 密钥
export SUPERAGENT_API_KEY=your-key
使用前须知
- Guard、Redact 和 Scan 需要 Superagent API 密钥,因此需要账户和网络访问,除非你自行部署开源权重模型。
- Test 功能标注为即将推出,目前尚不可用。
收录于专题
标签
常见问题
- superagent 是什么?
- 一个开源 SDK,用于防范提示词注入、脱敏 PII 与密钥,并扫描仓库中针对 AI 智能体的攻击。 Superagent SDK 是一个为基于大语言模型的应用增加安全检查的工具包。其 guard 方法在运行时检测用户输入,识别并拦截提示词注入、恶意指令和不安全的工具调用。redact 方法可从文本中去除 PII、PHI 和密钥,并以 <EMAIL_REDACTED> 等占位符替换。
- superagent 可以免费使用吗?用的什么许可证?
- superagent 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- superagent 还在维护吗?
- 半年内有更新。superagent 最近一次提交是在 2026年8月25日。
- superagent 适合用来做什么?
- 在聊天机器人将用户输入交给模型前进行过滤 在提示词或日志中脱敏客户敏感数据 检查 AI 编码智能体将要读取的第三方仓库 使用开放权重模型在自有基础设施上运行 Guard
- superagent 怎么安装和运行?
- 在 superagent.sh 注册以获取 API 密钥 安装 TypeScript SDK: npm install safety-agent 设置你的 API 密钥: export SUPERAGENT_API_KEY=your-key
- 在哪里获取 superagent?
- 源代码和安装说明在 GitHub 上:https://github.com/superagent-ai/superagent
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源 Python 框架,用于对 LLM 系统和 AI 智能体进行红队测试,模拟攻击发现漏洞并提供生产环境防护。
一个开源 Python 工具包,为基于 LLM 的对话应用添加可编程的安全护栏,控制话题、对话路径与输出。
Python 库,用 Jev 类决策模型替代 LLM 裁判,为 Agent 执行轨迹做评测与护栏,一次请求完成所有检查。
为 Claude Code、Codex 等 AI 编程助手提供执行前拦截,阻止破坏性 Git 与文件命令及敏感文件访问。
位于工具调用型 AI Agent 与其工具之间的安全中间件,可拦截高风险调用并脱敏敏感返回内容。