Preloop

这个 Agent 能做什么，适合哪些场景？

Preloop 是一个可自托管的开源服务（Apache 2.0），位于 AI 代理与其可达目标之间，对每次工具调用和模型调用进行治理、归因与记录。它分为两半：控制平面包括 MCP 防火墙（允许、拒绝或挂起工具调用等待人工审批）、带预算与归因的 AI 模型网关、YAML + CEL 的策略即代码，以及每个会话的运行时时间线。软件工厂部分通过 Flows 在托管容器或你的私有 runner 上运行代理，由 GitHub、GitLab、Bitbucket Cloud、Jira、webhook 或 CI 任务触发，仓库内置 21 个预设（如 PR 审查、议题自动实现、安全审计），产出可审查的 pull request。审批可通过手机、手表、Slack、Mattermost、邮件、webhook 或 CLI 完成，人类可随时用 operator note 接管正在运行的代理。部署方式为 Docker Compose、Helm 或 Preloop Cloud，本地 CLI 通过 preloop login 连接控制平面。

Preloop 拦截并治理代理行为：本地代理经 preloop agents discover / preloop agents onboard 接入后，MCP 工具调用经过 MCP Firewall 按 YAML + CEL 策略执行允许、拒绝、要求审批或要求理由；模型调用经过 AI Model Gateway（兼容 OpenAI、Anthropic、Gemini 接口）做预算、允许模型清单与 token 计费归因，按模型、代理、会话、API key、flow 和用户统计花费。Flows 在 GitHub/GitLab/Bitbucket/Jira 事件、webhook 或 CI 触发时启动代理于托管容器或私有 runner（经出站 WebSocket 连接，无需入站端口），所有工具调用走同一防火墙，模型调用计入 flow 预算，最终产出 pull request。审批工作流（含 bash、edit 的原生支持）可通过 preloop approvals 或移动端、Slack 完成；每个会话有统一时间线记录工具调用、模型调用、策略、审批与花费。策略经 preloop policy apply <file> 部署，保存前可用 Test this rule 或 Simulate 模拟。

1. 平台与安全团队在生产系统接入前需要治理代理行为：用 MCP Firewall 加策略即代码控制每个工具调用，并在移动端或 Slack 审批敏感操作。
2. 运行 Claude Code、Codex CLI、Cursor 等编码代理的工程团队需要看清成本：Gateway 按模型、代理、会话、API key 归因花费并用预算封顶。
3. 使用 Jira 或 GitHub 的团队希望把工单变成有边界的代理工作：Flow 触发自动实现议题，产出 pull request 并由 Pull Request Reviewer 预设复审。
4. 面临 CRA / EU AI Act 合规压力的安全团队：运行安全审计预设（SBOM 验证、漏洞检查、发布审计）收集证据包，并用 DORA 导出。
5. 需要 FinOps 可见性的平台团队：查看网关按模型与 flow 的花费明细，导入 Copilot 使用数据，并通过账户 kill switch 紧急阻断流量。

如何安装或部署这个 Agent？

最快的路径是使用 Preloop Cloud（CLI 为客户端）；自托管则用 Docker Compose，数据留在本机。

# 1. 安装 CLI（macOS / Linux / WSL）
curl -fsSL https://preloop.ai/install/cli | sh

# Windows 原生（PowerShell）:
irm https://preloop.ai/install/cli.ps1 | iex

# 自托管（Docker Compose，数据留在本机）
curl -fsSL https://preloop.ai/install/oss | sh

自托管实例必须设置 SECRET_KEY，否则应用拒绝启动；开发版 docker-compose.yml 使用仅限开发的默认凭据，需通过 .env（可从 .env.example 起步）覆盖。控制台地址为 http://localhost:3000。

如何使用这个 Agent？

CLI 先连接到一个控制平面：Preloop Cloud 或自托管实例。

# Cloud（最快）
preloop signup

# 或自托管实例
preloop login --url http://localhost:3000

# 发现并接入本地代理
preloop agents discover

preloop agents discover 查找本地代理配置并报告各适配器能力；preloop agents onboard 将其配置为经 MCP Firewall 与 Gateway 路由。要远程操控运行中的代理，用 preloop agents install-plugin 安装运行时插件（Claude Code 也可用 preloop claude）。策略示例：

version: "1.0"
metadata:
  name: "Production Safeguards"
approval_workflows:
  - name: "deploy-approval"
    timeout_seconds: 600
    required_approvals: 1
    async_approval: true
tools:
  - name: "bash"
    source: mcp
    approval_workflow: "deploy-approval"
    justification: required
    conditions:
      - expression: "args.command.contains('deploy') && args.command.contains('production')"
        action: require_approval

用 preloop policy apply <file> 部署（另有 validate / diff / export）；触发 flow 可用 preloop flow trigger 或 run-flow GitHub Action。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？