Hive A/B Test

hive-mcp-abtest

用于 A2A 网络的 A/B 实验运行器。这是一个仅处理入站请求的 MCP 适配层，可为自主 Agent 提供确定性的固定分组分配、转化记录端点，以及双比例 Z 检验统计显著性计算器。通过 Base USDC 按调用次数使用 x402 计费。

• abtest_assign 每次收费 $0.001
• abtest_record_conversion 每次收费 $0.005
• abtest_results 免费且只读

该适配层不会代表调用方运行实验。它会记录调用方注册的实验的分组分配和转化，并按需返回汇总计数和 Z 检验结果。

分组分配的工作方式

分组依据为 SHA-256(experiment_id + "|" + agent_did)：将前四个字节读取为无符号 32 位整数，再对变体权重之和取模。首次调用会写入结果，后续调用会返回相同记录，因此在 SQLite 存储的生命周期内，分组分配会保持固定。

变体列表格式为 [{ id, weight? }, ...]。每个变体的权重默认为 1。传入 [{id:"control"},{id:"treatment",weight:3}] 即可实现 25/75 的分配比例。

统计显著性计算器

对前两个已注册变体进行带合并方差的双比例 Z 检验。输出包括 z_score、双侧 p_value、relative_lift，以及 significant_95 / significant_99 布尔标记。

MCP

• 传输方式：Streamable HTTP，JSON-RPC 2.0
• 协议：2024-11-05
• 端点：POST /mcp

工具：

工具	等级	价格
abtest_assign	3	$0.001
abtest_record_conversion	3	$0.005
abtest_results	0	免费

REST

方法	路径	用途
GET	/v1/abtest	列出实验
POST	/v1/abtest	创建或更新实验 { id, name?, variants }
GET	/v1/abtest/:id	获取实验
PUT	/v1/abtest/:id	更新实验
DELETE	/v1/abtest/:id	删除实验
POST	/v1/abtest/assign	{ experiment_id, agent_did, variants? } — $0.001
POST	/v1/abtest/convert	{ experiment_id, agent_did, metric?, value? } — $0.005
GET	/v1/abtest/results	?experiment_id=...&metric=... — 包含 Z 检验结果
GET	/v1/abtest/today	UTC 日期的分配与转化计数
GET	/health	存活状态、版本和数据库检查

存储

SQLite 数据库位于 /tmp/abtest.db，包含三张表：experiments、assignments、conversions。可通过 DB_PATH 覆盖路径。

环境

变量	默认值
PORT	3000
ENABLE	true
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
PRICE_ASSIGN_USDC	0.001
PRICE_CONVERT_USDC	0.005
DB_PATH	/tmp/abtest.db
X402_ENABLED	true

在本地开发中，设置 X402_ENABLED=false 可跳过支付门控。

快速入门

npm install
npm start
# in another shell
curl -s http://localhost:3000/health
curl -s -X POST http://localhost:3000/v1/abtest \
  -H 'content-type: application/json' \
  -d '{"id":"prompt_v2","name":"prompt v2","variants":[{"id":"control"},{"id":"treatment","weight":3}]}'
curl -s -X POST http://localhost:3000/v1/abtest/assign \
  -H 'content-type: application/json' -H 'x-payment: {}' \
  -d '{"experiment_id":"prompt_v2","agent_did":"did:hive:demo:1"}'

首次调用若未提供已支付的 x402 信封，会返回包含新 nonce 的 402 响应体。将交易哈希和付款方提交到 /v1/x402/submit，即可生成一个短时有效的访问令牌，然后重试。

许可证

MIT。请参阅 LICENSE。

作者

Steve Rotzin · [email protected] · https://www.thehiveryiq.com

Hive Civilization Directory

Hive Civilization 的组成部分 — 面向 Agent 的金融基础设施。

• 端点目录：https://thehiveryiq.com
• 实时排行榜：https://hive-a2amev.onrender.com/leaderboard
• 收入仪表板：https://hivemine-dashboard.onrender.com
• 其他 MCP 服务：https://github.com/srotzin?tab=repositories&q=hive-mcp

品牌色：#C08D23