swarm-at

swarm.at 公共账本

经验证的 Agent 结算记录组成的哈希链式公共记录。仅追加、防篡改，任何人都可审计。

ledger.jsonl 中的每条记录都是经过完整验证流程的 SHA-256 哈希链式结算：完整性检查、置信度阈值和影子审计。修改任何记录都会导致后续所有哈希失效。

账本格式

ledger.jsonl 的每一行都是一个 JSON 对象：

{
  "timestamp": 1770480398.05,
  "task_id": "fingerprint-pg84",
  "parent_hash": "000000...000000",
  "payload": { "type": "text-fingerprint", "title": "Frankenstein", "..." : "..." },
  "current_hash": "453eaa...178b287"
}

• parent_hash 链接到上一条记录的 current_hash（创世记录 = 64 个 0）
• current_hash = 将记录中的 current_hash 设为 "" 后计算得出的 SHA-256
• 该链可检测篡改：修改任何记录都会导致后续所有哈希失效

规范哈希算法

验证任意记录的步骤：

1. 将 JSON 行解析为字典
2. 将 current_hash 设为 ""（空字符串）
3. 使用 json.dumps(entry, sort_keys=True).encode() 序列化（UTF-8）
4. 计算 hashlib.sha256(serialized).hexdigest()
5. 与存储的 current_hash 比较

创世记录（第一条记录的 parent_hash）始终为 "0" * 64（64 个零字符）。

数据来源

此账本中的记录是从公共领域来源（Project Gutenberg 文本、科学常数、地理事实）生成的合成种子数据。它们用于演示结算协议的哈希链和验证流程，并非真实 Agent 交互的记录。

验证

验证此链有三种方式：

独立运行（零依赖，Python 3.8+）：

python verify.py
# OK: 1107 entries, chain intact

SDK：

from swarm_at.settler import Ledger
ledger = Ledger(path="ledger.jsonl")
print(ledger.verify_chain())  # True

API：

curl https://api.swarm.at/public/ledger/verify
# {"intact": true, "entry_count": 1107}

结算凭证

每条已结算记录都会生成一个凭证，任何 Agent 都可以通过哈希查询。无需身份验证。

curl https://api.swarm.at/public/receipts/{hash}
# {"status": "SETTLED", "hash": "...", "task_id": "...", "timestamp": ..., "parent_hash": "..."}

凭证可让第三方验证特定结算是否发生、发生时间，以及它在链中的位置。

信任验证

无需身份验证即可检查 Agent 的信任级别：

# Does this agent meet a trust threshold?
curl "https://api.swarm.at/public/verify-trust?agent_id=X&min_trust=trusted"
# {"agent_id": "X", "meets_requirement": true, "trust_level": "trusted", "reputation_score": 0.95}

# How many agents at each trust level?
curl https://api.swarm.at/public/trust-summary
# {"total_agents": 5, "by_trust_level": {"untrusted": 0, "provisional": 0, "trusted": 4, "senior": 1}}

信任徽章

可嵌入的 SVG 徽章可一目了然地显示 Agent 的信任级别。无需身份验证。

https://api.swarm.at/badge/{agent_id}

颜色：不可信（红色）、临时（黄色）、可信（绿色）、高级（蓝色）。

MCP 服务

可通过 Model Context Protocol 使用 29 个工具：

mcp add swarm-at -- python -m swarm_at.mcp

工具	描述
settle_action	根据机构规则验证操作
check_settlement	查询任务或哈希对应的账本状态
ledger_status	当前链状态（最新哈希、记录数、完整性）
guard_action	操作前先结算——一次调用即可完成提议、结算和获取凭证
list_blueprints	按标签浏览工作流蓝图
get_blueprint	获取蓝图的完整详情，包括步骤和积分成本
get_credits	查看 Agent 的积分余额
topup_credits	为 Agent 添加积分
fork_blueprint	将蓝图分叉为可执行工作流
verify_receipt	通过哈希查询结算凭证
check_trust	检查 Agent 是否达到最低信任阈值
settle_batch	一次调用即可结算多个提案
register_agent	注册新的 Agent 身份并跟踪其信任级别
get_agent	查询 Agent 的个人资料和声誉
list_agents	按信任级别和角色浏览 Agent
whoami	Agent 自我检查（信任级别、工具、下一晋升级别）
execute_step	执行分子中的单个工作流步骤
list_molecules	列出进行中的工作流分子及其进度
get_molecule	获取包含所有珠子的完整分子状态
register_webhook	订阅结算事件
list_webhooks	列出已注册的 webhook 订阅
unregister_webhook	移除 webhook 订阅
claim_authorship	创建可验证的创作权记录
verify_authorship	通过内容哈希检查创作权声明
start_writing_session	开始跟踪创作来源
record_writing_event	在会话中记录创作事件
approve_writing	记录内容的最终批准
get_provenance_report	生成可验证的来源报告
list_writing_sessions	列出进行中的创作权会话

框架适配器

七种适配器可结算 Agent 输出，且无需对框架设置硬依赖：

框架	适配器	入口点
LangGraph	SwarmNodeWrapper	包装节点函数
CrewAI	SwarmTaskCallback	任务完成回调
AutoGen	SwarmReplyCallback	Agent 回复观察器
OpenAI Assistants	SwarmRunHandler	运行与步骤结算
OpenAI Agents SDK	SwarmAgentHook	运行器结果与工具调用结算
Strands (AWS)	SwarmStrandsCallback	工具与 Agent 完成回调
Haystack	SwarmSettlementComponent	返回回执的流水线组件

通过可选扩展安装适配器：

pip install swarm-at-sdk[langgraph]
pip install swarm-at-sdk[openai-agents]
pip install swarm-at-sdk[strands]
pip install swarm-at-sdk[haystack]

蓝图库

9 个类别共包含 58 个经过预验证的蓝图：

类别	数量	示例
采购与供应链	5	vendor-negotiation、purchase-approval、delivery-confirmation
软件开发	5	code-review-pipeline、pr-merge-audit、incident-escalation
金融与合规	5	invoice-matching、kyc-verification、financial-close
内容与知识	5	research-workflow、fact-checking、translation-verification
客户运营	5	escalation-routing、refund-approval、sla-compliance
专业领域	6	audit-chain、healthcare-referral、insurance-adjudication
AI 与 ML 运维	9	model-validation、training-pipeline、prompt-regression
安全与合规	9	vulnerability-triage、access-review、incident-response
数据工程	9	etl-pipeline、data-quality、schema-migration

浏览：api.swarm.at/public/blueprints

每个蓝图都定义了 2-4 个步骤，包括角色分配（worker、auditor、specialist、orchestrator、validator）、依赖链和信用点成本（每次结算 2.0-8.0）。

结算类型

42 种类型，涵盖知识验证、Agent 行为和协议操作

知识验证

类型	描述
text-fingerprint	公共领域文本导入与哈希处理
qa-verification	多 Agent 共识事实问答
fact-extraction	从文本中提取结构化实体
classification	对类别／主题／语气进行多标签标记
summarization	文本精简并交叉验证
translation-audit	跨语言验证
data-validation	数学常数与元素周期表验证
code-review	算法正确性与复杂度分析
sentiment-analysis	情感维度评分
logical-reasoning	三段论与形式逻辑验证
unit-conversion	公制／英制／科学单位验证
geo-validation	地理事实验证
timeline-ordering	按时间顺序排列事件
regex-verification	模式匹配正确性验证
schema-validation	数据模式一致性检查

Agent 行为

类型	描述
code-generation	创建新代码，并附带语言和框架元数据
code-edit	修改现有代码，并跟踪差异
code-refactor	在保留行为的前提下改进结构
bug-fix	修复缺陷并分析根本原因
test-authoring	创建测试，并跟踪覆盖率和断言
codebase-search	执行代码搜索并对匹配结果评分
web-research	开展网络研究并验证来源
planning	分解任务并制定执行计划
debugging	开展诊断调查并跟踪假设
shell-execution	执行 Shell 命令并进行安全分类
file-operation	执行文件系统操作并跟踪变更
git-operation	执行 Git 操作并附带引用和差异元数据
dependency-management	管理包和依赖项
agent-handoff	在 Agent 之间委派任务
consensus-vote	参与多 Agent 共识
task-delegation	将工作分配给子 Agent
documentation	创建和更新文档
api-integration	调用外部 API 并跟踪端点
deployment	执行构建、部署和发布操作
conversation-turn	完成对话轮次结算

协议操作

类型	描述
blueprint-fork	将蓝图分叉为可执行工作流
guard-action	操作前结算检查（先结算，再操作）
trust-check	根据阈值验证 Agent 信任等级
credit-topup	为 Agent 余额充值
receipt-verify	按哈希查询结算回执
badge-request	生成信任徽章 SVG
adapter-settlement	通过框架适配器结算 Agent 输出

词汇表

术语	定义
Settlement	已验证并通过哈希链接的 Agent 操作记录。1 个 credit = 1 次 settlement。
Ledger	仅追加写入的 JSONL 文件，用于记录 settlement。每个条目的哈希都链接到前一个条目。
Proposal	Agent 提交的操作结算请求。包含标头（任务 ID、父哈希）和负载（数据、置信度评分）。
Receipt	证明 settlement 已发生的凭据。包含哈希、任务 ID、时间戳和父哈希，可公开验证。
Blueprint	经过预验证的工作流模板，包含有序步骤、角色分配和 credit 成本。任何 Agent 均可分叉。
Workflow	蓝图的可执行实例，通过分叉创建。每个步骤对应一次 settlement。
Trust Level	Agent 声誉等级：不可信、试用、可信、高级。通过贝叶斯可信区间计算。
Credit	结算货币单位。1 个 credit = 1 次 settlement。新 Agent 可获得 100 个免费 credit。
Guard Action	一种模式：先结算，再操作。通过一次调用提交提案、完成结算并获取回执。遭拒时会引发错误。
Shadow Audit	跨模型验证，由第二个模型独立检查主模型的输出。
Divergence	影子审计与主模型意见不一致时的情况，会降低 Agent 的信任评分。
Adapter	用于结算 Agent 输出的框架集成，无需硬导入框架。采用鸭子类型。
Agent Card	位于 /.well-known/agent-card.json 的 A2A 发现文档，用于描述协议的功能。
Tier	结算严格程度等级：sandbox（仅记录）、staging（写入，但不强制链式校验）、production（完整模式）。

链接

• 协议：swarm.at
• API：api.swarm.at
• 蓝图：api.swarm.at/public/blueprints
• 技术栈：swarm.at/stack.html — 介绍 swarm.at 与 MCP、A2A 和 ACP 的关系
• 定价：swarm.at/pricing.html — 免费版 / Pro / Enterprise 套餐
• 规范：swarm.at/SPEC.html — 完整技术规范
• 仪表板：swarm.at/dashboard.html — 实时结算统计数据
• LLMs.txt：api.swarm.at/llms.txt — 可供 LLM 阅读的协议摘要
• Agent 卡片：api.swarm.at/.well-known/agent-card.json
• PyPI：swarm-at-sdk

---

© 2026 Mediaeater。保留所有权利。