Voice Assistant mit Agents Platform auf einem Raspberry Pi erstellen
Tutorial · Setzt voraus, dass Sie den ElevenAgents- Schnellstart abgeschlossen haben und einen Raspberry Pi mit installiertem Python besitzen.
Einführung
In diesem Tutorial erfahren Sie, wie Sie einen Voice Assistant mit Agents Platform auf einem Raspberry Pi erstellen. Wie herkömmliche Home-Assistenten wie Alexa auf Amazon Echo, Google Home oder Siri auf Apple-Geräten hört Ihr Eleven Voice Assistant auf ein Aktivierungswort – in unserem Fall „Hey Eleven“ – und startet dann eine ElevenLabs-Agents-Sitzung, um den Nutzer zu unterstützen.
Voraussetzungen
- Ein Raspberry Pi 5 oder ein ähnliches Gerät.
- Ein Mikrofon und Lautsprecher.
- Python 3.9 oder höher muss auf Ihrem Gerät installiert sein.
- Ein ElevenLabs-Konto mit einem API-Schlüssel.
Einrichtung
Abhängigkeiten installieren
Auf Debian-basierten Systemen können Sie die Abhängigkeiten wie folgt installieren:
Projekt erstellen
Öffnen Sie auf Ihrem Raspberry Pi das Terminal und erstellen Sie ein neues Verzeichnis für Ihr Projekt.
Erstellen Sie eine neue virtuelle Umgebung und installieren Sie die Abhängigkeiten:
Installieren Sie die Abhängigkeiten:
Erstellen Sie nun eine neue Python-Datei mit dem Namen hotword.py und fügen Sie den folgenden Code hinzu:
Agent-Konfiguration
Neuen Agenten erstellen
Navigieren Sie zu Agents Platform > Agents und erstellen Sie einen neuen Agenten aus der leeren Vorlage.
Erste Nachricht festlegen
Legen Sie die erste Nachricht fest und geben Sie die dynamische Variable für die Plattform an.
System-Prompt festlegen
Legen Sie den System-Prompt fest. Unsere Dokumentation zu Best Practices finden Sie hier.
Webhook-Tool einrichten
Wir richten ein einfaches Webhook-Tool ein, das die Wetterdaten für uns abruft. Folgen Sie den Einrichtungsschritten hier, um das Tool einzurichten.
App ausführen
Legen Sie zum Ausführen der App zunächst die erforderlichen Umgebungsvariablen fest:
Führen Sie dann einfach den folgenden Befehl aus:
Sagen Sie jetzt „Hey Eleven“, um die Unterhaltung zu starten. Viel Spaß beim Chatten.
[Optional] Eigenes Aktivierungswort trainieren
Trainingsaudio generieren
Um die Aktivierungswort-Einbettungen zu generieren, können Sie mit ElevenLabs vier Trainingsbeispiele erstellen. Navigieren Sie in Ihrer ElevenLabs-App zu Text to Speech und geben Sie Ihr Aktivierungswort ein, z. B. „Hey Eleven“. Wählen Sie eine Stimme aus und klicken Sie auf „Generate“.
Nachdem das Audio generiert wurde, laden Sie die Audiodatei herunter und speichern Sie sie in einem Ordner namens hotword_training_audio im Stammverzeichnis Ihres Projekts. Wiederholen Sie diesen Vorgang dreimal mit verschiedenen Stimmen.
Aktivierungswort trainieren
Führen Sie in Ihrem Terminal bei aktivierter virtueller Umgebung den folgenden Befehl aus, um das Aktivierungswort zu trainieren:
Dadurch wird die Datei hey_eleven_ref.json im Ordner hotword_refs erstellt. Jetzt müssen Sie nur noch den Parameter reference_file in der Klasse HotwordDetector in hotword.py aktualisieren, sodass er auf die neue Referenzdatei verweist. Anschließend ist alles bereit.