swarm.at

Protocolo de liquidación que valida las acciones del agente antes de la ejecución. Protege operaciones destructivas con recibos de ledger encadenados por hash, niveles de confianza y 31 planos de flujo de trabajo.

GitHub

Prueba este MCPPatrocinado

Documentación

Registro Público de swarm.at

Registro público encadenado por hash de acuerdos de agentes verificados. Solo anexión, a prueba de manipulación, auditable por cualquiera.

Cada entrada en ledger.jsonl es un acuerdo encadenado por hash SHA-256 que superó el pipeline de verificación completo: verificación de integridad, umbral de confianza y auditoría en sombra. Modificar cualquier entrada rompe todos los hashes subsiguientes.

Formato del Registro

Cada línea en ledger.jsonl es un 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 enlaza con el current_hash de la entrada anterior (génesis = 0 x 64)
current_hash = SHA-256 de la entrada con current_hash establecido en ""
La cadena es a prueba de manipulación: modificar cualquier entrada rompe todos los hashes subsiguientes

Algoritmo de Hash Canónico

Para verificar cualquier entrada:

Analizar la línea JSON en un dict
Establecer current_hash a "" (cadena vacía)
Serializar con json.dumps(entry, sort_keys=True).encode() (UTF-8)
Calcular hashlib.sha256(serialized).hexdigest()
Comparar con el current_hash almacenado

El génesis (el parent_hash de la primera entrada) es siempre "0" * 64 (64 caracteres cero).

Procedencia de los Datos

Las entradas de este registro son datos semilla sintéticos generados a partir de fuentes de dominio público (textos del Proyecto Gutenberg, constantes científicas, hechos geográficos). Demuestran el encadenamiento por hash y el pipeline de verificación del protocolo de acuerdos. No son registros de interacciones reales de agentes.

Verificación

Tres formas de verificar la cadena:

Independiente (cero dependencias, 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 Acuerdos

Cada entrada acordada produce un recibo que cualquier agente puede consultar por hash. No se requiere autenticación.

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

Los recibos permiten a terceros verificar que un acuerdo específico ocurrió, cuándo ocurrió y dónde se ubica en la cadena.

Verificación de Confianza

Consulta el nivel de confianza de un agente sin autenticación:

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

Insignias de Confianza

Las insignias SVG incrustables muestran el nivel de confianza de un agente de un vistazo. No se requiere autenticación.

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

Colores: no confiable (rojo), provisional (amarillo), confiable (verde), senior (azul).

Servidor MCP

29 herramientas disponibles a través del Model Context Protocol:

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

Herramienta	Descripción
settle_action	Validar una acción contra reglas institucionales
check_settlement	Consultar el estado del registro para una tarea o hash
ledger_status	Estado actual de la cadena (último hash, número de entradas, integridad)
guard_action	Acordar antes de actuar — proponer + acordar + recibo en una sola llamada
list_blueprints	Explorar plantillas de flujos de trabajo por etiqueta
get_blueprint	Detalle completo de la plantilla con pasos y costo de créditos
get_credits	Consultar el saldo de créditos de un agente
topup_credits	Añadir créditos a un agente
fork_blueprint	Bifurcar una plantilla en un flujo de trabajo ejecutable
verify_receipt	Buscar un recibo de acuerdo por hash
check_trust	Verificar si un agente cumple un umbral mínimo de confianza
settle_batch	Acordar múltiples propuestas en una sola llamada
register_agent	Registrar una nueva identidad de agente con seguimiento de confianza
get_agent	Consultar el perfil y la reputación de un agente
list_agents	Explorar agentes por nivel de confianza y rol
whoami	Auto-introspección del agente (confianza, herramientas, próxima promoción)
execute_step	Ejecutar un solo paso de flujo de trabajo en una molécula
list_molecules	Listar moléculas de flujos de trabajo activas con su progreso
get_molecule	Obtener el estado completo de la molécula con todas las cuentas
register_webhook	Suscribirse a eventos de acuerdos
list_webhooks	Listar suscripciones de webhook registradas
unregister_webhook	Eliminar una suscripción de webhook
claim_authorship	Crear un registro de autoría verificable
verify_authorship	Verificar reclamos de autoría por hash de contenido
start_writing_session	Iniciar el seguimiento de procedencia de autoría
record_writing_event	Registrar un evento creativo en una sesión
approve_writing	Registrar la aprobación final del contenido
get_provenance_report	Generar un informe de procedencia verificable
list_writing_sessions	Listar sesiones de autoría activas

Adaptadores de Frameworks

Siete adaptadores acuerdan salidas de agentes con cero dependencias duras del framework:

Framework	Adaptador	Punto de Entrada
LangGraph	`SwarmNodeWrapper`	Envuelve funciones de nodo
CrewAI	`SwarmTaskCallback`	Callback de finalización de tarea
AutoGen	`SwarmReplyCallback`	Observador de respuestas del agente
OpenAI Assistants	`SwarmRunHandler`	Acuerdo de ejecución y pasos
OpenAI Agents SDK	`SwarmAgentHook`	Acuerdo de resultado del runner y llamadas de herramienta
Strands (AWS)	`SwarmStrandsCallback`	Callbacks de finalización de herramienta y agente
Haystack	`SwarmSettlementComponent`	Componente de pipeline que devuelve recibos

Instala los adaptadores mediante extras opcionales:

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 Plantillas

58 plantillas pre-validadas en 9 categorías:

Categoría	Cantidad	Ejemplos
Adquisiciones y Cadena de Suministro	5	vendor-negotiation, purchase-approval, delivery-confirmation
Desarrollo de Software	5	code-review-pipeline, pr-merge-audit, incident-escalation
Finanzas y Cumplimiento	5	invoice-matching, kyc-verification, financial-close
Contenido y Conocimiento	5	research-workflow, fact-checking, translation-verification
Operaciones de Cliente	5	escalation-routing, refund-approval, sla-compliance
Especialidad	6	audit-chain, healthcare-referral, insurance-adjudication
Operaciones de IA y ML	9	model-validation, training-pipeline, prompt-regression
Seguridad y Cumplimiento	9	vulnerability-triage, access-review, incident-response
Ingeniería de Datos	9	etl-pipeline, data-quality, schema-migration

Explorar: api.swarm.at/public/blueprints

Cada plantilla define 2-4 pasos con asignaciones de roles (trabajador, auditor, especialista, orquestador, validador), cadenas de dependencias y costos de créditos (2.0-8.0 por acuerdo).

Tipos de Acuerdos

42 tipos que cubren verificación de conocimiento, comportamientos de agentes y operaciones de protocolo

Verificación de Conocimiento

Tipo	Descripción
text-fingerprint	Ingestión de texto de dominio público + hash
qa-verification	Preguntas y respuestas factuales con consenso multi-agente
fact-extraction	Extracción estructurada de entidades a partir de texto
classification	Etiquetado multi-etiqueta de género/tema/tono
summarization	Condensación de texto con verificación cruzada
translation-audit	Verificación entre idiomas
data-validation	Verificación de constantes matemáticas y tabla periódica
code-review	Corrección de algoritmos + análisis de complejidad
sentiment-analysis	Puntuación dimensional de sentimiento
logical-reasoning	Verificación de silogismos y lógica formal
unit-conversion	Verificación de unidades métricas/imperiales/científicas
geo-validation	Verificación de hechos geográficos
timeline-ordering	Ordenamiento cronológico de eventos
regex-verification	Corrección de coincidencia de patrones
schema-validation	Verificación de conformidad de esquemas de datos

Comportamientos de Agentes

Tipo	Descripción
code-generation	Creación de nuevo código con metadatos de lenguaje y framework
code-edit	Modificaciones a código existente con seguimiento de diff
code-refactor	Mejoras estructurales que preservan el comportamiento
bug-fix	Resolución de defectos con análisis de causa raíz
test-authoring	Creación de pruebas con seguimiento de cobertura y aserciones
codebase-search	Operaciones de búsqueda de código con puntuación de coincidencias
web-research	Investigación web con verificación de fuentes
planning	Descomposición de tareas y planificación de ejecución
debugging	Investigación diagnóstica con seguimiento de hipótesis
shell-execution	Ejecución de comandos de shell con clasificación de seguridad
file-operation	Operaciones del sistema de archivos con seguimiento de cambios
git-operation	Operaciones de git con metadatos de ref y diff
dependency-management	Gestión de paquetes y dependencias
agent-handoff	Delegación de tareas entre agentes
consensus-vote	Participación en consenso multi-agente
task-delegation	Distribución de trabajo a sub-agentes
documentation	Creación y actualización de documentación
api-integration	Llamadas a APIs externas con seguimiento de endpoints
deployment	Operaciones de build, deploy y release
conversation-turn	Acuerdo de intercambio conversacional

Operaciones de Protocolo

Tipo	Descripción
blueprint-fork	Plantilla bifurcada en flujo de trabajo ejecutable
guard-action	Verificación de acuerdo previo a la acción (acordar antes de actuar)
trust-check	Verificación del nivel de confianza del agente contra umbral
credit-topup	Créditos añadidos al saldo del agente
receipt-verify	Búsqueda de recibo de acuerdo por hash
badge-request	Generación de insignia de confianza SVG
adapter-settlement	Adaptador de framework que acuerda la salida del agente

Léxico

Término	Definición
Acuerdo	Un registro verificado y encadenado por hash de una acción de agente. Un crédito = un acuerdo.
Registro	Archivo JSONL de solo anexión donde se registran los acuerdos. El hash de cada entrada se encadena con la anterior.
Propuesta	La solicitud de un agente para acordar una acción. Contiene un encabezado (ID de tarea, hash padre) y una carga útil (datos, puntuación de confianza).
Recibo	Prueba de que ocurrió un acuerdo. Contiene hash, ID de tarea, marca de tiempo y hash padre. Verificable públicamente.
Plantilla	Una plantilla de flujo de trabajo pre-validada con pasos ordenados, asignaciones de roles y costo de créditos. Bifurcable por cualquier agente.
Flujo de trabajo	Una instancia ejecutable de una plantilla. Se crea mediante bifurcación. Cada paso corresponde a un acuerdo.
Nivel de confianza	Nivel de reputación del agente: no confiable, provisional, confiable, senior. Calculado mediante intervalos creíbles bayesianos.
Crédito	Unidad de moneda de acuerdos. 1 crédito = 1 acuerdo. Los agentes nuevos reciben 100 gratis.
Acción de guardia	Patrón: acordar antes de actuar. Proponer, acordar, obtener recibo en una sola llamada. Genera error al ser rechazada.
Auditoría en sombra	Verificación entre modelos donde un segundo modelo verifica de forma independiente la salida del principal.
Divergencia	Cuando una auditoría en sombra discrepa con la principal. Penaliza la puntuación de confianza del agente.
Adaptador	Integración de framework que acuerda salidas de agentes sin importar duramente el framework. Usa tipado dinámico.
Tarjeta de agente	Documento de descubrimiento A2A en `/.well-known/agent-card.json` que describe las capacidades del protocolo.
Nivel	Nivel de estrictez de acuerdos: sandbox (solo registro), staging (escrituras, sin aplicación de cadena), producción (completo).

Enlaces

Protocolo: swarm.at
API: api.swarm.at
Plantillas: api.swarm.at/public/blueprints
Stack: swarm.at/stack.html — dónde encaja swarm.at junto a MCP, A2A y ACP
Precios: swarm.at/pricing.html — niveles Gratis / Pro / Empresa
Especificación: swarm.at/SPEC.html — especificación técnica completa
Panel: swarm.at/dashboard.html — estadísticas de acuerdos en vivo
LLMs.txt: api.swarm.at/llms.txt — resumen del protocolo legible por LLM
Tarjeta de agente: api.swarm.at/.well-known/agent-card.json
PyPI: swarm-at-sdk