Saltearse al contenido
Nappai Documentation

Piper (local)

Piper (local) es uno de los componentes que ponen voz a un agente de voz: convierte en audio lo que el agente responde, para que el llamante lo oiga. Corre en el servidor de NappAI: no necesita credencial, el texto no se envía a ningún proveedor externo y no tiene coste por palabra. Su voz es más sencilla que la de los servicios en la nube.

Se conecta al conector TTS del nodo Voice Agent. Guarda los ajustes de la voz que el agente usa en cada llamada.

Cuándo usarlo

  • Quieres una voz local en español, inglés, francés, alemán o italiano.
  • No quieres que las respuestas del agente salgan del servidor de NappAI.
  • Quieres elegir entre voz femenina y masculina en español.

Configuración

CampoQué hace
VoiceLa voz. La lista trae una por idioma: es_ES-sharvard-medium (español, por defecto), en_US-lessac-medium (inglés), fr_FR-siwis-medium (francés), de_DE-thorsten-medium (alemán) e it_IT-riccardo-medium (italiano). Puedes escribir el nombre de otra voz de Piper; la primera llamada que la use tardará más en empezar.
SpeakerQué hablante usar, en las voces que tienen más de uno. La voz en español tiene F (femenina, por defecto) y M (masculina). Vacío, se usa el hablante por defecto de la voz.
SpeedRitmo de la voz. 1.0 es su ritmo natural; por encima habla más rápido y por debajo más despacio. Por defecto, 1.0.

Opciones avanzadas

CampoQué hace
Voice PathDéjalo vacío. Solo hace falta si el equipo técnico de tu instalación te indica otra ubicación para la voz.

Resultado

La salida TTS contiene los ajustes de la voz. Se conecta al conector TTS del nodo Voice Agent, o a Fallback TTS si activas Fallback Engines y quieres usarla como reserva. El editor no deja enchufarla en un conector de STT por error.

Ejemplo

Una academia quiere un agente que informe de horarios en francés.

  1. Añade Piper (local) y conéctalo al conector TTS del Voice Agent.
  2. Elige fr_FR-siwis-medium en Voice y deja Speaker vacío.
  3. Pon fr como idioma en el STT.
  4. Prueba el agente en el playground y escucha cómo suena.

Buenas prácticas

  • Elige una voz del mismo idioma que espera el STT: cada voz de Piper habla un solo idioma.
  • Las diferencias entre voces locales y en la nube se explican en Calidad, ruido y latencia.

Componentes relacionados