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

# Tester

> Validez vos workflows avant leur mise en production

Testez toujours vos workflows avant de les déployer. Les tests vous permettent de détecter les problèmes avant qu'ils n'impactent vos clients.

## Pourquoi tester ?

<CardGroup cols={2}>
  <Card title="Éviter les erreurs" icon="bug">
    Détectez les instructions mal formulées ou incomplètes avant la production.
  </Card>

  <Card title="Valider les cas limites" icon="code-branch">
    Vérifiez que votre workflow gère tous les scénarios possibles.
  </Card>

  <Card title="Gagner en confiance" icon="shield-check">
    Assurez-vous que le workflow répond correctement avant d'activer l'envoi automatique.
  </Card>

  <Card title="Éviter les régressions" icon="rotate-left">
    Relancez les tests après chaque modification pour vérifier que rien n'est cassé.
  </Card>
</CardGroup>

## Types de tests

<Tabs>
  <Tab title="Mode brouillon">
    **Testez avec de vrais tickets sans envoyer aux clients.**

    Le workflow génère des réponses sous forme de brouillons que vos agents peuvent réviser.

    **Idéal pour :**

    * Premier déploiement d'un workflow
    * Valider les performances sur de vrais tickets
    * Former votre équipe aux réponses générées

    **Comment faire :**

    1. Publiez le workflow sans activer l'autorésolution
    2. Les réponses apparaissent comme brouillons dans votre helpdesk
    3. Vos agents valident ou ajustent avant envoi
  </Tab>

  <Tab title="Scénarios de test">
    **Simulez des conversations pour valider le comportement.**

    Créez des scénarios qui représentent des situations réelles et définissez ce que le workflow doit faire.

    **Idéal pour :**

    * Tester des cas spécifiques avant le déploiement
    * Valider les cas limites et les erreurs
    * Tests de non-régression après modifications
  </Tab>
</Tabs>

## Créer des scénarios de test

<Steps>
  <Step title="Accédez aux tests">
    Depuis votre workflow, cliquez sur **"Sauvegarder le brouillon et tester"** ou sur l'onglet **Tests**.
  </Step>

  <Step title="Créez un scénario">
    Décrivez une situation client réaliste :

    ```
    Le client demande le statut de sa commande #12345.
    La commande a été expédiée hier avec Colissimo.
    ```
  </Step>

  <Step title="Définissez les critères de réussite">
    Indiquez ce que le workflow doit faire pour que le test réussisse.

    Voir la section "Critères de réussite" ci-dessous.
  </Step>

  <Step title="Lancez le test">
    L'IA simule la conversation et évalue si les critères sont respectés.
  </Step>

  <Step title="Analysez les résultats">
    Vérifiez ce qui a fonctionné et ce qui doit être amélioré.
  </Step>
</Steps>

## Critères de réussite

Définissez précisément ce que le workflow doit faire pour réussir le test.

<AccordionGroup>
  <Accordion title="tool_calls - Outils appelés" defaultOpen icon="wrench">
    Vérifiez que le workflow appelle les bons outils avec les bons paramètres.

    **Exemple :**

    ```
    Le workflow doit appeler @get_order_details avec le numéro de commande #12345
    ```

    **Utile pour :**

    * S'assurer que les données sont bien récupérées
    * Vérifier que les actions sont effectuées
  </Accordion>

  <Accordion title="mandatory_statement - Phrases obligatoires" icon="check">
    Vérifiez que certaines informations sont présentes dans la réponse.

    **Exemple :**

    ```
    La réponse doit mentionner le numéro de suivi Colissimo
    La réponse doit inclure la date de livraison estimée
    ```

    **Utile pour :**

    * Garantir que les infos importantes sont communiquées
    * Vérifier le respect des procédures
  </Accordion>

  <Accordion title="forbidden_statement - Phrases interdites" icon="ban">
    Vérifiez que certaines choses ne sont PAS dans la réponse.

    **Exemple :**

    ```
    La réponse ne doit pas mentionner de remboursement (pas demandé)
    La réponse ne doit pas promettre une livraison en moins de 24h
    ```

    **Utile pour :**

    * Éviter les engagements non souhaités
    * Respecter les limites du workflow
  </Accordion>
</AccordionGroup>

## Analyser les résultats

Après chaque test, vous voyez :

* **Réussite/Échec** de chaque critère
* **La conversation simulée** complète
* **Les outils appelés** et leurs résultats
* **La réponse générée** par le workflow

<img src="https://mintcdn.com/quivr/h2MKC8vnhvomNcDd/images/analyze-conversations.png?fit=max&auto=format&n=h2MKC8vnhvomNcDd&q=85&s=0bbf8cb5d7176c5c7d8cd4ab21e6cbb0" alt="Vue des résultats de tests" width="2378" height="1772" data-path="images/analyze-conversations.png" />

## Debugger les échecs

<AccordionGroup>
  <Accordion title="L'outil n'est pas appelé" icon="wrench">
    **Problème :** Le workflow n'appelle pas l'outil attendu.

    **Solutions :**

    * Vérifiez que l'outil est mentionné dans vos instructions
    * Soyez plus explicite : "Utilise @get\_order\_details pour..."
    * Vérifiez les conditions qui déclenchent l'appel
  </Accordion>

  <Accordion title="Information manquante dans la réponse" icon="message">
    **Problème :** La réponse ne contient pas une info attendue.

    **Solutions :**

    * Ajoutez une instruction explicite pour inclure cette info
    * Vérifiez que l'outil retourne bien cette donnée
    * Précisez le format attendu dans vos instructions
  </Accordion>

  <Accordion title="Mauvaise interprétation du scénario" icon="brain">
    **Problème :** Le workflow ne comprend pas la situation.

    **Solutions :**

    * Améliorez la description du déclencheur
    * Ajoutez des exemples positifs et négatifs
    * Soyez plus précis sur l'intention client
  </Accordion>

  <Accordion title="Escalade non déclenchée" icon="user-headset">
    **Problème :** Le workflow aurait dû escalader mais ne l'a pas fait.

    **Solutions :**

    * Ajoutez des conditions d'escalade explicites
    * Précisez les seuils (montant, complexité...)
    * Utilisez "Si... alors escalade vers un agent"
  </Accordion>
</AccordionGroup>

## Bonnes pratiques

<Steps>
  <Step title="Testez les cas courants">
    Créez des scénarios pour les 5-10 situations les plus fréquentes.
  </Step>

  <Step title="Testez les cas limites">
    Ajoutez des scénarios pour les situations problématiques : client mécontent, info manquante, erreur système.
  </Step>

  <Step title="Testez après chaque modification">
    Relancez vos tests après avoir modifié les instructions pour éviter les régressions.
  </Step>

  <Step title="Commencez en mode brouillon">
    Même si les tests passent, déployez d'abord en brouillon pour valider sur de vrais tickets.
  </Step>
</Steps>

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Bonnes pratiques" icon="star" href="/workflows/best-practices">
    Conseils pour créer des workflows efficaces
  </Card>

  <Card title="Déployer votre workflow" icon="rocket" href="/workflows/setup">
    Guide de mise en production
  </Card>
</CardGroup>