> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟥 Reconnaissance de mots

# 🟥 Reconnaissance de mots

${frame}[Vidéo : anatomie du bloc Reconnaissance de mots](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/wordsrecognition.html)

![Reconnaissance de mots](https://celestory-docs-illustrations.netlify.app/fr/Reconnaissancedemots_FR.svg)

Le bloc Reconnaissance de mots permet de repérer certains mots dans un texte tapé par le joueur, et de déclencher une action différente selon les mots trouvés.

Il est très utile pour créer des interactions basées sur ce que le joueur écrit : par exemple répondre à une question ouverte, ou déclencher une action selon une commande tapée au clavier.

## 📥 Entrées

-   input (Texte) : Le texte à analyser, généralement saisi par le joueur (ex : via un bloc Saisie de texte).
-   mots (Liste de Tags, constante) : La liste des groupes de mots-clés à reconnaître. Dans un même groupe, on regroupe les mots qui veulent dire la même chose (ex : "bonjour", "salut", "hello").

## 📤 Sorties

-   nom_sortie (Flux) : Sortie déclenchée lorsque le texte saisi correspond à l'un des groupes de mots-clés définis dans l'entrée mots. Une sortie est créée automatiquement pour chaque groupe.
-   non_trouvé (Flux) : Sortie déclenchée si le texte saisi ne correspond à aucun groupe configuré.

## 💡 Exemple d'utilisation

Scénario : un assistant qui répond à des mots simples

1. Le joueur tape un message dans un bloc Saisie de texte.
1. Ce texte est envoyé à l'entrée input du bloc Reconnaissance de mots.
1. Dans l'entrée mots, on crée deux groupes :

- Groupe 1 : "bonjour", "salut", "hello" → sortie salutation
- Groupe 2 : "au revoir", "bye" → sortie fin_conversation

1. Si le joueur écrit "bonjour", le flux part par la sortie salutation et déclenche une réponse adaptée.
1. Si le joueur écrit "merci", aucun groupe ne correspond : le flux part par la sortie non_trouvé et affiche un message par défaut.

## ⚙️ Détails Techniques

-   Configuration des mots-clés :
- Dans un même groupe, on peut mettre plusieurs mots ou phrases (un par ligne, avec Shift + Entrée).
- Tous les mots d'un même groupe activent la même sortie.
- La recherche est "floue" : elle tolère les petites fautes de frappe ou variations dans le texte tapé.
-   Connexion nécessaire : Ce bloc a besoin d'une source de texte en entrée (ex : Saisie de texte, Variable, API).

---

*Version documentée : v2*