archestra-ai/OpenAPPA

OpenAPPA – 用于 LLM 代理的确定性防护栏

它是什么 – OpenAPPA (Agentic Permissions Policy Algebra) 是一个轻量级、确定性的执行环境，位于 AI 代理与其调用的外部工具之间。在每次工具调用之前，它会询问一个问题：“此数据是否允许传送到此目的地？” 该决策是根据声明式策略（以 TOML 编写）和事件日志做出的，无需任何网络或文件 I/O，确保相同的输入始终得到相同的答案。

为什么重要 – 由 LLM 驱动的代理经常读取敏感信息（例如私人电子邮件、会议记录），然后调用工具（API、文件写入、代码执行）。现有的防护栏通常是概率性的，可能会导致数据泄露或阻碍合法工作。OpenAPPA 提供了一种确定性的、基于策略的检查，在防止未经授权的数据流动的同时，保持高任务完成率。

关键组件

• APPA engine – 根据数据当前的敏感度/信任等级以及目标工具来评估策略。返回二进制的允许/拒绝决策。
• Policy language – 简单的 TOML 文件，描述哪些数据类别（PII、机密等）可以传送到哪些目的地（Webhook、存储库、云服务等）。
• CLI – appa describe --check 用于验证策略文件；appa replay 用于重放脚本化的工具调用以验证预期决策，适用于 CI 检查。
• Integrations – Claude Code 的插件，以及一个边车代理 (Archestra)，可以保护任何通过 LLM 代理（Claude Desktop、Cursor、Codex、Copilot CLI、n8n 等）与 LLM 通讯的代理。

基准测试 – 在两个套件上进行了评估：

• Bench‑Corp (20 个多步骤企业工作流程) 和 AgentThreatBench (针对代理应用程序的 OWASP Top 10)。在 1,320 次执行中，OpenAPPA 阻挡了 0 % 的攻击，同时完成了约 89 % 的任务。竞争系统（Microsoft FIDES、Claude Auto mode）分别让 31 % 和 10 % 的攻击通过，且任务完成率较低。

入门指南

# 安装执行环境与 Claude Code 插件
curl -fsSL https://openappa.com/install.sh | sh && \
  ~/.local/bin/appa plugin install claude-code

# 启动受保护的 Claude Code 会话
clappa

您也可以将 APPA 执行环境直接嵌入您自己的代理（任何语言）中，或将其作为拦截工具调用的边车程序执行。

典型使用案例

• 处理机密文件并必须在调用外部 API 前执行数据流策略的企业代理。
• 需要合规性（GDPR、HIPAA 等）的 LLM 驱动助理开发。
• 自动验证新策略修订不会无意中阻碍合法工具使用的 CI 管线。

状态 – 该项目处于 preview/RFC 模式。核心代数和恢复保证描述在预印本论文（APPA: Recoverable Information‑Flow Control for Real‑World LLM Agents, arXiv 2607.24625）中，并已被 NeurIPS 2026 Agents in the Wild 工作坊接受。API 和配置格式可能会变更，但存储库可用于实验和集成。

授权 – MIT。

---

链接

• 网站: https://openappa.com
• 论文: https://arxiv.org/abs/2607.24625
• Discord 社区: https://discord.gg/B5fmSxHKZ7
• Bench‑Corp 数据: https://github.com/archestra-ai/OpenAPPA/tree/main/bench/corp