Paramètres personnalisés de l'édition OpenSearch LLM-Based Conversational Search - OpenSearch

Cette rubrique décrit les paramètres personnalisés et la syntaxe de l'édition OpenSearch LLM-Based Conversational Search. Les paramètres sont organisés par fonction : Paramètres Q&A contrôlent le modèle de conversation et le comportement de la session, paramètres prompt définissent le style et le format de la réponse, paramètres de récupération de documents optimisent la qualité de la recherche, paramètres d'image de référence définissent les seuils de similarité d'images, paramètres de compréhension des requêtes activent l'expansion des requêtes, paramètres d'intervention manuelle ajustent la correspondance des entrées et autres paramètres configurent la modération du contenu et la sortie des résultats.

Paramètres Q&A

Paramètre	Type	Obligatoire	Par défaut	Description
Select Model	String	Oui	opensearch-qwen	Grand modèle de langage (LLM) utilisé pour la recherche conversationnelle. Pour connaître les LLM pris en charge, consultez Gérer les LLM.
Prompt	String	Non	Modèle de prompt par défaut	Modèle de prompt utilisé pour la recherche conversationnelle. Pour connaître les modèles pris en charge, consultez Gérer les prompts.
Multi-round Conversations	Boolean	Non	true	Contrôle le comportement des conversations multi-tours. Valeurs valides : `false`, `true`, `session`. Voir les détails ci-dessous.
Streaming Output	Boolean	Non	true	Indique si les résultats doivent être diffusés en temps réel. Valeurs valides : `false`, `true`. Voir les détails ci-dessous.

Valeurs pour Multi-round Conversations :

false : désactive les conversations multi-tours. Chaque requête est traitée indépendamment.
true : active les conversations multi-tours. Les résultats se basent sur le contexte des N tours précédents.
session : limite le contexte de la conversation à une source. Les résultats se basent sur les conversations ayant le même identifiant de source.

Valeurs pour Streaming Output :

false : désactive la diffusion en continu. Les résultats sont renvoyés une fois la réponse complète générée.
true : active la diffusion en continu. Les résultats sont renvoyés en temps réel au fur et à mesure de leur génération.

Paramètres prompt

Paramètre	Type	Obligatoire	Par défaut	Description
attitude	String	Non	normal	Ton de la réponse. Valeurs valides : `normal`, `polite`, `patience`.
rule	String	Non	simple	Niveau de détail de la réponse. Valeurs valides : `detailed`, `stepbystep`.
noanswer	String	Non	sorry	Réponse renvoyée lorsque le système ne peut pas répondre à la question. Valeurs valides : `sorry`, `uncertain`.
language	String	Non	Chinese	Langue de la réponse. Valeurs valides : `Chinese`, `English`, `Thai`, `Korean`.
role	Boolean	Non	true	Indique si un rôle personnalisé répond à la question.
role_name	String	Non	AI Assistant	Nom du rôle personnalisé. Exemple : `AI Assistant`.
out_format	String	Non	text	Format de la réponse. Valeurs valides : `text`, `table`, `list`, `markdown`.

Paramètres de récupération de documents

Paramètres

Paramètre	Type	Obligatoire	Valeurs valides	Par défaut	Description
filter	String	Non	N/A	None	Champ utilisé pour filtrer les documents. Format : `field=value`.
top_n	Int	Non	(0, 50]	5	Nombre de documents à récupérer.
sf	Float	Non	[0, +∞)	1,3	Seuil de similarité vectorielle pour la récupération de documents. Voir les détails ci-dessous.
dense_weight	Float	Non	(0, 1)	0,7	Poids du vecteur dense. Disponible uniquement lorsqu'un modèle de vecteur sparse est sélectionné. Le poids du vecteur sparse est `1 - dense_weight`.
formula	String	Non	N/A	Similarité vectorielle	Formule utilisée pour classer les documents récupérés. Voir les valeurs prises en charge ci-dessous.
operator	String	Non	N/A	AND	Opérateur appliqué entre les jetons de texte lors de la récupération de texte.

Comportement du seuil sf :

Sans vecteur sparse : la plage valide est [0, 2,0], la valeur par défaut est 1,3. Une valeur plus faible donne des résultats plus pertinents, mais le nombre de résultats peut diminuer.
Avec vecteur sparse activé : la valeur par défaut est 0,35. Une valeur plus élevée permet de récupérer des résultats plus pertinents, mais le nombre de résultats peut diminuer.

Valeurs de formule prises en charge :

Pertinence du texte

Fonction	Description
text_relevance	Calcule la pertinence textuelle entre les requêtes de recherche et les valeurs de champ dans les documents.
field_match_ratio	Renvoie le ratio des termes de champ correspondant à la requête par rapport au total des termes dans le champ.
query_match_ratio	Renvoie le ratio des termes trouvés dans un champ par rapport au total des termes dans la requête.
fieldterm_proximity	Renvoie la proximité des termes dans un champ.
field_length	Renvoie le nombre de termes dans un champ.
query_term_count	Renvoie le nombre de termes dans la requête après analyse.
query_term_match_count	Renvoie le nombre de termes de requête mis en correspondance dans un champ.
field_term_match_count	Renvoie le nombre de termes de champ correspondant à la requête.
query_min_slide_window	Renvoie le ratio des termes de requête mis en correspondance par rapport à la fenêtre minimale de ces termes dans le champ.

Actualité

Fonction	Description
timeliness	Renvoie un score d'actualité indiquant la fraîcheur du document, en secondes.
timeliness_ms	Renvoie un score d'actualité indiquant la fraîcheur du document, en millisecondes.

Fonctionnalité

Fonction	Description
tag_match	Met en correspondance les clauses de requête avec les documents basés sur des tags et calcule les poids des tags.
first_phase_score	Renvoie le score calculé par les expressions de tri approximatif.
kvpairs_value	Renvoie la valeur d'un champ spécifié dans une clause kvpairs.
normalize	Normalise les scores provenant de différentes plages de valeurs vers [0, 1].
in or notin	Vérifie si les valeurs de champ figurent ou non dans une liste spécifiée.

Syntaxe

filter

Format : field=value

Exemples :

Filtrer par une seule valeur :
```
"filter": "category=\"value1\""
```

Filtrer par l'une des deux valeurs (condition OR) :

"filter": "category=\"value1\" OR category=\"value2\""

Filtrer par n'importe quelle valeur d'une liste (séparer les valeurs par des virgules) :
```
"filter": "category=\"value1,value2,value3,value4\""
```

top_n

Format : top_n:value

Exemple : top_n:3

Format : sf=value

Exemple : sf=1.3

Paramètres d'image de référence

Paramètres

Paramètre	Type	Obligatoire	Valeurs valides	Par défaut	Description
sf	Float	Non	[0, +∞)	1	Seuil de similarité vectorielle pour les images de référence. Pour les modèles de vecteur sparse, une valeur plus élevée indique une similarité plus forte. Pour les modèles de vecteur dense, une valeur plus élevée indique une similarité plus faible.
dense_weight	Float	Non	(0, 1)	0,7	Poids du vecteur dense. Disponible uniquement lorsqu'un modèle de vecteur sparse est sélectionné. Le poids du vecteur sparse est `1 - dense_weight`.

Syntaxe

Format : sf=value

Exemple : sf=1

Paramètres de compréhension des requêtes

Paramètre	Type	Obligatoire	Valeurs valides	Par défaut	Description
query_extend	Boolean	Non	N/A	false	Active ou désactive l'expansion des requêtes. Lorsqu'elle est activée, les requêtes sont étendues pour améliorer les performances de récupération.
query_exten_num	Int	Non	(0, +∞)	5	Nombre de requêtes étendues à générer.

Paramètres d'intervention manuelle

Paramètres

Paramètre	Type	Obligatoire	Valeurs valides	Par défaut	Description
sf	Float	Non	[0, 2]	0,3	Seuil de mise en correspondance des entrées d'intervention manuelle. Une valeur plus élevée facilite la mise en correspondance d'une entrée d'intervention.

Syntaxe

Format : sf=value

Exemple : sf=0.3

Autres paramètres

Paramètres

Paramètre	Type	Obligatoire	Valeurs valides	Par défaut	Description
return_hits	Boolean	Non	N/A	false	Indique s'il faut renvoyer les résultats de recherche. Si la valeur est définie sur `false`, seuls les liens de référence sont renvoyés.
csi_level	String	Non	N/A	strict	Niveau de modération du contenu. Valeurs valides : `none`, `loose`, `strict`. Voir les détails ci-dessous.
history_max	Int	Non	(0, 20]	20	Nombre maximal de tours de conversation utilisés comme contexte. Maximum : 20 tours.
link	Boolean	Non	N/A	false	Indique s'il faut renvoyer la source de chaque document récupéré.

Valeurs pour csi_level :

none : aucune modération de contenu n'est appliquée.
loose : modère les résultats et bloque la réponse si du contenu restreint est détecté.
strict : modère les résultats et bloque la réponse si du contenu restreint ou suspect est détecté.

Syntaxe

return_hits

Format : return_hits:value

Exemple : return_hits:true

link

Lorsque link est défini sur true, la réponse inclut des références de source de type note de bas de page. La notation [^N^] indique le numéro ordinal du document récupéré dans la liste de référence. Par exemple, [^1^] fait référence au premier document.

Exemple de réponse avec link défini sur true :

You can resize the disk of an Elastic Compute Service (ECS) instance online or offline[^1^]. If you use the online resizing method, you can resize the disk without restarting the instance. If you use the offline resizing method, you must restart the instance[^1^]. To resize a disk, log on to the ECS console, find the disk, click Resize in the Actions column, and select a resizing method[^1^]. If you need to resize partitions and file systems, you can obtain relevant information by using the CLI or in the console[^2^]. After an ECS disk is resized, you cannot reduce its capacity[^3^].