> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent de réflexion

> L'agent de réflexion stratégique du moteur V1 : il analyse la conversation, applique la stratégie et produit la directive de rédaction.

Le **ThinkingAgent** est l'[agent](/fr/advanced/agents/agent) de réflexion stratégique du [moteur V1](/fr/advanced/jobs/autoreply#moteur-v1). C'est le « cerveau » de la chaîne : il analyse la conversation, intègre les instructions de la [stratégie](/fr/advanced/jobs/autoreply#workflow), puis produit une **directive de rédaction** que le [RedactionAgent](/fr/advanced/agents/redaction-agent) transformera en messages.

## Fonctionnement

Le ThinkingAgent fonctionne en boucle **ReAct** (réflexion + outils, jusqu'à 8 itérations, timeout 120 s) sur une fenêtre des **15 derniers messages** de la conversation :

1. Il reçoit le **bloc stratégie** (contexte, objectifs, règles injectés par les règles qui ont matché) ainsi que le **plan stratégique** noté au tour précédent (visible `[PLAN]` dans la trace).
2. Il peut appeler ses outils pour compléter son analyse, notamment `search_rag` pour interroger la [mémoire long-terme](/fr/advanced/agents/search-rag-agent) du créateur.
3. Il conclut avec une **directive de rédaction** (quoi dire, sur quel ton, avec quel objectif) et un nouveau **plan stratégique** pour la prochaine réponse.

### Vérification de la réflexion (Chain-of-Verification)

Avant d'être transmise au RedactionAgent, la directive est relue par le [ValidationAgent](/fr/advanced/agents/validation-agent). En cas de refus, le ThinkingAgent reçoit le motif exact et produit une directive corrigée, jusqu'à **3 tentatives**. Ce contrôle évite les directives incohérentes avec la persona ou la stratégie.

### Décisions de fin et de pause

Le ThinkingAgent dispose des outils `leave_on_read` et `conversation_pause` (partagés avec le [ReplyAgent](/fr/advanced/agents/reply-agent) en V2) :

* **`leave_on_read`** : laisse le fan **sur « vu »** sans répondre. Les réponses automatiques sont suspendues jusqu'à **l'heure de contact optimale** de l'utilisateur (calculée selon ses habitudes, sinon +8 h), et une **relance** est automatiquement planifiée à cette échéance pour reprendre contact naturellement.
* **`conversation_pause`** : suspend l'échange jusqu'à une **date de reprise** choisie par l'agent (ex. l'utilisateur a dit « je pars au travail »). Une relance avec réflexion complète est planifiée à la reprise.

Dans les deux cas, un **message système** documente la décision dans la conversation et le job se termine en succès, sans envoi.

<Note>
  C'est pourquoi une conversation laissée « sur vu » peut **redémarrer plus tard** : la relance planifiée par `leave_on_read` relance la machine au moment optimal. Pour stopper définitivement un utilisateur, désactivez `Enable AutoReply` sur sa fiche.
</Note>

## Cas particuliers

* **Relances sans réflexion** : si une relance est configurée sans l'option *Thinking*, le ThinkingAgent est **sauté** et son instruction de relance est transmise telle quelle au RedactionAgent.
* **Échec de l'agent** : si le ThinkingAgent échoue, le moteur V1 continue avec une directive vide (le RedactionAgent répond alors librement). Le diagnostic figure dans la trace.
* **Réponse vocale** : pour l'intention vocale, la directive du ThinkingAgent est transmise au [Rédacteur vocal](/fr/advanced/agents/vocal-redaction-agent) au lieu du RedactionAgent.

## Configuration

Le modèle IA du ThinkingAgent se choisit dans **Admin** > **Chatting Auto** > **Agents**. Sa réflexion étant la matière première de la réponse, privilégiez un modèle avec de bonnes capacités de raisonnement.

## Voir aussi

* [ValidationAgent](/fr/advanced/agents/validation-agent) — Le vérificateur de ses directives.
* [RedactionAgent](/fr/advanced/agents/redaction-agent) — Le consommateur de ses directives.
* [Réponses automatiques](/fr/advanced/jobs/autoreply) — Le workflow complet.
