swarm-at

swarm.at 公開台帳

検証済みエージェント決済のハッシュチェーン式公開記録です。追記専用で改ざんの痕跡を確認でき、誰でも監査できます。

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 にリンクします（ジェネシス値 = 0 x 64）
• current_hash は、current_hash を "" に設定したエントリの SHA-256 です
• チェーンは改ざんの痕跡を確認できます。エントリを変更すると、それ以降のすべてのハッシュが無効になります

正規ハッシュアルゴリズム

エントリを検証するには、次の手順に従います。

1. JSON 行を dict にパースします
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 のテキスト、科学定数、地理情報）から生成された合成シードデータです。決済プロトコルのハッシュチェーンと検証パイプラインを示すためのものであり、実際のエージェント間のやり取りを記録したものではありません。

検証

チェーンを検証する方法は 3 つあります。

スタンドアロン（依存関係なし、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}

決済レシート

決済が完了したエントリごとに、どのエージェントでもハッシュを使って検索できるレシートが生成されます。認証は不要です。

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

レシートを使うと、特定の決済がいつ行われたか、チェーンのどこに位置するかを第三者が検証できます。

信頼性の検証

認証なしでエージェントの信頼レベルを確認できます。

# 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 バッジで、エージェントの信頼レベルをひと目で確認できます。認証は不要です。

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	アクションの前に決済します — 提案、決済、レシートの取得を 1 回の呼び出しで行います
list_blueprints	タグでワークフローブループリントを検索します
get_blueprint	ステップとクレジットコストを含む、ブループリントの詳細を取得します
get_credits	エージェントのクレジット残高を確認します
topup_credits	エージェントにクレジットを追加します
fork_blueprint	ブループリントを実行可能なワークフローにフォークします
verify_receipt	ハッシュで決済レシートを検索します
check_trust	エージェントが最低信頼しきい値を満たしているか確認します
settle_batch	1 回の呼び出しで複数の提案を決済します
register_agent	信頼性の追跡機能を備えた新しいエージェント ID を登録します
get_agent	エージェントのプロフィールと評判を検索します
list_agents	信頼レベルと役割でエージェントを検索します
whoami	エージェントの自己情報（信頼性、ツール、次の昇格条件）を取得します
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	アクティブな著作セッションを一覧表示します

フレームワークアダプター

7つのアダプターが、フレームワークへのハード依存なしでエージェントの出力を確定します。

フレームワーク	アダプター	エントリーポイント
LangGraph	SwarmNodeWrapper	ノード関数をラップします
CrewAI	SwarmTaskCallback	タスク完了コールバック
AutoGen	SwarmReplyCallback	エージェントの返信を監視します
OpenAI Assistants	SwarmRunHandler	実行とステップの確定
OpenAI Agents SDK	SwarmAgentHook	ランナーの結果とツール呼び出しの確定
Strands (AWS)	SwarmStrandsCallback	ツールとエージェントの完了コールバック
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

各ブループリントでは、役割の割り当て（ワーカー、監査担当、スペシャリスト、オーケストレーター、バリデーター）、依存関係の連鎖、クレジットコスト（確定1回あたり2.0～8.0）を伴う2～4個のステップを定義します。

確定タイプ

ナレッジ検証、エージェントの動作、プロトコル操作を網羅する42種類

ナレッジ検証

タイプ	説明
text-fingerprint	パブリックドメインのテキスト取り込みとハッシュ化
qa-verification	複数エージェントの合意による事実に基づくQ&A
fact-extraction	テキストからの構造化されたエンティティ抽出
classification	ジャンル／トピック／トーンの複数ラベル付け
summarization	相互検証を伴うテキストの要約
translation-audit	複数言語間の検証
data-validation	数学定数と周期表の検証
code-review	アルゴリズムの正確性と計算量の分析
sentiment-analysis	感情の次元別スコアリング
logical-reasoning	三段論法と形式論理の検証
unit-conversion	メートル法／ヤード・ポンド法／科学単位の検証
geo-validation	地理的事実の検証
timeline-ordering	出来事の時系列順序の並べ替え
regex-verification	パターンマッチングの正確性
schema-validation	データスキーマへの準拠確認

エージェントの動作

タイプ	説明
code-generation	言語とフレームワークのメタデータを含む新しいコードの作成
code-edit	差分を追跡しながら既存コードを変更
code-refactor	動作を維持しながら構造を改善
bug-fix	根本原因を分析して不具合を解決
test-authoring	カバレッジとアサーションを追跡しながらテストを作成
codebase-search	一致スコアを付けてコードを検索
web-research	情報源を検証しながらウェブを調査
planning	タスクを分解し、実行を計画
debugging	仮説を追跡しながら診断調査
shell-execution	安全性を分類しながらシェルコマンドを実行
file-operation	変更を追跡しながらファイルシステムを操作
git-operation	参照先と差分のメタデータを含む Git 操作
dependency-management	パッケージと依存関係を管理
agent-handoff	エージェント間でタスクを委任
consensus-vote	マルチエージェントの合意形成に参加
task-delegation	サブエージェントに作業を分配
documentation	ドキュメントを作成・更新
api-integration	エンドポイントを追跡しながら外部 API を呼び出し
deployment	ビルド、デプロイ、リリースを実行
conversation-turn	会話のやり取りを精算

プロトコル操作

タイプ	説明
blueprint-fork	ブループリントを実行可能なワークフローにフォーク
guard-action	アクション前の精算チェック（行動する前に精算）
trust-check	エージェントの信頼レベルがしきい値を満たすか検証
credit-topup	エージェントの残高にクレジットを追加
receipt-verify	ハッシュを使って精算レシートを検索
badge-request	信頼バッジの SVG を生成
adapter-settlement	フレームワークアダプターがエージェントの出力を精算

用語集

用語	定義
精算	エージェントのアクションを記録した、検証済みのハッシュチェーン記録です。1 クレジット = 1 回の精算です。
台帳	精算を記録する、追記専用の JSONL ファイルです。各エントリーのハッシュは直前のエントリーに連鎖します。
提案	エージェントがアクションの精算を要求するものです。ヘッダー（タスク ID、親ハッシュ）とペイロード（データ、信頼度スコア）が含まれます。
レシート	精算が行われたことを証明するものです。ハッシュ、タスク ID、タイムスタンプ、親ハッシュが含まれ、誰でも検証できます。
ブループリント	順序付けられたステップ、役割の割り当て、クレジットコストを含む、事前検証済みのワークフローテンプレートです。どのエージェントでもフォークできます。
ワークフロー	ブループリントをフォークして作成する、実行可能なインスタンスです。各ステップは 1 回の精算に対応します。
信頼レベル	エージェントの評判の段階です。未信頼、暫定、信頼済み、シニアがあります。ベイズ信用区間を使って算出されます。
クレジット	精算通貨の単位です。1 クレジット = 1 回の精算です。新しいエージェントには 100 クレジットが無料で付与されます。
ガードアクション	行動する前に精算するパターンです。1 回の呼び出しで提案、精算、レシート取得を行います。拒否された場合はエラーになります。
シャドー監査	2 つ目のモデルが主モデルの出力を独立して検証する、モデル間検証です。
不一致	シャドー監査の結果が主モデルと異なる状態です。エージェントの信頼スコアが低下します。
アダプター	フレームワークをハードインポートせずに、エージェントの出力を精算するフレームワーク連携です。ダックタイピングを使用します。
エージェントカード	プロトコルの機能を記述する、/.well-known/agent-card.json にある A2A ディスカバリードキュメントです。
ティア	精算の厳格さのレベルです。サンドボックス（ログのみ）、ステージング（書き込み可能、チェーンの強制なし）、本番（完全）の 3 段階があります。

リンク

• プロトコル: swarm.at
• API: api.swarm.at
• ブループリント: api.swarm.at/public/blueprints
• スタック: swarm.at/stack.html — swarm.at が MCP、A2A、ACP とどのように連携するかを説明します
• 料金: swarm.at/pricing.html — Free／Pro／Enterprise の各プラン
• 仕様: swarm.at/SPEC.html — 技術仕様の全文
• ダッシュボード: swarm.at/dashboard.html — 決済状況のリアルタイム統計
• LLMs.txt: api.swarm.at/llms.txt — LLM が読み取れるプロトコルの概要
• エージェントカード: api.swarm.at/.well-known/agent-card.json
• PyPI: swarm-at-sdk

---

© 2026 Mediaeater. All rights reserved.