Een spraakassistent bouwen met Agents Platform op een Raspberry Pi
Tutorial · Hierbij wordt ervan uitgegaan dat je de ElevenAgents quickstart hebt voltooid en een Raspberry Pi met Python hebt geïnstalleerd.
Inleiding
In deze tutorial leer je hoe je een spraakassistent bouwt met Agents Platform die op een Raspberry Pi draait. Net als traditionele thuisassistenten zoals Alexa op Amazon Echo, Google Home of Siri op Apple-apparaten, luistert je Eleven Voice-assistent naar een activeringswoord, in ons geval “Hey Eleven”, en start vervolgens een ElevenLabs Agents-sessie om de gebruiker te helpen.
Vereisten
- Een Raspberry Pi 5 of vergelijkbaar apparaat.
- Een microfoon en luidspreker.
- Python 3.9 of hoger, geïnstalleerd op je computer.
- Een ElevenLabs-account met een API-sleutel.
Instellen
Afhankelijkheden installeren
Op Debian-gebaseerde systemen kun je de afhankelijkheden installeren met:
Het project maken
Open op je Raspberry Pi de terminal en maak een nieuwe map voor je project.
Maak een nieuwe virtuele omgeving en installeer de afhankelijkheden:
Installeer de afhankelijkheden:
Maak nu een nieuw Python-bestand met de naam hotword.py en voeg de volgende code toe:
Agentconfiguratie
Een nieuwe agent maken
Ga naar Agents Platform > Agents en maak een nieuwe agent op basis van de lege template.
Het eerste bericht instellen
Stel het eerste bericht in en geef de dynamische variabele voor het platform op.
De systeemprompt instellen
Stel de systeemprompt in. Je vindt onze documentatie over best practices hier.
Een webhooktool instellen
We stellen een eenvoudige webhooktool in die weergegevens voor ons ophaalt. Volg de configuratiestappen hier om de tool in te stellen.
De app uitvoeren
Stel eerst de vereiste omgevingsvariabelen in om de app uit te voeren:
Voer vervolgens deze opdracht uit:
Zeg nu “Hey Eleven” om het gesprek te starten. Veel chatplezier!
[Optioneel] Je eigen activeringswoord trainen
Trainingsaudio genereren
Om de embeddings voor het activeringswoord te genereren, kun je ElevenLabs gebruiken om vier trainingsvoorbeelden te genereren. Ga in je ElevenLabs-app naar Text To Speech en voer je activeringswoord in, bijvoorbeeld “Hey Eleven”. Selecteer een stem en klik op de knop “Genereren”.
Nadat de audio is gegenereerd, download je het audiobestand en sla je het op in een map met de naam hotword_training_audio in de hoofdmap van je project. Herhaal dit proces nog drie keer met verschillende stemmen.
Het activeringswoord trainen
Voer in je terminal, met je virtuele omgeving geactiveerd, de volgende opdracht uit om het activeringswoord te trainen:
Hiermee wordt het bestand hey_eleven_ref.json gegenereerd in de map hotword_refs. Je hoeft nu alleen de parameter reference_file in de klasse HotwordDetector in hotword.py bij te werken zodat deze naar het nieuwe referentiebestand verwijst. Daarna kun je aan de slag!