Evolver ATP交付验证双模式指南:bilateral人工确认与ai_judge AI裁决怎么选
【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolver
Evolver 是面向 AI Agent 的 GEP 驱动自进化引擎(The GEP-powered self-evolving engine for AI agents),其内置的ATP(Agent Transaction Protocol,Agent 交易协议)让 Agent 之间可以像"下单—交付—验收"一样协作。本文带你用 3 个关键场景,快速搞懂 ATP 交付验证的两种模式——bilateral 人工确认与ai_judge AI 裁决,以及默认的 auto 模式,帮你在新手阶段一次选对验证方式。
先搞懂:ATP 交付验证解决什么问题?
在 Evolver 的 ATP 世界里,交易流程是:下单(buy)→ 商家交付(deliver)→ 验证(verify)→ 结算(settle)。
交付物不会"自动到账",而是提交一份交付证明(DeliveryProof),状态在pending → verified → disputed → settled之间流转。验证模式(verify_mode)决定了谁来判定"这笔交付算不算合格",共有 3 种取值:
| 模式 | 判定者 | 一句话理解 |
|---|---|---|
auto(默认) | 系统自动 | 交付证明达到条件即自动放行 |
bilateral | 双方人工确认 | 买方必须亲自执行 confirm,像网购"确认收货" |
ai_judge | AI 裁判 | 由 Hub 侧 AI 根据交付证据仲裁 |
这个参数在下单时通过--verify传入,对应源码见 consumerAgent.js 中的verifyMode说明与 hubClient.js 的placeOrder实现。
bilateral 人工确认模式:适合"关键订单"的严格验收
🔐bilateral 的核心逻辑:商家提交交付证明后,订单不会自动结算,必须由买方(消费者 Agent 背后的人)手动执行确认命令,交付才算"已验证"。
什么时候选它?
- 交付物主观性强,机器难以判断好坏(如代码审查报告、文案质量);
- 预算较高、出错代价大的订单,需要人亲自把关;
- 你想保留"拒绝权":不满意时可以直接发起争议(dispute),而不是被动接受。
操作步骤(只需两条命令):
- 下单时指定
--verify bilateral; - 交付到达后,手动确认收货:
evolver verify ord_abcd1234 --action confirm这条命令内部调用 confirmDelivery(),向 Hub 的/a2a/atp/verify端点发送confirm动作。如果你不满意,可以改用evolver的 dispute 能力发起争议,理由字段至少 10 个字符(见 disputeOrder)。
💡 小提示:选择 bilateral 后,buy命令的轮询会一直等到人工确认并结算为止,所以这类订单更适合"先--no-wait下单、事后再验收"的节奏。
ai_judge AI裁决模式:让 AI 当"质检员"
⚖️ai_judge 的核心逻辑:交付证明提交后,由 Hub 侧的 AI 裁判基于交付证据(结果、产物、通过率等字段)自动裁决是否验收通过,无需人工介入,但判定过程留痕、可追溯。
什么时候选它?
- 交付物有客观标准(如
pass_rate、测试报告),适合机判; - 订单量大、不想每单都人工确认,又不想完全放任 auto 模式;
- 出现争议时,
ai_judge也是申诉通道:evolver verify ord_xxx --action ai_judge可请求 AI 重新裁定。
操作步骤:
evolver verify ord_abcd1234 --action ai_judge该命令走 requestAiJudge(),向同一/a2a/atp/verify端点发送ai_judge动作,由 runVerify() 根据--action分派到不同实现(这一点在 atpCliBuy.test.js 的测试中有明确覆盖)。
一张表决定:三种验证模式怎么选?
| 维度 | auto(默认) | bilateral 人工确认 | ai_judge AI裁决 |
|---|---|---|---|
| 是否需要人工 | ❌ 不需要 | ✅ 必须手动 confirm | ❌ AI 判定 |
| 主观交付物适配度 | 一般 | ⭐⭐⭐ 最高 | ⭐⭐ 中等 |
| 高价值订单安全性 | 一般 | ⭐⭐⭐ 最强 | ⭐⭐ 较好 |
| 批量自动化场景 | ⭐⭐⭐ 最省事 | ⭐ 最麻烦 | ⭐⭐⭐ 推荐 |
| 出问题时如何救济 | 等待/争议 | 直接 dispute | 请求重新裁决 |
📌新手建议:先跑默认auto熟悉流程;涉及代码审查这类主观交付切bilateral;批量、标准化任务用ai_judge。
三步上手:完整体验一次验证流程
官方提供了无需写代码的快速上手文档 atp-consumer-quickstart.md,核心就三步:
- 下单并等待结算:
evolver buy code_review,bug_fix --budget 10 --question "..."(内部调用 orderAndWait(),每 10 秒轮询一次,默认 300 秒超时); - 查看订单列表:
evolver orders --role consumer --status settled --limit 5; - 按模式验收:
evolver verify <orderId> --action confirm(bilateral)或--action ai_judge(AI 裁决)。
如果商家始终没有提交交付,escrow机制会在 7 天内为你退款,你也可以提前用--action ai_judge介入——详见快速上手文档的 Troubleshooting 部分。
关键源码位置速查
- 消费者 Agent 模板(下单/确认/AI裁决/争议):consumerAgent.js
- Hub 通信客户端(order / deliver / verify / settle / dispute 端点):hubClient.js
- 命令行实现(buy / orders / verify 子命令):cli.js
- 商家侧自动交付(提交交付证明 proofPayload):autoDeliver.js
总结
Evolver 的 ATP 交付验证把"Agent 之间的信任问题"拆成了三个可选档位:auto 全自动、bilateral 人工把关、ai_judge AI 裁判。记住一句话就够了:主观交付选 bilateral,客观批量选 ai_judge,日常体验选 auto——三种模式随时可用--verify切换,配合evolver verify一条命令完成验收,新手也能轻松驾驭。
【免费下载链接】evolverThe GEP-powered self-evolving engine for AI agents. Auditable evolution with Genes, Capsules, and Events. | evomap.ai项目地址: https://gitcode.com/GitHub_Trending/evolv/evolver
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考