swarm.at

Protocolo de liquidação que valida ações de agentes antes da execução. Protege operações destrutivas com recibos de ledger encadeados por hash, níveis de confiança e 31 modelos de fluxo de trabalho.

GitHub

Experimente este MCPPatrocinado

Documentação

swarm.at Ledger Público

Registro público encadeado por hash de liquidações verificadas de agentes. Somente acréscimo, à prova de adulteração, auditável por qualquer pessoa.

Cada entrada em ledger.jsonl é uma liquidação encadeada por hash SHA-256 que passou por todo o pipeline de verificação: verificação de integridade, limite de confiança e auditoria paralela. Modificar qualquer entrada quebra todos os hashes subsequentes.

Formato do Ledger

Cada linha em ledger.jsonl é um objeto JSON:

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

parent_hash vincula-se ao current_hash da entrada anterior (gênese = 0 x 64)
current_hash = SHA-256 da entrada com current_hash definido como ""
A cadeia é à prova de adulteração: modificar qualquer entrada quebra todos os hashes subsequentes

Algoritmo de Hash Canônico

Para verificar qualquer entrada:

Analise a linha JSON em um dicionário
Defina current_hash como "" (string vazia)
Serialize com json.dumps(entry, sort_keys=True).encode() (UTF-8)
Calcule hashlib.sha256(serialized).hexdigest()
Compare com o current_hash armazenado

A gênese (o parent_hash da primeira entrada) é sempre "0" * 64 (64 caracteres zero).

Proveniência dos Dados

As entradas neste ledger são dados de semente sintéticos gerados a partir de fontes de domínio público (textos do Project Gutenberg, constantes científicas, fatos geográficos). Eles demonstram o encadeamento por hash e o pipeline de verificação do protocolo de liquidação. Não são registros de interações reais entre agentes.

Verificação

Três maneiras de verificar a cadeia:

Autônomo (zero dependências, 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}

Recibos de Liquidação

Cada entrada liquidada produz um recibo que qualquer agente pode consultar por hash. Nenhuma autenticação é necessária.

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

Os recibos permitem que terceiros verifiquem que uma liquidação específica ocorreu, quando ocorreu e onde está na cadeia.

Verificação de Confiança

Verifique o nível de confiança de um agente sem autenticação:

# 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}}

Selos de Confiança

Selos SVG incorporáveis mostram o nível de confiança de um agente de relance. Nenhuma autenticação é necessária.

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

Cores: não confiável (vermelho), provisório (amarelo), confiável (verde), sênior (azul).

Servidor MCP

29 ferramentas disponíveis via Model Context Protocol:

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

Ferramenta	Descrição
settle_action	Validar uma ação contra regras institucionais
check_settlement	Consultar o status do ledger para uma tarefa ou hash
ledger_status	Estado atual da cadeia (último hash, contagem de entradas, integridade)
guard_action	Liquidar antes de agir — propor + liquidar + recibo em uma única chamada
list_blueprints	Navegar por blueprints de fluxo de trabalho por tag
get_blueprint	Detalhe completo do blueprint com etapas e custo de créditos
get_credits	Verificar o saldo de créditos de um agente
topup_credits	Adicionar créditos a um agente
fork_blueprint	Bifurcar um blueprint em um fluxo de trabalho executável
verify_receipt	Consultar um recibo de liquidação por hash
check_trust	Verificar se um agente atende a um limite mínimo de confiança
settle_batch	Liquidar múltiplas propostas em uma única chamada
register_agent	Registrar uma nova identidade de agente com rastreamento de confiança
get_agent	Consultar o perfil e a reputação de um agente
list_agents	Navegar por agentes por nível de confiança e função
whoami	Auto-introspecção do agente (confiança, ferramentas, próxima promoção)
execute_step	Executar uma única etapa de fluxo de trabalho em uma molécula
list_molecules	Listar moléculas de fluxo de trabalho ativas com progresso
get_molecule	Obter o estado completo da molécula com todas as contas
register_webhook	Assinar eventos de liquidação
list_webhooks	Listar assinaturas de webhook registradas
unregister_webhook	Remover uma assinatura de webhook
claim_authorship	Criar um registro de autoria verificável
verify_authorship	Verificar reivindicações de autoria por hash de conteúdo
start_writing_session	Começar a rastrear proveniência de autoria
record_writing_event	Registrar um evento criativo em uma sessão
approve_writing	Registrar aprovação final de conteúdo
get_provenance_report	Gerar um relatório de proveniência verificável
list_writing_sessions	Listar sessões de autoria ativas

Adaptadores de Framework

Sete adaptadores liquidam saídas de agentes com zero dependências rígidas do framework:

Framework	Adaptador	Ponto de Entrada
LangGraph	`SwarmNodeWrapper`	Envolve funções de nó
CrewAI	`SwarmTaskCallback`	Callback de conclusão de tarefa
AutoGen	`SwarmReplyCallback`	Observador de resposta do agente
OpenAI Assistants	`SwarmRunHandler`	Liquidação de execução e etapa
OpenAI Agents SDK	`SwarmAgentHook`	Liquidação de resultado do runner e chamada de ferramenta
Strands (AWS)	`SwarmStrandsCallback`	Callbacks de conclusão de ferramenta e agente
Haystack	`SwarmSettlementComponent`	Componente de pipeline que retorna recibos

Instale adaptadores via extras opcionais:

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]

Catálogo de Blueprints

58 blueprints pré-validados em 9 categorias:

Categoria	Contagem	Exemplos
Compras e Cadeia de Suprimentos	5	vendor-negotiation, purchase-approval, delivery-confirmation
Desenvolvimento de Software	5	code-review-pipeline, pr-merge-audit, incident-escalation
Finanças e Conformidade	5	invoice-matching, kyc-verification, financial-close
Conteúdo e Conhecimento	5	research-workflow, fact-checking, translation-verification
Operações de Cliente	5	escalation-routing, refund-approval, sla-compliance
Especialidade	6	audit-chain, healthcare-referral, insurance-adjudication
Operações de IA e ML	9	model-validation, training-pipeline, prompt-regression
Segurança e Conformidade	9	vulnerability-triage, access-review, incident-response
Engenharia de Dados	9	etl-pipeline, data-quality, schema-migration

Navegar: api.swarm.at/public/blueprints

Cada blueprint define 2-4 etapas com atribuições de função (trabalhador, auditor, especialista, orquestrador, validador), cadeias de dependência e custos de créditos (2,0-8,0 por liquidação).

Tipos de Liquidação

42 tipos cobrindo verificação de conhecimento, comportamentos de agentes e operações de protocolo

Verificação de Conhecimento

Tipo	Descrição
text-fingerprint	Ingestão de texto de domínio público + hash
qa-verification	Perguntas e respostas factuais com consenso multiagente
fact-extraction	Extração estruturada de entidades de texto
classification	Rotulagem multirrótulo de gênero/tópico/tom
summarization	Condensação de texto com verificação cruzada
translation-audit	Verificação entre idiomas
data-validation	Constantes matemáticas + verificação da tabela periódica
code-review	Correção de algoritmo + análise de complexidade
sentiment-analysis	Pontuação dimensional de sentimento
logical-reasoning	Verificação de silogismos e lógica formal
unit-conversion	Verificação de unidades métricas/imperiais/científicas
geo-validation	Verificação de fatos geográficos
timeline-ordering	Ordenação cronológica de eventos
regex-verification	Correção de correspondência de padrões
schema-validation	Verificação de conformidade de esquema de dados

Comportamentos de Agentes

Tipo	Descrição
code-generation	Criação de novo código com metadados de linguagem + framework
code-edit	Modificações em código existente com rastreamento de diff
code-refactor	Melhorias estruturais preservando comportamento
bug-fix	Resolução de defeitos com análise de causa raiz
test-authoring	Criação de testes com rastreamento de cobertura e asserções
codebase-search	Operações de busca de código com pontuação de correspondência
web-research	Pesquisa web com verificação de fontes
planning	Decomposição de tarefas e planejamento de execução
debugging	Investigação diagnóstica com rastreamento de hipóteses
shell-execution	Execução de comandos shell com classificação de segurança
file-operation	Operações de sistema de arquivos com rastreamento de alterações
git-operation	Operações Git com metadados de ref e diff
dependency-management	Gerenciamento de pacotes e dependências
agent-handoff	Delegação de tarefas entre agentes
consensus-vote	Participação em consenso multiagente
task-delegation	Distribuição de trabalho para subagentes
documentation	Criação e atualização de documentação
api-integration	Chamadas de API externas com rastreamento de endpoint
deployment	Operações de build, deploy e release
conversation-turn	Liquidação de troca conversacional

Operações de Protocolo

Tipo	Descrição
blueprint-fork	Blueprint bifurcado em fluxo de trabalho executável
guard-action	Verificação de liquidação pré-ação (liquide antes de agir)
trust-check	Verificação do nível de confiança do agente contra limite
credit-topup	Créditos adicionados ao saldo do agente
receipt-verify	Consulta de recibo de liquidação por hash
badge-request	Geração de selo SVG de confiança
adapter-settlement	Adaptador de framework liquidando saída de agente

Léxico

Termo	Definição
Liquidação	Um registro verificado e encadeado por hash de uma ação de agente. Um crédito = uma liquidação.
Ledger	Arquivo JSONL somente acréscimo onde as liquidações são registradas. O hash de cada entrada encadeia-se à anterior.
Proposta	A solicitação de um agente para liquidar uma ação. Contém um cabeçalho (ID da tarefa, hash pai) e carga útil (dados, pontuação de confiança).
Recibo	Prova de que uma liquidação ocorreu. Contém hash, ID da tarefa, timestamp e hash pai. Publicamente verificável.
Blueprint	Um modelo de fluxo de trabalho pré-validado com etapas ordenadas, atribuições de função e custo de créditos. Bifurcável por qualquer agente.
Fluxo de Trabalho	Uma instância executável de um blueprint. Criado por bifurcação. Cada etapa corresponde a uma liquidação.
Nível de Confiança	Nível de reputação do agente: não confiável, provisório, confiável, sênior. Calculado via intervalos credíveis bayesianos.
Crédito	Unidade de moeda de liquidação. 1 crédito = 1 liquidação. Novos agentes recebem 100 gratuitos.
Ação de Guarda	Padrão: liquide antes de agir. Propor, liquidar, obter recibo em uma única chamada. Gera erro em caso de rejeição.
Auditoria Paralela	Verificação entre modelos em que um segundo modelo verifica independentemente a saída do primário.
Divergência	Quando uma auditoria paralela discorda do primário. Penaliza a pontuação de confiança do agente.
Adaptador	Integração de framework que liquida saídas de agentes sem importar rigidamente o framework. Usa tipagem dinâmica.
Cartão de Agente	Documento de descoberta A2A em `/.well-known/agent-card.json` descrevendo as capacidades do protocolo.
Nível	Nível de rigor de liquidação: sandbox (somente registro), staging (gravações, sem aplicação de cadeia), produção (completo).