Justin0504/Aegis

这是什么？

核心功能

• 01在策略判断前按类别对每次工具调用进行分类，无需工具注解。
• 02高风险调用在执行前进入 Cockpit 审批队列，等待人工决定。
• 03内置 SQL 注入、文件访问、网络访问和提示词注入等默认策略。
• 04提供按租户配置的 YAML 策略 DSL，且只能收紧决策。
• 05追踪记录写入哈希链式审计日志，可选 Ed25519 签名。
• 06支持 Python、TypeScript、Go SDK，以及 HTTP 代理和 MCP 代理。

适用场景

• 为能够执行 SQL、Shell 命令或文件操作的 Agent 加上防护。
• 在 Agent 发布软件包或部署到 Kubernetes 前要求人工确认。
• 用可防篡改的日志为合规审查提供 Agent 行为审计。
• 通过代理转发闭源或已编译 Agent 的 LLM 与 MCP 流量，实现统一管控。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/Justin0504/Aegis
2. 2

   进入项目目录

   cd Aegis
3. 3

   使用 Docker Compose 启动服务

   docker compose up -d
4. 4

   在 Python 智能体中导入一次 AEGIS 以启用它

   python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"

使用前须知

• !桌面应用目前仅提供适用于 Apple Silicon 芯片 Mac 的版本，尚不支持 Windows（建议使用 WSL2）。
• !手动部署需要 Docker，并需在本地运行多个服务。

收录于专题

标签

常见问题

Aegis 是什么？

面向 AI Agent 的运行时防火墙，在工具调用执行前进行拦截、分类与阻断，并支持人工审批和可防篡改的审计日志。 AEGIS 位于 AI Agent 与其调用的工具之间。每次工具调用都会按类别（数据库、文件、网络、Shell、提示词注入、供应链等）分类，并与策略和行为基线比对，随后被放行、转入人工审批或在执行前阻断。典型场景包括阻止破坏性 SQL、异常的数据外发，以及模型臆造的 Shell 命令。

Aegis 可以免费使用吗？用的什么许可证？

Aegis 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Aegis 还在维护吗？

活跃维护中。Aegis 最近一次提交是在 2026年10月31日。

Aegis 适合用来做什么？

为能够执行 SQL、Shell 命令或文件操作的 Agent 加上防护。 在 Agent 发布软件包或部署到 Kubernetes 前要求人工确认。 用可防篡改的日志为合规审查提供 Agent 行为审计。 通过代理转发闭源或已编译 Agent 的 LLM 与 MCP 流量，实现统一管控。

Aegis 怎么安装和运行？

克隆代码仓库: git clone https://github.com/Justin0504/Aegis 进入项目目录: cd Aegis 使用 Docker Compose 启动服务: docker compose up -d 在 Python 智能体中导入一次 AEGIS 以启用它: python -c "import agentguard; agentguard.auto('http://localhost:8080', agent_id='my-agent')"

在哪里获取 Aegis？

源代码和安装说明在 GitHub 上：https://github.com/Justin0504/Aegis