De Linguineo-gesprekscomponent configureren
Inleiding
De Linguineo Conversation Player is een krachtige HTML-component die conversationeel taalleren met AI integreert in je LMS of digitale leeromgeving. Leerders oefenen er in realtime en interactief mee, met gedetailleerde feedback en flexibele instellingen. Organisaties zoals educatieve uitgevers of taalscholen kunnen de speler afstemmen op hun didactische doelen en technische omgeving.
Je integreert de speler als een eigen HTML-tag:
<linguineo-conversation ... ></linguineo-conversation>Deze documentatie geeft een gedetailleerd overzicht van alle beschikbare configuratieopties, gegroepeerd per functioneel domein.
1. Verbindingsconfiguratie
Deze eigenschappen bepalen hoe de speler verbinding maakt met de back-end van Linguineo.
| connection-config | JSON-object met de back-endpaden. Pas dit alleen aan als je aangepaste endpoints hebt gekregen of een proxy gebruikt. |
2. Authenticatie
Bepaalt hoe de gebruiker zich aanmeldt bij het Linguineo-platform.
| auth-method | Authenticatiemethode. Gebruik in de meeste gevallen "bearer". Opties: bearer, default, none. |
| access-token | Het (bearer-)token dat je van je identity provider krijgt. |
| user-id | Alleen relevant bij "default"-authenticatie. Niet nodig bij bearer. |
3. Inhoud kiezen
Deze eigenschappen bepalen de taal en het scenario van het gesprek.
| language | ISO 639-1-code van de doeltaal (bv. "fr" voor Frans). |
tutor-language | ISO 639-1-code van de instructietaal van de gebruiker (bv. "nl" voor Nederlands). |
| application | Identificatie van de app. Stel dit alleen in als je die van Linguineo hebt gekregen. |
| scenario-id | Unieke ID van het scenario voor het gesprek. |
| scenario-tag | Alternatief voor scenario-id. Moet samen met language gebruikt worden. Wordt genegeerd als scenario-id ingesteld is. |
4. Antwoorden
Bepaalt hoe leerders antwoorden tijdens het gesprek.
| answer-type | Manier van antwoorden. Opties: MULTIPLE_CHOICE, WRITING, SPEAKING, WRITING_AND_SPEAKING, SPEAKING_WITH_INTERMEDIATE_WRITING. |
5. Feedback
Bepaalt het soort en de diepgang van de corrigerende feedback die leerders zien.
show-feedback-in-conversations | Alle soorten feedback in- of uitschakelen. |
| inline-feedback | Feedback inline tonen (altijd zichtbaar) of via een schakelaar. |
show-pronunciation-feedback | Basisfeedback op uitspraak tonen. |
| do-additional-pronunciation-analysis | Diepgaande uitspraakanalyse inschakelen. |
| show-simple-corrective-feedback | Korte, niet-metalinguïstische correcties tonen (in plaats van ingewikkeldere metalinguïstische). |
| additional-corrective-feedback | Uitgebreide grammaticale feedback inschakelen. |
enable-contextualized-grammar-corrections | Semantische/contextuele inzichten aan de feedback toevoegen. |
6. Ondersteuning voor de gebruiker
Bepaalt welke hulpmiddelen en ondersteuning de leerder tijdens het gesprek krijgt.
| generate-hints-for-open-flow | Hints genereren in open gesprekken. |
| show-translations-in-conversation | Vertalingen van de uitingen in het gesprek tonen. |
| allow-word-lookup | Gebruikers laten tikken/klikken op woorden in berichten van de bot om de vertaling te zien. |
7. Gedrag van de bot
Beheer het tempo, het verloop en de voortgang van gesprekken.
| always-wait-for-bot-to-finish-speaking | Als true, moet de gebruiker wachten tot de bot uitgesproken is voor hij kan antwoorden. |
| offer-to-let-bot-proceed-if-applicable | De bot laten aanbieden om verder te gaan wanneer dat kan. |
| automatic-progression-if-too-many-misses | Automatisch verdergaan na meerdere mislukte pogingen. |
| show-full-bot-responses | De interne interpretatie en redenering van de bot tonen wanneer een opdracht mislukt. |
| speaking-rate-of-bot | Bepaalt hoe snel de bot spreekt (0 tot 2). Standaard (normale snelheid): 1. |
8. Spraakherkenning
Verfijnt hoe gesproken antwoorden herkend worden.
| speech-recognition-strategy | Strategie om spraak te interpreteren. Opties: DEFAULT, AUTOCORRECT_TO_CONTEXT. Bij AUTOCORRECT_TO_CONTEXT probeert de spraakherkenning sterk om iets te herkennen dat in de context past. |
| forgiveness | Decimale waarde (0 tot 1). Hoe hoger, hoe meer de herkenning naar verwachte antwoorden neigt. Standaard: 0.08. |
9. Moeilijkheidsgraad
Past het niveau aan op basis van de prestaties van de leerder.
| switch-to-easier-based-on-frustration | De moeilijkheidsgraad automatisch verlagen na herhaalde fouten. |
10. Opnames
Bepaalt hoe spraakopnames van de gebruiker behandeld worden.
| stop-recording-automatically-on-silence | De opname automatisch stoppen wanneer er stilte gedetecteerd wordt. |
11. UX-opties
Stelt de gebruikersinterface en interactie in.
| ui-theme | Thema van de interface. Standaardopties: light, dark. |
| animated-reward-icons | Een visuele beloning tonen wanneer een opdracht voltooid is. |
| sound-effects-enabled | Geluidseffecten in de interface inschakelen. |
| with-back-button | Een terugknop aan de speler toevoegen. |
| blinking-clues-enabled | Hints laten knipperen als de gebruiker inactief is. |
| show-progress-bar | Een voortgangsbalk tonen tijdens het gesprek. |
| allow-corrections-by-user | (Ervaren) gebruikers de output van de bot laten corrigeren. |
| bot-name | Eigen naam voor het botpersonage. |
| user-photo-url | Eigen URL voor de profielfoto van de gebruiker. |
| bot-image-url | Eigen URL voor de profielfoto van de bot. |
Voorbeeldconfiguratie
<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>