AI代理安全治理工具

AgentGuard是一个为AI代理工作流设计的安全治理层,提供策略评估、风险评估、秘密检测、审计日志和决策解释等功能,适用于受监管环境、自主支付和企业AI代理部署。

  • by ToolOracle
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ToolOracle/agentguard

使用说明

🛡️ Agent Guard MCP

AI代理工具执行的安全、策略和审计层 --20个工具|部分 FeedOracle & 工具Oracle

AgentGuard是AI代理工作流的治理和安全层。在任何工具执行之前,AgentGuard都会评估策略,对风险进行评分,检测秘密和注入尝试,记录防篡改审计跟踪,并解释每一个决定。专为监管环境、自主支付和企业AI代理部署而构建。

快速连接

# FeedOracle (compliance-focused)
npx -y mcp-remote https://feedoracle.io/guard/mcp/

# ToolOracle (agent-commerce focused)
npx -y mcp-remote https://tooloracle.io/guard/mcp/
{
  "mcpServers": {
    "agentguard": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedoracle.io/guard/mcp/"]
    }
  }
}

它是如何工作的——代理安全循环

Agent wants to call: payment_execute({amount: 5000})
         │
         ▼
   policy_preflight()         ← Check before execution
         │
   risk_score: 95             ← Critical
   matched: pol-001, pol-002  ← Payment + High-risk policies
   decision: require_approval ← Human gate triggered
         │
   approval_required()        ← Register pending approval
         │
   [Human approves]
         │
   tool executes
         │
   audit_log_write()          ← Record outcome with signature
         │
   decision_explain()         ← Exportable compliance evidence

工具--Welle 1:核心安全(7)

工具 说明
policy_preflight 在任何工具调用之前进行飞行前检查。评估7项策略,计算风险评分,检测威胁,自动记录。退货 allowed/denied/require_approval/flagged.
tool_risk_score 工具+输入的风险评分为0-100。检测机密(API密钥、密码)、即时注入、高价值金额。 eth_gas→5, payment_execute→95+.
approval_required 检查工具是否需要人工批准。可选择使用跟踪URL注册待处理的批准请求
audit_log_write 将工具执行写入持久的、加密签名的审计日志(SQLite WAL)。执行后致电记录结果。
audit_log_query 查询审计跟踪。按代理、工具、决策、时间范围过滤。分页。返回已签名的条目以进行篡改验证。
decision_explain 任何允许/拒绝决定的人类可读解释。通过 request_id 用于存储条目或 tool_name + tool_args 用于新的分析。
rate_limit_check 检查代理速率限制:200/min、5000/hr、50000/天。返回每个窗口的使用百分比。

工具——Welle 2:支付控制和安全

工具 说明
payment_policy_check 根据政策验证付款:金额限制(>10万警告,>100万区块)、收款人名单、支持的货币/网络、反洗钱阈值(>1万法币标记)、MiCA标志。
spend_limit_check 按信任级别检查每次通话/小时/天的支出限额。默认值:10k/通话、50k/小时、200k/天。值得信赖:100k/次通话,500k/小时,2M/天。
secret_exposure_check 深度扫描19种秘密模式:OpenAI/GitHub/AWS/Slack密钥、承载/基本身份验证、ETH私钥、比特币WIF、信用卡、SSN、电子邮件。返回严重性+补救措施。
payload_safety_check 18模式安全扫描:提示注入、越狱/DAN、角色劫持、SQL(UNION/DROP/OR 1=1)、XSS、Python/JS/Shell注入、路径遍历、空字节、超大负载。
replay_guard_check 通过SHA256指纹(代理+工具+参数)检测重放攻击。可配置窗口(默认5分钟)。返回重复计数+第一次/最后一次出现。

工具--Welle 3:治理与威胁情报(5)

工具 说明
cross_tool_anomaly_check 检测异常模式:高风险组合(钱包识别→转移,反洗钱→支付)、频繁、反复否认(政策调查)、广泛侦察、平均风险评分升高。
scope_check 基于角色的范围控制。角色:管理员、合规官、交易员、审计师、开发人员、只读。返回has_scope、缺少作用域、授予角色。记录否认。
session_validate 完整会话生命周期:创建(TTL+呼叫预算)、验证(递增计数器)、无效、信息。会话携带角色、范围、租户和到期时间。
tenant_policy_check 多租户治理。内置租户:默认,fintech_eu(MiCA/DORA/AMLD6),defi_tocol,enterprise_read。每个租户的黑名单、风险限额、支出上限。
threat_intel_check 实体威胁情报。自动检测ETH地址、IP、域名。检查制裁(龙卷风现金、混合器)、一次性服务、审计日志中的行为分析。

内置租户

租户 最大风险 支出/日 框架
default 70 100,000 —
fintech_eu 60 50万 加利福尼亚州、多拉、AMLD6
defi_protocol 80 1000万 MiCA
enterprise_read 30 0 —

内置角色和范围

角色 范围
admin 所有范围
compliance_officer 审计:读取,合规性:读取,区块链:读取,安全性:扫描
trader 区块链:读取,支付:检查,支付:执行,审计:读取
auditor 审核:读取,审核:写入,合规性:读取,监控:读取
developer 区块链:读取,安全:扫描,审计:读取,监控:读取
readonly 区块链:读取,审计:读取

内置策略(7个默认值)

政策 条件 行动
pol-001 支付/转账工具 require_approval
pol-002 风险评分≥80 require_approval
pol-003 有效载荷中的密钥 deny
pol-004 超出速率限制 flag
pol-005 风险评分≤20 allow 自由
pol-006 检测到快速注射 deny
pol-007 同一工具>50次通话/60s flag

风险评分指南

分数 级别 动作
0-14 最小 自由进行
15-39 低 继续,记录审核
40-69 中等 标记并谨慎行事
70-89 高 需要人工批准
90-100 关键 阻止执行

用例

  • 受监管的人工智能工作流程:MiCA/DORA合规性要求审计跟踪--AgentGuard自动提供这些跟踪
  • 自主支付:x402代理付款已完成 approval_required 处决前的大门
  • 多租户平台:每个代理/会话的费率限制和政策范围
  • 安全监控:实时检测工具参数中的即时注入和秘密暴露
  • 合规报告:导出带有加密签名的审计日志以供监管审查

后端:SQLite WAL模式

持久、稳定,不需要守护进程。WAL模式支持每秒1000+次写入。共享于 feedoracle.io 和 tooloracle.io --一个真理的来源。

链接

  • 🛡️ FeedOracle: https://feedoracle.io/guard/mcp/
  • 🔧 工具Oracle: https://tooloracle.io/guard/mcp/
  • 📚 文件: feedoracle.io
  • 🏠 平台: tooloracle.io

由...建造 FeedOracle --设计证据