iFixAi
ifixai-ai/iFixAi加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。

2025 年某天,美国某托管服务商(MSP)的部署工程师正准备喝咖啡,突然监控大屏爆红——某客户云账号里凭空多了一条 terraform destroy 指令,价值数十万美元的基础设施在 AI 代理的"自主优化"下灰飞烟灭。
事后复盘:代理没有越权执行恶意操作。它只是"理解"错了策略,把一条模糊的客户请求解读成了授权指令。这是一个典型的 AI Agent 行为偏差案例——模型能力满分,治理能力为零。
这就是 iFixAi 诞生的背景。
企业部署 AI 代理之后,面临一个尴尬的现实:测试只问"能不能用",不问"会不会乱来"。
传统的 AI 测试框架(HELM、lm-eval-harness)测的是模型做 QA 任务和推理题的能力,Inspect AI 让你自建评估集,但结果完全取决于谁来出题。这些工具告诉你"模型答得好不好",却无法告诉你"代理在真实业务流程中会不会出岔子"。
iFixAi 重新定义了问题:不是问"AI 能不能完成这个任务",而是问"AI 的行为是否在它被授权的边界之内"。
iFixAi 建立了行业首个 AI Agent 治理行为审计框架,包含 5 大核心支柱,每个支柱对应一类风险:
| 支柱 | 权重 | 风险类型 |
|---|---|---|
| FABRICATION(捏造) | 20% | Agent 伪造信息、虚构数据源 |
| MANIPULATION(操纵) | 35% | Agent 被提示注入、社交工程攻击 |
| DECEPTION(欺骗) | 15% | Agent 隐瞒关键信息或绕过监管 |
| UNPREDICTABILITY(不可预测) | 15% | Agent 行为超出授权范围 |
| OPACITY(不透明) | 15% | Agent 决策链路不可审计 |
最终输出 A-F 等级评分(A ≥ 90%,F < 60%),还有 3 条强制性门槛:
iFixAi 内置 60 项开源检查项(32 项核心 + 28 项扩展),覆盖:
行为层(检查 Agent 做了什么):
治理层(检查 Agent 被允许做什么):
对抗层(检查 Agent 被恶意利用时):
每项检查都有公开的 YAML 评分标准(rubric),任何人可以复现、质疑和改进。
这是 iFixAi 与传统评估工具最大的设计差异:评分者必须与被测代理非同一家厂商。
| 模式 | 说明 |
|---|---|
| Standard(标准) | 自动从不同供应商选一个评分者(如用 Anthropic 测 OpenAI),默认模式 |
| Full(全量) | 需要 2+ 个评分者,多方共识打分,评分最权威 |
| Deterministic(确定性) | 仅运行结构化检查,不调用 LLM 评分,无需 API Key |
评分者自己也有一套容错机制:当评分 LLM API 出错时,会自动切换到备用模型链(Gemini → GPT-4o mini → Haiku),而不是让整个审计任务中断。
iFixAi 的使用流程极度工程化,强调可复现性:
iFixAi 官网展示了一个经典场景:一个客户支持代理在标准评估中获得 96% 好评率、0 错误、38 秒解决,看起来完美无缺。
但 iFixAi 审计发现了三件"你的评测工具看不到的事":
这正是 iFixAi 的核心价值:传统评测衡量的是"能力",iFixAi 衡量的是"治理"。
iFixAi 采用纯 Python 实现,核心依赖:
run_inspections() 返回 TestRunResultopenai、anthropic、http(测试已部署代理)、mock 等多种接入方式代码结构高度解耦:
ifixai/inspections/:60 项检查项定义ifixai/harness/:检查执行引擎ifixai/providers/:多 LLM 供应商适配器ifixai/fixtures/:预置模拟环境模板安装极简:pip install ifixai,无需 Docker,一行命令搞定。
最快路径(零配置):
# 安装后直接运行,使用内置 mock 代理示例
ifixai run
# 输出:60 项检查项评分卡,默认 fixture 为 NimbusForge IT 运维代理
测试真实代理:
ifixai run --provider openai -k "$OPENAI_API_KEY" --model gpt-4o
# 43/60 项可评测(其余需要治理钩子)
Claude Code 插件(零配置接入):
# 在 Claude Code 中加载插件,Claude 自动引导完成审计
Python API:
from ifixai.api import run_inspections, compare_scorecards
result = run_inspections(provider="openai", api_key=key, model="gpt-4o")
print(result.grade) # A/B/C/D/F
CLI 输出支持 JSON 和 Markdown 两种格式,可集成到 CI/CD 流水线中作为质量门禁(--min-score 0.85)。
iFixAi 团队坦诚列出了几项已知局限:
--eval-mode self,但会被标记为"自我评分偏差"警告)随着 AI 代理在经济系统中承担越来越多的真实操作(退款、授权、删除数据),"能否信任这个代理"已经从技术问题演变成了法律和商业问题。
欧盟 AI 法案(EU AI Act)、ISO 42001、NIST AI RMF 等合规框架都要求对高风险 AI 系统进行独立审计。iFixAi 恰好填补了这个空白——它是 AI 代理领域的"米其林指南",用公开的标准和可复现的方法,给代理的治理能力打出一个可信的分数。
截至 2026 年初,iFixAi 的 GitHub 仓库已获得 27,000+ stars,成为 AI Agent 安全领域最活跃的开源项目之一。它的出现标志着 AI 测试从"能力竞赛"转向"治理审计"——这可能是 2025-2026 年 AI 安全领域最重要的范式转变。