✨ A2A: Plan d'amélioration des conversations inter-agents

[up-guillaume]

Objectif

Mettre en place un système universel pour éliminer les hallucinations et améliorer l'efficacité des conversations A2A.

Plan en 4 Piliers

Pilier 1 : Agent Template System

• Créer un template de tools de base pour tous les agents
• Auto-assignation des tools essentiels (send_file_to_agent, list_my_tools, etc.)
• Impact : 100% des agents auront les mêmes capabilities de base

Pilier 2 : Capability Verification Protocol

• Créer tools : list_my_tools, check_tool_availability
• Forcer les agents à vérifier leurs capabilities avant toute conversation A2A
• Impact : Élimine 90% des hallucinations

Pilier 3 : A2A Communication Protocol

• Documenter dans docs/A2A_COMMUNICATION_PROTOCOL.md
• Ajouter capability check obligatoire au system prompt
• Anti-loop rules (3-strike rule, evidence requirement)
• Impact : Réduit 80% des boucles de feedback

Pilier 4 : Shared Context Layer

• Injection automatique des capabilities dans le contexte
• Contexte partagé entre agents
• Impact : Agents conscients de leurs capabilities dès le début

Métriques de Succès

• 100% des agents ont les tools de base
• 0% d'hallucinations sur les capabilities
• 50% de réduction de la durée des conversations A2A
• 95% de taux de réussite A2A

Plan d'Exécution

Phase 1 : Quick Wins (Aujourd'hui)

• Assigner send_file_to_agent à tous les agents (30 min)
• Créer list_my_tools et check_tool_availability (2h)
• Rédiger A2A_COMMUNICATION_PROTOCOL.md (1h)
• Ajouter capability check au system prompt (30 min)

Phase 2 : Systemic Fixes (Cette semaine)

• Créer Agent Template System (4h)
• Implémenter Shared Context Layer (6h)
• Ajouter anti-loop detection (3h)
• Créer tests de conversation A2A (4h)

Phase 3 : Long-term (Prochain mois)

• A2A conversation monitoring (8h)
• Capability verification dashboard (6h)
• Automated hallucination detection (10h)

Dépendances

• Issue 🔴 A2A: Agents hallucinent sur leurs capabilities #743 (hallucinations)
• Issue ✨ A2A: Plan d'amélioration des conversations inter-agents #744 (Lark MCP)
• Issue 🔴 Lark MCP: 61 tools avec schemas vides #745 (AgentBay MCP)

Priorité

🔴 CRITIQUE — Amélioration systémique de toutes les conversations A2A

[up-guillaume]

✅ Pilier 2 Terminé : Capability Verification Tools

Actions effectuées

1. Tools créés :

   • list_my_tools(filter, include_schema) : Liste tous les tools disponibles
   • check_tool_availability(tool_name) : Vérifie si un tool spécifique existe
   • get_my_capabilities() : Résumé des capacités de l'agent

2. Seeder créé : capability_verification_seeder.py

   • Crée les 3 tools au startup
   • Les assigne automatiquement à tous les agents actifs

3. Intégration au startup : Ajouté dans main.py

   • Les tools sont créés et assignés à chaque redémarrage

4. Tests validés :

   • ✅ ePassLive PM : 1299 tools disponibles
   • ✅ check_tool_availability fonctionne pour tools existants et non-existants
   • ✅ get_my_capabilities retourne un résumé complet

5. Documentation : docs/A2A_COMMUNICATION_PROTOCOL.md

   • Protocole complet pour les conversations A2A
   • Exemples de bonnes et mauvaises pratiques
   • Anti-loop rules

Impact attendu

• Élimine 90% des hallucinations sur les capabilities
• Les agents vérifient leurs tools avant de faire des claims
• Conversations A2A plus efficaces

Commits

• c57361de feat(agents): add capability verification tools
• 873a3b81 docs(a2a): add A2A communication protocol

Prochaines étapes

• Pilier 1 : Agent Template System (auto-assign des tools de base)
• Pilier 3 : A2A Protocol (déjà documenté, à intégrer dans les system prompts)
• Pilier 4 : Shared Context Layer (injection automatique des capabilities)

[up-guillaume]

⚠️ SSH Bridge MCP — Pas au niveau de ClickUp/Hetzner

Problèmes identifiés

1. 357 doublons : 357 tools avec préfixe mcp_ssh_bridge- + 357 sans préfixe
2. Schemas basiques : Seulement host + quelques propriétés, pas de descriptions/types/enums
3. Source custom : Fichier Python custom (mcp-ssh-bridge-eager.py), pas un package npm

Comparaison avec ClickUp/Hetzner

Aspect	ClickUp/Hetzner	SSH Bridge
Schemas	Complets (descriptions, types, enums, required)	Basiques (juste host)
Source	Package npm avec schemas extraits	Fichier custom avec génération dynamique
Doublons	0	357
Maturité	🟢 100%	🟡 Superficiel

Actions requises

1. Supprimer les 357 doublons (30 min)
2. Améliorer les schemas (4-8h)
3. Tests E2E (1h)

Issue dédiée

#755 — 🔴 SSH Bridge MCP: 357 doublons + schemas basiques

Impact sur le plan A2A

SSH Bridge ne peut pas être utilisé comme référence pour le Capability Verification Protocol car ses schemas sont trop basiques. Les agents ne pourront pas vérifier efficacement leurs capabilities SSH Bridge.

Recommandation : Traiter SSH Bridge séparément, après avoir stabilisé les autres MCPs.