Taaldetectie

Laat je agent automatisch naar de juiste taal schakelen

Overzicht

Met de systeemtool language detection kan je ElevenLabs-agent de uitvoertaal wijzigen naar elke taal die de agent ondersteunt. Deze systeemtool wordt niet automatisch ingeschakeld. De beschrijving kan worden aangepast aan je specifieke use case.

Waar mogelijk raden we aan alle talen voor een agent in te schakelen en de systeemtool voor taaldetectie in te schakelen.

Onze tool voor taaldetectie activeert in twee gevallen een taalwisseling, beide op basis van de gedetecteerde taal en inhoud van de ontvangen audio:

detection: als een gebruiker een andere taal spreekt dan de huidige uitvoertaal, wordt een wisseling geactiveerd
content: als de gebruiker in de huidige taal vraagt om naar een nieuwe taal te wisselen, wordt een wisseling geactiveerd

Doel: Tijdens gesprekken automatisch overschakelen naar de gedetecteerde taal van de gebruiker.

Triggervoorwaarden: De LLM moet deze tool aanroepen wanneer:

De gebruiker een andere taal spreekt dan de huidige gesprekstaal
De gebruiker expliciet vraagt om van taal te wisselen
Ondersteuning voor meerdere talen nodig is voor het gesprek

Parameters:

reason (string, verplicht): De reden voor de taalwissel
language (string, verplicht): De taalcode om naar over te schakelen (moet in de lijst met ondersteunde talen staan)

Indeling voor functieaanroepen:

{
  "type": "function",
  "function": {
    "name": "language_detection",
    "arguments": "{\"reason\": \"User requested Spanish\", \"language\": \"es\"}"
  }
}

Implementatie: Configureer ondersteunde talen in de agentinstellingen en voeg de systeemtool voor taaldetectie toe. De agent schakelt automatisch van stem en antwoorden om overeen te komen met gedetecteerde talen.

Taaldetectie inschakelen

Ondersteunde talen configureren

De talen waarnaar de agent kan wisselen, moeten worden ingesteld op het tabblad Agent in de instellingen.

De tool voor taaldetectie toevoegen

Schakel taaldetectie in door de vooraf geconfigureerde systeemtool toe te voegen aan de tools van je agent op het tabblad Agent. Deze is automatisch beschikbaar als optie wanneer je add tool selecteert.

Toolbeschrijving configureren

Voeg een beschrijving toe waarin staat wanneer de tool moet worden aangeroepen

Wisselen beperken tot het begin van het gesprek

In een lang gesprek kunnen achtergrondspraak of een ongebruikelijk accent soms een wisseling activeren die de beller niet bedoelde. Door only_at_conversation_start in te schakelen, wordt wisselen beperkt tot de eerste twee beurten van de gebruiker.

Als de taal tijdens die twee beurten niet wisselt, wordt taaldetectie voor de rest van het gesprek uitgeschakeld: elke latere poging mislukt en de agent blijft de huidige taal spreken. Als de taal wel binnen dat venster wisselt, blijft wisselen beschikbaar voor de rest van het gesprek, zodat een onjuiste detectie nog kan worden gecorrigeerd.

De optie is standaard uitgeschakeld.

Bijwerken via het dashboard

Bijwerken via de CLI

Bijwerken via de API

Selecteer de tool Detect language op het tabblad Tools en schakel Only at start of conversation in.

Wanneer wisselen wordt geblokkeerd, retourneert de tool een fout aan de LLM met de instructie om de huidige taal te blijven spreken. De reden wordt niet aan de beller getoond.

API-implementatie

Wanneer je via de API een agent maakt, kun je de tool language detection aan je agentconfiguratie toevoegen. Deze moet als systeemtool worden gedefinieerd:

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
# Create language presets
language_presets = {
    "nl": {"overrides": {"agent": {"first_message": "Hoi, hoe gaat het met je?"}}},
    "fi": {"overrides": {"agent": {"first_message": "Hei, kuinka voit?"}}},
    "tr": {"overrides": {"agent": {"first_message": "Merhaba, nasılsın?"}}},
    "ru": {"overrides": {"agent": {"first_message": "Привет, как ты?"}}},
    "pt": {"overrides": {"agent": {"first_message": "Oi, como você está?"}}},
}
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            first_message="Hi how are you?",
            prompt={
                "built_in_tools": {
                    "language_detection": {
                        "type": "system",
                        "name": "language_detection",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {"system_tool_type": "language_detection"},
                    }
                },
            },
        ),
        language_presets=language_presets,
    ),
)

Laat de beschrijving leeg om de standaardprompt voor taaldetectie te gebruiken.