1
Advanced-Reflection
Augustin ROUX edited this page 2026-04-27 08:46:42 +00:00

Réflexion avancée

Toggle disponible dans la barre d'envoi de Muyue Studio depuis v0.6.0.

Principe

Quand le toggle est activé, chaque question utilisateur déclenche un pipeline à deux étages :

  1. Étage 1 — Provider inactif : un fournisseur AI configuré mais non actif produit un rapport préalable d'analyse (max 15 lignes, pas de code, pas d'action) couvrant :
    • reformulation de l'objectif
    • points à clarifier ou risques
    • approche structurée suggérée
  2. Étage 2 — Provider actif : le rapport est injecté dans le prompt envoyé au fournisseur actif sous forme d'un bloc [RAPPORT PRÉALABLE]. L'IA active reçoit donc à la fois la question originale ET l'analyse d'un autre modèle, puis répond / agit.

Pré-requis

  • Au moins deux fournisseurs configurés avec une clé API
  • L'un est marqué active, l'autre sert de "réflexion"
  • Si aucun provider inactif n'est dispo, le toggle est ignoré silencieusement (fallback chat normal)

Pourquoi l'utiliser

  • Sur des demandes ambiguës ("améliore ce module") — un second modèle apporte une perspective complémentaire avant l'exécution
  • Pour réduire les boucles d'itération sur des tâches complexes
  • Pour comparer implicitement deux modèles sans changer de provider actif

Coût

Une requête supplémentaire (au provider inactif) à chaque message. Le rapport est court (<15 lignes) donc ~500 tokens en plus en moyenne.

API

Endpoint : POST /api/chat

{
  "message": "...",
  "stream": true,
  "advanced_reflection": true   // <-- nouveau champ
}

Backend : internal/orchestrator/orchestrator.go::NewForInactiveProvider + SendNoTools, et internal/api/handlers_chat.go::runReflectionReport.