AgentVeil（avp-sdk）是一个面向 AI 智能体动作的独立控制层，定位为在智能体运行时之外的策略边界。它不替代任何智能体运行时，而是围绕被配置为经过它的动作路径进行中介。当原生或风险动作触及该边界时，AgentVeil 会做出四种决策之一：放行（allow）、需要批准（approval_required）、重定向指引（redirect，指向受控路径）、或硬阻断（hard-block）。被路由的 MCP 调用遵循同一决策模型，并记录有界本地证据。官方强调，AgentVeil 不是机器级控制；未配置在 AgentVeil 边界内的动作不会被分类或记录。
主要能力围绕一个产品循环（The AgentVeil Loop）展开：批准用于需要人工复核的动作；重定向提示智能体在存在受控 MCP 路径时重试；硬阻断表示该动作即使批准也无济于事；本地证明通过 CLI 即可获得，而非未来的仪表盘页面。AgentVeil 有两个公开的动作控制面：一、项目连接器，按项目/工作区配置，安装托管的本地钩子与 MCP 路由配置，阻断受支持的原生风险突变工具，返回指向 AgentVeil MCP 工具的重定向指引，并对路由的工具调用使用 MCP 代理的批准与证据机制；二、核心 MCP 代理，包装下游 MCP 服务器、对路由的 MCP 工具调用进行分类、返回 allow / approval_required / redirect / policy-stop 结果，并记录有界本地证据。
使用方式上，可以从控制台（agentveil.dev/console/auth）使用 GitHub 或 Google 登录，选择智能体并运行控制台显示的命令。支持的项目连接器包括 Cursor、Claude Code、Codex、Gemini CLI，各自通过选择要保护的项目文件夹并重载相应客户端来安装项目本地钩子；Codex 与 Gemini CLI 会要求一次信任项目钩子或文件夹。Hermes CLI 则通过 AgentVeil 启动，配置项目本地的 Hermes home 并将 Hermes 路由到 AgentVeil MCP 工具。对于更低层的 MCP 路由，可直接运行核心 MCP 代理路径，将 MCP 工具调用显式指向 agentveil-mcp-proxy。验证方式包括：让智能体读取项目上下文（如 list_workspace、read_file、get_file_info、instruction_surface_status 应放行）；让智能体创建或编辑文件（应被阻断并给出重定向指引，随后走受控 MCP 路由并触发批准）；打开批准页面复核有界证明细节；用 CLI 检查本地证明，默认人类可读输出包含 decision=approval_required、tool=write_file 等行，使用 --json 获取结构化字段。
证据方面，AgentVeil 为受控动作记录有界本地证据，可查看智能体请求了什么、策略如何决定、是否需要批准、动作是否执行，默认记录哈希与有界元数据而非原始提示词或完整载荷。该机制适用于 AI 智能体治理、合规审查与不安全自动化的调试。设计原则包括故障安全默认（缺失策略、缺失批准或不可用可信决策倾向于拒绝或显式复核）、路由调用的完全中介、最小权限、权限分离与有界证据。
限制方面，AgentVeil 不主张机器级控制：不控制整个机器、不全局控制每个 Cursor / Claude / Codex / Gemini / Hermes 聊天、不全局控制每个自主智能体运行时、不控制配置路径之外的人工终端命令、不控制受支持智能体工具面之外的 IDE 动作、不控制未经过 AgentVeil 路由的 MCP 服务器、不控制禁用/移除/绕过的钩子、也不控制跳过钩子的不支持客户端模式。截至目前，可用能力包括：面向路由 MCP 工具调用的 MCP 代理、项目本地的 Cursor / Claude Code / Codex / Gemini CLI 连接器、Hermes CLI 受控 MCP 启动配置、路由动作的批准/重定向/阻断/证据结果以及有界本地证据导出。以 SDK/协议原语形式提供的能力包括能力令牌原语、本地身份辅助、委托收据、证明包辅助。预览/设计伙伴流程包括会话令牌流程、更丰富的策略包、凭证托管、出口边界、托管审批与团队治理。公共连接器不包含机器级 shell 拦截、全局客户端锁定、对无关聊天的自动控制、私有企业策略包、托管认证/许可/遥测或企业托管逻辑。根 SDK 采用 MIT 许可，agentveil-mcp-proxy 为单独打包的 source-available 组件，采用 BUSL-1.1 许可。Python SDK 还包含框架示例与面向 CrewAI、LangGraph、AutoGen、PydanticAI、OpenAI、Gemini、AWS Bedrock 的可选辅助模块，但这些示例不等同于项目连接器。
