Verifi

Verifi

为 AI Agent 提供经验证的人工反馈闭环。 Agent 通过 POST 提交意图和声明；真人审核后回答正确、错误，或给出修正后的自由文本。付款采用原生 x402 微支付（Base 上的 USDC 或 EURC），由 HTTP 402 付费墙保护：无需账户，也无需 API 密钥。

现已上线：verifi.cloud · API 文档 · llms.txt · MCP 端点：https://verifi.cloud/mcp

官方 MCP Registry 名称：cloud.verifi/human-verification。发布和域名所有权详情见 docs/MCP_REGISTRY.md。

为什么

每个 Agent 框架都会遇到同一个瓶颈：Agent 无法信任自己的输出。Verifi 为 Agent 提供持久可靠的人工工作流，采用 Agent 熟悉的付款方式（x402），并专为优质回答需要几分钟的情况而设计。

工作原理

agent ──POST /verify──▶ verify-api ──▶ core engine ──▶ Telegram bot ──▶ human
  ▲                        │x402           │ route,        │ buttons:      │
  │                        │verify+settle  │ audit         │ ✅ ❌ ✏️       │
  └──────── answer ◀───────┴───────────────┴───────────────┴───────────────┘

• 三个关卡，以欧元定价：支付 0.10 EUR 即可将请求送入人工队列。人工在入队后 60 分钟内作答时，支付 2.90 EUR 即可解锁结果；若人工在 24 小时内作答，但超过 60 分钟，则支付 1.45 EUR 即可解锁。价格取决于人工作答的时间，而非 Agent 解锁的时间。可使用 EURC 付款，也可使用按欧洲央行参考汇率换算并向上取整到欧分的 USDC 付款。入队时使用的资产决定链，每个价格都会出现在第一个 402 响应中。
• 人工工作不免费：每条处理链都要通过两个关卡付费。人工时间是稀缺资源，而钱包地址可以免费生成，因此免费层会让任何人都能不付费地塞满队列。无需人工的内容免费提供：文档、MCP 发现，以及让 Agent 能测试连接并查看价格的 402 响应。
• 失败抵用额度：如果某条处理链的入队费用已实际支付，但 24 小时内无人作答，则可获得一次免费入队额度，用于下一条处理链，且使用相同资产。该额度不包含解锁费用，也无法通过抵用额度获取免费人工服务。
• 可靠交付：每次调用都会返回 202 和持久有效的 verify_id。Agent 可持续轮询，等待人工作答（最长 24 小时），也可使用可选的就绪或失败回调。
• MCP：Agent 可直接调用 verify_claim、get_verify、unlock_verify 和 verifi_info。

仓库结构

core/          Python core engine
  api/         internal FastAPI + admin dashboard + public /contact
  bot/         Telegram bot for human responders (associates)
  mcp/         MCP server (Streamable HTTP)
  routing/     associate selection
  payments/    earnings, settlements, payouts
  db/          PostgreSQL schema + migrations
instances/
  verify-api/  public Verify API (Node.js + @x402/express)
  ask-this-finn/  second instance (placeholder)
deploy/        docker-compose, nginx, facilitator config, static site
scripts/       ops wrapper (lock + audit + turn-taking)

一台 VPS 即可运行所有组件：PostgreSQL（+pgvector）、核心引擎、机器人、Verify API、x402 Facilitator、MCP 服务和 nginx。

自行运行

cp deploy/env.server.example .env   # fill in tokens and keys
docker compose -f deploy/docker-compose.yml --env-file .env up -d postgres
docker compose -f deploy/docker-compose.yml --env-file .env up -d --build \
  core-api verify-api mcp
docker compose -f deploy/docker-compose.yml --env-file .env --profile bot up -d bot
docker compose -f deploy/docker-compose.yml --env-file .env --profile payments up -d facilitator
docker compose -f deploy/docker-compose.yml --env-file .env --profile edge up -d nginx

你需要：Telegram 机器人令牌、收款钱包地址（X402_PAY_TO），以及一个用于 Facilitator 的少量 Gas 钱包（FACILITATOR_PRIVATE_KEY，其中有价值几欧元的 Base ETH）。资金架构见 docs/WALLETS.md，设计决策见 docs/DECISIONS.md。

20 秒了解 API

curl -X POST https://verifi.cloud/verify \
  -H "Content-Type: application/json" \
  -d '{"intent": "send_email",
       "claim": "The user opted in via double opt-in on 2026-07-15.",
       "agent_id": "0xYourWalletAddress"}'

每个已接收的响应都以 202 和 status: "processing" 开始。持续轮询，直到状态变为 ready 或 failed；ready 状态的结果需通过单独的解锁端点获取。权威的仓库参考文档见 docs/API.md，其在线版本发布于 verifi.cloud/docs。

许可证

MIT