Superagent SDK

这个 Agent 能做什么，适合哪些场景？

Superagent SDK 是一个面向 AI 应用安全的开源 SDK，提供 Guard、Redact、Scan 和计划中的 Test 功能。它提供 TypeScript SDK、Python SDK、CLI 与 MCP Server，其中 MCP Server 明确用于 Claude Code 和 Claude Desktop。Guard 在运行时接收输入并返回 classification 与 violation_types，供应用阻断提示注入、恶意指令或不安全的工具调用。Redact 接收文本并输出替换了 PII、PHI 或密钥的 redacted 文本；Scan 接收仓库 URL，输出安全报告及 usage.cost。项目说明其可配合 OpenAI、Anthropic、Google、Groq、Bedrock 等模型使用，也提供可自行部署的 Guard 开源权重模型。

应用通过 createClient() 创建客户端后，可调用 client.guard({ input }) 检查用户消息；当 result.classification 为 "block" 时，可读取 result.violation_types 并在应用中阻断请求。client.redact({ input, model }) 会处理输入文本，并在 result.redacted 中返回已替换敏感内容的文本。client.scan({ repo: "https://github.com/user/repo" }) 会分析指定仓库中的面向 AI agent 的攻击，例如 repo poisoning 和恶意指令，并返回 result.result 安全报告与 result.usage.cost。README 还展示了 client.test({ endpoint, scenarios }) 的红队测试接口，但该功能标注为 Coming soon。

1. 负责面向外部用户的聊天或助手应用的开发团队，可在将 userMessage 交给模型或工具前调用 Guard，并依据 "block" 分类拒绝请求。
2. 处理支持工单、医疗相关文本或用户提交内容的产品团队，可用 Redact 移除 PII、PHI 和 secrets 后再继续处理文本。
3. 准备接入第三方 GitHub 仓库、代码库或外部项目内容的安全团队，可用 Scan 对仓库 URL 生成安全报告并查看扫描成本。
4. 使用 Claude Code 或 Claude Desktop 的开发者，可选择项目提供的 MCP Server 集成方式。
5. 希望在自身基础设施运行 Guard 的团队，可根据速度与准确性需求选择 0.6B、1.7B 或 4B 开源权重模型，或使用其 GGUF CPU 版本。

如何安装或部署这个 Agent？

先在 superagent.sh 注册并获取 API key。TypeScript 安装：npm install safety-agent；Python 安装：uv add safety-agent。随后在 shell 中设置：export SUPERAGENT_API_KEY=your-key。

如何使用这个 Agent？

TypeScript 的最小 Guard 调用为：import { createClient } from "safety-agent"; const client = createClient(); const result = await client.guard({ input: userMessage }); if (result.classification === "block") { console.log(result.violation_types); }。需要脱敏时可调用 client.redact({ input: "My email is [email protected] and SSN is 123-45-6789", model: "openai/gpt-4o-mini" }) 并读取 result.redacted。Python 使用 from safety_agent import create_client、client = create_client()，再以 await client.guard(input=user_message) 或 await client.scan(repo="https://github.com/user/repo") 调用。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. node-v0.0.9 2025-09-14
   发布说明摘录

   Node.js Package Release Installation Options Via npm: ```bash npm install -g ai-firewall ``` Via GitHub Packages: ```bash npm install -g @superagent-ai/ai-firewall ``` Via Docker: ```bash docker pull ghcr.io/superagent-ai/superagent/node:0.0.9 ``` Via binary download: Download the appropriate binary for your platform and extract it. Usage ```bash ai-firewall start --port 8080 --config superagent.yaml ``` What's Changed See the auto-generated release notes below.

   在 GitHub 查看 ↗
2. rust-v0.0.9 2025-09-14
   发布说明摘录

   Rust Package Release Installation Options Via crates.io: ```bash cargo install ai-firewall ``` Via Docker: ```bash docker pull ghcr.io/superagent-ai/superagent/rust: ``` Via binary download: Download the appropriate binary for your platform below. What's Changed See the auto-generated release notes below.

   在 GitHub 查看 ↗
3. rust-v0.0.8 2025-09-11
   发布说明摘录

   Rust Package Release Installation Options Via crates.io: ```bash cargo install ai-firewall ``` Via Docker: ```bash docker pull ghcr.io/superagent-ai/superagent/rust: ``` Via binary download: Download the appropriate binary for your platform below. What's Changed See the auto-generated release notes below.

   在 GitHub 查看 ↗

常见问题