Configurer le composant de conversation Linguineo

Introduction

Le Linguineo Conversation Player est un composant HTML puissant qui intègre l’apprentissage conversationnel des langues par l’IA dans votre LMS ou votre environnement d’apprentissage numérique. Il permet aux apprenants de s’entraîner de manière interactive et en temps réel, avec un feedback détaillé et une configuration flexible. Les organisations comme les éditeurs scolaires ou les écoles de langues peuvent adapter le lecteur à leurs objectifs pédagogiques et à leur environnement technique.

Vous intégrez le lecteur sous la forme d’une balise HTML personnalisée :

<linguineo-conversation ... ></linguineo-conversation>

Cette documentation présente en détail toutes les options de configuration disponibles, regroupées par domaine fonctionnel.

1. Configuration de la connexion

Ces propriétés déterminent la manière dont le lecteur se connecte au back-end de Linguineo.

connection-config

Objet JSON qui définit les chemins du back-end. À modifier uniquement si vous avez reçu des endpoints personnalisés ou si vous utilisez un proxy.

2. Authentification

Définit la manière dont l’utilisateur est authentifié auprès de la plateforme Linguineo.

auth-method	Méthode d’authentification. Utilisez `"bearer"` dans la plupart des cas. Options : `bearer`, `default`, `none`.
access-token	Le jeton (bearer) reçu de votre fournisseur d’identité.
user-id	Uniquement pertinent avec l’authentification `"default"`. Inutile avec `bearer`.

3. Sélection du contenu

Ces propriétés déterminent la langue et le scénario utilisés pendant la conversation.

language	Code ISO 639-1 de la langue apprise (par ex. `"fr"` pour le français).
`tutor-language`	Code ISO 639-1 de la langue d’instruction de l’utilisateur (par ex. `"nl"` pour le néerlandais).
application	Identifiant de l’application. À définir uniquement s’il vous a été fourni par Linguineo.
scenario-id	Identifiant unique du scénario de la conversation.
scenario-tag	Alternative à `scenario-id`. Doit être combiné avec `language`. Ignoré si `scenario-id` est défini.

4. Réponses

Détermine la manière dont les apprenants répondent pendant la conversation.

answer-type Mode de réponse de l’utilisateur. Options : MULTIPLE_CHOICE, WRITING, SPEAKING, WRITING_AND_SPEAKING, SPEAKING_WITH_INTERMEDIATE_WRITING.

5. Feedback

Personnalise le type et la profondeur du feedback correctif affiché aux apprenants.

`show-feedback-in-conversations`	Active ou désactive tous les types de feedback.
inline-feedback	Affiche le feedback en ligne (toujours visible) ou via un bouton.
`show-pronunciation-feedback`	Affiche un feedback de prononciation de base.
do-additional-pronunciation-analysis	Active l’analyse approfondie de la prononciation.
show-simple-corrective-feedback	Affiche des corrections brèves, non métalinguistiques (au lieu de corrections métalinguistiques plus complexes).
additional-corrective-feedback	Active un feedback grammatical détaillé.
`enable-contextualized-grammar-corrections`	Ajoute des éléments sémantiques/contextuels au feedback.

6. Aide à l’utilisateur

Détermine les outils et l’aide proposés à l’apprenant pendant la conversation.

generate-hints-for-open-flow	Génère des indices dans les conversations ouvertes.
show-translations-in-conversation	Affiche la traduction des énoncés dans la conversation.
allow-word-lookup	Permet aux utilisateurs de toucher/cliquer sur les mots des messages du bot pour en voir la traduction.

7. Comportement du bot

Gère le rythme, le déroulement et la progression des conversations.

always-wait-for-bot-to-finish-speaking	Si `true`, l’utilisateur doit attendre que le bot ait fini de parler avant de répondre.
offer-to-let-bot-proceed-if-applicable	Permet au bot de proposer de continuer lorsque c’est possible.
automatic-progression-if-too-many-misses	Passe automatiquement à la suite après plusieurs tentatives infructueuses.
show-full-bot-responses	Affiche l’interprétation et le raisonnement internes du bot en cas d’échec d’une tâche.
speaking-rate-of-bot	Détermine la vitesse d’élocution du bot (de 0 à 2). Par défaut (vitesse normale) : `1`.

8. Reconnaissance vocale

Affine la reconnaissance des réponses orales.

speech-recognition-strategy	Stratégie d’interprétation de la parole. Options : `DEFAULT`, `AUTOCORRECT_TO_CONTEXT`. Avec AUTOCORRECT_TO_CONTEXT, la reconnaissance vocale cherche fortement à reconnaître quelque chose qui correspond au contexte.
forgiveness	Valeur décimale (de 0 à 1). Plus elle est élevée, plus la reconnaissance tend vers les réponses attendues. Par défaut : `0.08`.

9. Difficulté

Ajuste le niveau de difficulté en fonction des performances de l’apprenant.

switch-to-easier-based-on-frustration

Réduit automatiquement la difficulté après des erreurs répétées.

10. Enregistrements

Détermine le traitement des enregistrements vocaux de l’utilisateur.

stop-recording-automatically-on-silence

Arrête automatiquement l’enregistrement lorsqu’un silence est détecté.

11. Options UX

Configure l’interface et les interactions.

ui-theme	Thème de l’interface. Options par défaut : `light`, `dark`.
animated-reward-icons	Affiche une récompense visuelle à la fin d’une tâche.
sound-effects-enabled	Active les effets sonores de l’interface.
with-back-button	Ajoute un bouton retour au lecteur.
blinking-clues-enabled	Fait clignoter les indices si l’utilisateur est inactif.
show-progress-bar	Affiche une barre de progression pendant la conversation.
allow-corrections-by-user	Permet aux utilisateurs (experts) de corriger les réponses du bot.
bot-name	Nom personnalisé du personnage du bot.
user-photo-url	URL personnalisée de la photo de l’utilisateur.
bot-image-url	URL personnalisée de l’image du bot.

Exemple de configuration

<linguineo-conversation
    access-token="{YOUR_TOKEN}"
    auth-method="bearer"
    bot-name="Anna"
    language="fr"
    tutor-language="nl"
    scenario-id="503"
    answer-type="SPEAKING_WITH_INTERMEDIATE_WRITING"
    show-pronunciation-feedback="true"
    show-simple-corrective-feedback="true"
    additional-corrective-feedback="true"
    ui-theme="dark"
    user-photo-url="https://example.com/user.svg"
    bot-image-url="https://example.com/bot.svg"
></linguineo-conversation>