# SEMANTICSEARCH

L’application de workflow **SEMANTICSEARCH** effectue une recherche hybride, à la fois en texte intégral et sémantique, sur les demandes, avec des filtres et une pondération personnalisables. Elle retourne des résultats JSON structurés pour être utilisés dans la logique du processus.

## Paramètres requis

<table><thead><tr><th width="238.2821044921875" valign="top">Paramètre</th><th width="110.595458984375" valign="top">Type</th><th width="112.10540771484375" valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><code>QUERY</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">Requête de recherche principale (texte intégral et similarité)</td></tr><tr><td valign="top"><code>QUERY_DATA_&#x3C;NOM></code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">Requête pour un champ de données spécifique (p.ex. <code>QUERY_DATA_TITLE</code>)</td></tr><tr><td valign="top"><code>RESULT</code></td><td valign="top">TEXT</td><td valign="top">OUT</td><td valign="top">Chaîne JSON contenant les résultats de la recherche</td></tr></tbody></table>

{% hint style="info" %}
Au moins l’un de `QUERY` ou `QUERY_DATA_<NOM>` doit être fourni.
{% endhint %}

## Paramètres facultatifs

<table><thead><tr><th width="236.8575439453125" valign="top">Paramètre</th><th width="110.8831787109375" valign="top">Type</th><th width="110.25634765625" valign="top">Direction</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><code>REQUEST_ID</code></td><td valign="top">NUMERIC</td><td valign="top">IN</td><td valign="top">Le numéro de la demande sur laquelle filtrer</td></tr><tr><td valign="top"><code>REQUEST_STATE</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">État de la demande : <code>OPEN</code> ou <code>CLOSED</code></td></tr><tr><td valign="top"><code>REQUEST_SUBSTATE</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top"><p>Sous-état :</p><ul><li>Pour <code>OPEN</code>, utilisez <code>NOT_RUNNING_NOT_STARTED</code> ou <code>RUNNING</code></li><li> Pour <code>CLOSED</code>, utilisez <code>COMPLETED</code> ou <code>ABORTED</code></li></ul></td></tr><tr><td valign="top"><code>REQUEST_CREATED_AT_FROM</code></td><td valign="top">DATETIME</td><td valign="top">IN</td><td valign="top">Filtre : date/heure de création de la demande (à partir de)</td></tr><tr><td valign="top"><code>REQUEST_CREATED_AT_TO</code></td><td valign="top">DATETIME</td><td valign="top">IN</td><td valign="top">Filtre : date/heure de création de la demande (jusqu’à)</td></tr><tr><td valign="top"><code>REQUEST_CLOSED_AT_FROM</code></td><td valign="top">DATETIME</td><td valign="top">IN</td><td valign="top">Filtre : date/heure de clôture de la demande (à partir de)</td></tr><tr><td valign="top"><code>REQUEST_CLOSED_AT_TO</code></td><td valign="top">DATETIME</td><td valign="top">IN</td><td valign="top">Filtre : date/heure de clôture de la demande (jusqu’à)</td></tr><tr><td valign="top"><code>REQUESTER_USERNAME</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">Nom d’utilisateur du demandeur</td></tr><tr><td valign="top"><code>PROCESS_NAME</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">Nom du processus</td></tr><tr><td valign="top"><code>PROCESS_VERSION</code></td><td valign="top">NUMERIC</td><td valign="top">IN</td><td valign="top">Version du processus </td></tr><tr><td valign="top"><code>QUERY_SCORE</code></td><td valign="top">NUMERIC</td><td valign="top">IN</td><td valign="top">Seuil de score pour la requête principale (par défaut : <code>0.5</code>); voir <a href="#score-de-requete">Score de requête</a> ci-dessous pour plus d'informations </td></tr><tr><td valign="top"><code>QUERY_SCORE_DATA_&#x3C;NOM></code></td><td valign="top">NUMERIC</td><td valign="top">IN</td><td valign="top">Seuil de score pour la requête sur un champ de données spécifique (p.ex. <code>QUERY_SCORE_DATA_SUBJECT</code>); voir <a href="#score-de-requete">Score de requête</a> ci-dessous pour plus d'informations </td></tr><tr><td valign="top"><code>SELECT_DATA_LIST</code></td><td valign="top">TEXT</td><td valign="top">IN</td><td valign="top">Liste de champs de données, séparés par des virgules ou des points-virgules, à inclure dans le résultat de recherche</td></tr></tbody></table>

{% hint style="info" %}
`QUERY_SCORE_DATA_<NOM>` est requis si vous avez un paramètre `QUERY_DATA_<NOM>`.
{% endhint %}

#### Score de requête

* Les scores de requête s’appliquent uniquement à la recherche sémantique et non à la recherche en texte intégral.
* Le score par défaut de `0.5` correspond à un seuil de similarité de 50 %.
* Pour un rapprochement plus strict, utilisez un score plus proche de `1.0` (p.ex. `0.75` pour un seuil de similarité de 75 %).
* Pour un rapprochement plus souple, utilisez un score plus proche de `0.0` (p.ex. `0.25` pour un seuil de similarité de 25 %).&#x20;

Cela s’applique aux paramètres `QUERY_SCORE` et `QUERY_SCORE_DATA_<NOM>`.


---

# 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.workflowgen.com/admin-fr/applications-de-workflow/semanticsearch.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.
