# Recherche sémantique

La recherche sémantique dans le type de correspondance des blocs — c’est une IA entraînée à extraire le contexte à partir des conditions intégrées dans le message du client.

Les blocs sont prioritaires par rapport à l’assistant IA, vous pouvez donc utiliser un bloc avec une condition et une option de correspondance « comparaison de sens » si vous souhaitez envoyer au client une réponse clairement vérifiée et prédéfinie.

## Fonctionnement

La recherche sémantique compare le **sens** entre le message d’un utilisateur et des conditions prédéfinies, plutôt que de s’appuyer sur une correspondance exacte des mots-clés.

**Principe de base**

Le système analyse le **contexte et l’intention** dans le message de l’utilisateur et recherche une correspondance avec le **sens intégré dans la condition de déclenchement**.

**Flux de traitement**

1. L’IA extrait le sens sémantique du message du client.
2. Le système compare ce sens aux expressions sémantiques définies dans les conditions du déclencheur.
3. Si une **correspondance sémantique** est trouvée, le chatbot traite l’événement correspondant dans le bloc (par exemple, l’envoi d’un message spécifique).

**Exemple**

Dans la condition, nous définissons une expression sémantique (par exemple, *« clôture des comptes et actes »*). Si l’IA identifie ce sens dans la remarque de l’utilisateur, elle déclenche le bloc d’événement associé.

<div data-with-frame="true"><figure><img src="/files/cf0d3ab738da17a38aac9829bb877466295a4abf" alt=""><figcaption></figcaption></figure></div>

Voici à quoi ressemble le paramétrage du bloc :

<div data-with-frame="true"><figure><img src="/files/1ed32e0a13cc8e7a8d00286895d6dcbe562cd784" alt="" width="563"><figcaption></figcaption></figure></div>

Lors du choix d’une correspondance « Recherche sémantique », le bot doit trouver dans le message du client des mots/expressions de sens similaire, qui sont basés sur le déclencheur du bloc :

<div data-with-frame="true"><figure><img src="/files/ce3637797423021526d04e6467b743aee06572f6" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/b07df8e25f55d4cca1a46d4e9a347e9f517ba503" alt="" width="563"><figcaption></figcaption></figure></div>

Chaque fois que le bot traite le message du client, il exécute correctement l’événement nécessaire dans le bloc.

## Comment écrire un déclencheur

Le déclencheur dans le champ correspondant est rédigé de la même manière que les autres déclencheurs pour toute sélection de correspondance :

<div data-with-frame="true"><figure><img src="/files/96c2833634e3de9ef20aadcc71482b048d47460d" alt="" width="563"><figcaption></figcaption></figure></div>

Créer des conditions claires, concises et précises est essentiel pour **les performances, la fiabilité et l’expérience utilisateur**. Voici pourquoi c’est important :

* **Traitement correct :** Des conditions précises garantissent que le chatbot identifie et exécute correctement l’événement prévu.
* **Vitesse de traitement :** Des expressions complexes, ambiguës ou verbeuses augmentent le temps de traitement de l’IA et peuvent dégrader la vitesse de réponse.
* **Fiabilité du schéma :** Une formulation vague accroît le risque de mauvaise interprétation, ce qui peut entraîner un comportement incorrect de votre workflow.

Évitez dans vos conditions les mots trop complexes, les termes ambigus et les longues expressions composées de plusieurs phrases.

**Exemple d’une condition de déclenchement efficace**

<div data-with-frame="true"><figure><img src="/files/0b2fcedbffaaf8671acdbbe395e28456e01e5c38" alt="" width="563"><figcaption></figcaption></figure></div>

Un exemple de <mark style="color:red;">**condition de déclenchement INcorrecte**</mark>:

<div data-with-frame="true"><figure><img src="/files/400a116b6e07613812124fa53759dc5673970336" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="danger" %}
**Évitez les conditions de déclenchement à un seul mot**

Bien que les conditions doivent être concises, elles doivent aussi être **porteuses de sens sémantique**. Un seul mot (par exemple, « facture ») manque souvent de contexte pour une correspondance sémantique précise.

**Utilisez des expressions descriptives**

Au lieu de mots isolés, utilisez de courtes expressions descriptives qui traduisent l’intention.

**Exemple :**

❌ `« facture »`\
✅ `« paiement de facture mensuelle »`

Cela fournit un contexte plus clair au modèle d’IA pour effectuer une comparaison sémantique précise.

**Principe clé**

L’IA compare le *sens* des conditions, et pas seulement les mots-clés. Une expression bien définie établit les critères sémantiques nécessaires à une correspondance fiable.
{% endhint %}

### **Exemple**

Lorsque vous rédigez des déclencheurs plus détaillés pour la recherche sémantique, l’IA comprend le contexte et répond rapidement.

<div data-with-frame="true"><figure><img src="/files/7f7dc83ede3a85e84afc8992bfc9e416f05a5882" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/e151d44ed1e25184d210ca123e35243bcb4e8e60" alt="" width="563"><figcaption></figcaption></figure></div>

Si vous définissez une condition de déclenchement en utilisant uniquement un **mot unique** (comme dans l’exemple ci-dessous), l’IA peut **ne pas détecter suffisamment de contexte** et ne déclenchera pas de réponse, ce qui se traduira par une absence de réaction.

<div data-with-frame="true"><figure><img src="/files/9c736a0f5feab5d35285fae72ab3f707a8ccbc25" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/629e3a963715cdafbc647bf1f4eab9f73e5c95d9" alt="" width="563"><figcaption></figcaption></figure></div>

De plus, le bloc avec les bons paramètres ne fonctionne pas, car l’IA ne peut pas trouver le déclencheur du bon bloc dans le message du client et ne peut lui envoyer aucun message.

{% hint style="warning" %}

#### Attention

De plus, si le déclencheur de la recherche sémantique est incorrect (trop court ou ambigu), l’IA peut répondre à de tels déclencheurs au mauvais moment ou au mauvais endroit.
{% endhint %}

## **Exemple de chatbot IA pour station intelligente**

{% hint style="success" %}
Dans cet exemple, nous allons démontrer clairement la priorité des blocs sur les assistants IA et la recherche par contexte dans le message du client avec le choix du type Recherche sémantique.
{% endhint %}

Dans le constructeur de chatbot, nous créons deux blocs « Start », dans chacun desquels nous choisissons le type « Recherche sémantique » et le message « Allumer/éteindre la lumière » :

1. Bloc 1 « Allumer la lumière »

<div data-with-frame="true"><figure><img src="/files/182376034cc36cdee65b6b79bf2922a72151fe0d" alt="" width="563"><figcaption></figcaption></figure></div>

2. Bloc 2 « Éteindre la lumière »

<div data-with-frame="true"><figure><img src="/files/d3b5fff508157e22cd3862f52671aa678258ed19" alt="" width="563"><figcaption></figcaption></figure></div>

Pour comprendre qu’il s’agit du bloc qui a été exécuté, et non de l’assistant IA, nous ajouterons une ligne supplémentaire dans le message de chaque bloc.

Ensuite, nous passons à l’assistant IA.

Création d’un bot avec le rôle d’« assistant IA universel ».

<div data-with-frame="true"><figure><img src="/files/0c760f019b7497d677cacb8de9eec49298cd8e11" alt="" width="563"><figcaption></figcaption></figure></div>

À des fins de démonstration, nous n’appliquerons aucune restriction au comportement de l’assistant lors du traitement des blocs.

Tous les paramètres sont maintenant terminés. Passons aux tests.

1. Lancez une discussion avec la station intelligente pour commencer.

<div data-with-frame="true"><figure><img src="/files/beb13f802867cca94c323d5c23daa4a2af80d423" alt="" width="375"><figcaption></figcaption></figure></div>

Comme nous n’avons limité la station d’aucune façon, elle peut parler de sujets totalement abstraits.

2. Maintenant, dans le contexte de notre message, nous indiquons le sens clé — allumer ou éteindre la lumière :

<div data-with-frame="true"><figure><img src="/files/f47325128b8c3cdb679f375f0bd171dfd6114a7f" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/96397cd7923d8956175a9eb8eaac93c550937c93" alt="" width="375"><figcaption></figcaption></figure></div>

Le bot a fonctionné correctement.

Ainsi, aux moments où le déclencheur du bloc n’est pas rempli, l’assistant fonctionne.

En revanche, si le bot détecte le contexte défini par la condition du bloc, c’est le bloc lui-même qui sera déclenché.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/ai/search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
