LiveKit

LiveKit Agents est un framework d’IA vocale en temps réel sur WebRTC, SIP et médias en streaming. Le plugin Gradium permet à un agent LiveKit d’utiliser Gradium pour la transcription (STT), la synthèse vocale (TTS), ou les deux, au sein d’une même AgentSession.

Plugin TTS Gradium

Le guide LiveKit de la synthèse vocale Gradium.

Plugin STT Gradium

Le guide LiveKit de la transcription Gradium.

Référence du plugin

Référence de l’API Python pour livekit.plugins.gradium.

Guide Gradium

Tutoriel complet pour créer un agent vocal avec Gradium et LiveKit.

Installation

Installez LiveKit Agents avec l’extra du plugin Gradium :

pip install "livekit-agents[gradium]~=1.5"

Définissez les identifiants requis dans votre environnement :

export LIVEKIT_URL=wss://your-project.livekit.cloud
export LIVEKIT_API_KEY=your-livekit-api-key
export LIVEKIT_API_SECRET=your-livekit-api-secret
export GRADIUM_API_KEY=gd_your_api_key_here

Session d’agent de base

Utilisez gradium.STT() pour transcrire l’audio de l’utilisateur et gradium.TTS() pour synthétiser les réponses de l’agent.

from livekit.agents import AgentSession
from livekit.plugins import gradium

session = AgentSession(
    stt=gradium.STT(language="en"),
    tts=gradium.TTS(
        voice_id="YTpq7expH9539ERJ",
    ),
    # ... llm, vad, tools, and other session options
)

Vous pouvez aussi n’utiliser Gradium que d’un côté. Par exemple, conservez un fournisseur STT existant et utilisez Gradium uniquement pour la sortie vocale :

session = AgentSession(
    tts=gradium.TTS(),
    # ... llm, stt, etc.
)

Configuration

Options Gradium courantes dans LiveKit Agents :

Paramètre	S’applique à	Description
`api_key`	STT, TTS	Clé API Gradium. `GRADIUM_API_KEY` par défaut.
`model_endpoint`	STT, TTS	Endpoint WebSocket Gradium. `api.gradium.ai` par défaut ; les requêtes sont automatiquement routées vers le cluster régional le plus proche.
`model_name`	STT, TTS	Nom du modèle Gradium. `default` par défaut.
`voice_id`	TTS	Identifiant de la voix Gradium utilisée pour les réponses synthétisées. Emma par défaut.
`pronunciation_id`	TTS	Identifiant facultatif d’un dictionnaire de prononciation Gradium.
`language`	STT	Langue de transcription : `en`, `fr`, `es`, `pt` ou `de`. Définissez-la toujours.
`json_config`	TTS	Paramètres TTS avancés, comme la vitesse et les règles de réécriture.
`vad_threshold`	STT	Seuil de VAD sémantique pour détecter quand l’utilisateur a fini de parler.
`vad_bucket`	STT	Intervalle temporel de la VAD sémantique.

Prononciation personnalisée

Passez l’identifiant d’un dictionnaire de prononciation Gradium au plugin TTS lorsqu’un agent doit prononcer de façon cohérente des noms de marque, des noms de produit ou des termes propres à un domaine.

tts = gradium.TTS(
    voice_id="YTpq7expH9539ERJ",
    pronunciation_id="pronunciation_dictionary_id",
)

Pour un contrôle plus fin de la prononciation et de la réécriture, consultez Dictionnaires de prononciation et Paramètres de voix.

Quand utiliser LiveKit avec Gradium

Agents vocaux en temps réel : exécutez une boucle complète STT, LLM et TTS dans AgentSession.
Applications WebRTC : connectez les utilisateurs navigateur et mobiles à la voix propulsée par Gradium via les rooms LiveKit.
Agents téléphoniques : utilisez LiveKit SIP tout en conservant Gradium comme couche de modèles vocaux.
Déploiements en production : déployez des agents LiveKit avec des rooms, des identifiants et des processus workers gérés.

Introduction

Frameworks d'agents

Outils

Plugin TTS Gradium

Plugin STT Gradium

Référence du plugin

Guide Gradium

Installation

Session d’agent de base

Configuration

Prononciation personnalisée

Quand utiliser LiveKit avec Gradium

Plugin TTS Gradium

Plugin STT Gradium

Référence du plugin

Guide Gradium

​Installation

​Session d’agent de base

​Configuration

​Prononciation personnalisée

​Quand utiliser LiveKit avec Gradium

Installation

Session d’agent de base

Configuration

Prononciation personnalisée

Quand utiliser LiveKit avec Gradium