Configuration de l’agent

Cette page liste toutes les options que vous pouvez passer à client.audio.sessions.init(). Les options se répartissent en deux portées. Les options Agent définissent l’agent lui-même : ses modèles, sa voix, ses instructions, ses outils et la gestion des tours de parole. Vous pouvez les enregistrer dans un agent. Les options Session ne s’appliquent qu’à la session que vous ouvrez, comme l’agent enregistré à partir duquel démarrer ou l’interface audio à utiliser.

client.audio.sessions.init() est une méthode du client généraliste Mistral. Créez le client une seule fois, puis démarrez à partir de celui-ci autant de sessions que nécessaire.

Mistral(
    api_key: str,
    server_url: str = "https://api.mistral.ai",
    timeout_ms: int = 60000,
)

Mistral(
    api_key: str,
    server_url: str = "https://api.mistral.ai",
    timeout_ms: int = 60000,
)

Passez les options de l’agent à init() à chaque fois, ce qui convient aux essais rapides, ou enregistrez-les une seule fois dans un agent, puis démarrez chaque session avec agent_id. Quand vous définissez agent_id, la configuration enregistrée sert de base, et toute option d’agent que vous passez également à init() la remplace pour cette session uniquement. L’agent enregistré ne change pas. Les options de session s’appliquent toujours. Pour un exemple, consultez Créer un agent et démarrer une session.

Ces options font partie de la configuration de l’agent, et vous pouvez les enregistrer dans un agent.

Ces options ne s’appliquent qu’à la session que vous ouvrez.

Définissez stt.turn_detection pour laisser un modèle Voxtral 3 realtime décider quand l’utilisateur a fini de parler. Sans ce paramètre, l’agent utilise la détection de fin de tour par défaut du modèle. Passez {} pour utiliser les valeurs par défaut du serveur, ou définissez les champs de votre choix parmi les suivants :

Par exemple, pour que l’agent réponde après un silence plus court :

session = await client.audio.sessions.init(
    stt={
        "model": "voxtral-mini-transcribe-realtime-3",
        "turn_detection": {"min_silence_ms": 300},
    },
)

session = await client.audio.sessions.init(
    stt={
        "model": "voxtral-mini-transcribe-realtime-3",
        "turn_detection": {"min_silence_ms": 300},
    },
)

Pour connaître le rôle de chaque seuil et la configuration Agressive, plus rapide, consultez Détection des tours de parole.

tts accepte les champs suivants :

Utilisez phoneme_hints pour corriger la façon dont l’agent prononce des noms, des marques ou des sigles. Chaque mot est associé à une liste de phonèmes IPA. Les mots sont sensibles à la casse. Seuls les phonèmes de l’anglais sont pris en charge : un phonème hors de cet ensemble est rejeté à la création de la session ou à l’enregistrement de l’agent.

session = await client.audio.sessions.init(
    tts={
        "model": "voxtral-mini-tts-3",
        "voice_id": "voice_447",
        "phoneme_hints": {"Mistral": ["m", "ɪ", "s", "t", "ɹ", "ɑ", "l"]},
    },
)

session = await client.audio.sessions.init(
    tts={
        "model": "voxtral-mini-tts-3",
        "voice_id": "voice_447",
        "phoneme_hints": {"Mistral": ["m", "ɪ", "s", "t", "ɹ", "ɑ", "l"]},
    },
)

En plus des voix Voxtral TTS 2 listées ci-dessous, Voxtral TTS 3 prend en charge les voix d’acteurs suivantes.

En plus de ces voix d’acteurs, Voxtral TTS 2 prend en charge le clonage de voix instantané, qui crée une voix à partir d’un échantillon audio.

turn définit la façon dont l’agent partage la conversation avec l’utilisateur :

inactivity accepte les champs suivants :

session = await client.audio.sessions.init(
    turn={
        "allow_interruptions": True,
        "inactivity": {
            "timeout_ms": 10000,
            "max_reminders": 2,
            "messages": ["Are you still there?"],
        },
    },
)

session = await client.audio.sessions.init(
    turn={
        "allow_interruptions": True,
        "inactivity": {
            "timeout_ms": 10000,
            "max_reminders": 2,
            "messages": ["Are you still there?"],
        },
    },
)

Vous pouvez modifier instructions, tools et turn pendant qu’une session est en cours. Consultez Mettre à jour une session en cours.