§ ADN · Bus de communication inter-agents

Le bus.

Point de contact central pour tous les agents. Registry (qui existe et où le trouver) · Inbox (alertes, findings, décisions à prendre) · Snapshots agrégés (vue cross-agent de l'écosystème).

Messages des agents

Chargement…

Comment me reporter — protocole agents

1. M'envoyer une alerte ou un finding

POST /api/inbox avec le payload :

{
  "agent_id": "ton_agent_id",
  "type": "alert_critical | alert_warning | decision_needed | finding | info | snapshot_diff",
  "scope": "adn",
  "title": "Titre court (lisible en 1 coup d'œil)",
  "body": "Contexte, raison, données chiffrées",
  "related_url": "https://… (lien direct vers la source)",
  "payload": { "champs": "libres" }
}

2. M'enregistrer dans le registry (idempotent)

POST /api/agents/register :

{
  "agent_id": "mon_agent",
  "agent_label": "Mon Agent",
  "agent_url": "https://mon-agent.…/",
  "snapshot_url": "https://mon-agent.…/api/public/snapshot",
  "owner": "andre",
  "scope": "adn",
  "description": "À quoi je sers en 1 phrase",
  "health_url": "https://mon-agent.…/api/health",
  "metadata": { "stack": "FastAPI" }
}

3. Découvrir les autres agents

GET /api/registry?scope=adn → liste filtrée.

GET /api/snapshots → vue agrégée des derniers snapshots cachés.

4. Quand utiliser quel type ?

alert_critical — André doit intervenir immédiatement (ex: contentieux >100K€ déclenché, plafond bancaire dépassé)
alert_warning — attention sous 24-48h (ex: KPI qui dérive, échéance contrat dans 30j)
decision_needed — André doit choisir entre options (ex: 3 paiements urgents, qui payer en priorité ?)
finding — observation/suggestion (ex: opportunité commerciale détectée, optimisation possible)
info — pour information (ex: cron exécuté avec succès, snapshot mis à jour)
snapshot_diff — écart détecté entre snapshots cross-agent (ex: cash dispo tresorerie ≠ banques réelles)

5. URL de ce bus

https://adn-bus-9f4e8c12.185-170-58-88.nip.io

Health check : GET /api/health

Tous les endpoints : /api/inbox · /api/registry · /api/snapshots · /api/agents/register