Crea un asistente de voz con Agents Platform en una Raspberry Pi
Tutorial · Da por hecho que has completado la guía de inicio rápido de ElevenAgents y que tienes una Raspberry Pi con Python instalado.
Introducción
En este tutorial aprenderás a crear un asistente de voz con Agents Platform ejecutándose en una Raspberry Pi. Al igual que los asistentes domésticos convencionales, como Alexa en Amazon Echo, Google Home o Siri en dispositivos Apple, tu asistente de voz Eleven escuchará una palabra de activación, en nuestro caso «Hey Eleven», y հետո iniciará una sesión de ElevenLabs Agents para ayudar al usuario.
Requisitos
- Una Raspberry Pi 5 o un dispositivo similar.
- Un micrófono y un altavoz.
- Python 3.9 o una versión posterior instalado en tu equipo.
- Una cuenta de ElevenLabs con una clave de API.
Configuración
Instala las dependencias
En sistemas basados en Debian puedes instalar las dependencias con:
Crea el proyecto
En tu Raspberry Pi, abre el terminal y crea un directorio nuevo para tu proyecto.
Crea un entorno virtual e instala las dependencias:
Instala las dependencias:
Ahora crea un archivo de Python llamado hotword.py y añade el siguiente código:
Configuración del agente
Crea un agente nuevo
Ve a Agents Platform > Agents y crea un agente nuevo a partir de la plantilla en blanco.
Configura el primer mensaje
Configura el primer mensaje y especifica la variable dinámica para la plataforma.
Configura el prompt del sistema
Configura el prompt del sistema. Puedes consultar nuestra documentación de buenas prácticas aquí.
Configura una herramienta webhook
Configuraremos una sencilla herramienta webhook que obtendrá los datos meteorológicos. Sigue los pasos de configuración aquí para configurar la herramienta.
Ejecuta la app
Para ejecutar la app, primero configura las variables de entorno necesarias:
Después, ejecuta simplemente el siguiente comando:
Ahora di «Hey Eleven» para iniciar la conversación. ¡Que disfrutes charlando!
[Opcional] Entrena tu palabra de activación personalizada
Genera audio de entrenamiento
Para generar las incrustaciones de la palabra de activación, puedes usar ElevenLabs para generar cuatro muestras de entrenamiento. Ve a Texto a Voz en tu app de ElevenLabs e introduce tu palabra de activación, por ejemplo, «Hey Eleven». Selecciona una voz y haz clic en el botón «Generate».
Cuando se haya generado el audio, descarga el archivo de audio y guárdalo en una carpeta llamada hotword_training_audio en la raíz de tu proyecto. Repite este proceso tres veces más con voces diferentes.
Entrena la palabra de activación
En el terminal, con el entorno virtual activado, ejecuta el siguiente comando para entrenar la palabra de activación:
Esto generará el archivo hey_eleven_ref.json en la carpeta hotword_refs. Ahora solo tienes que actualizar el parámetro reference_file de la clase HotwordDetector en hotword.py para que apunte al nuevo archivo de referencia. ¡Y listo!