Repolode
superagent-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. 1

    在 superagent.sh 注册以获取 API 密钥

  2. 2

    安装 TypeScript SDK

    npm install safety-agent
  3. 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 数据每日更新。

相关项目