Agents (gehostet)
Erstelle einen Agent im Dashboard, teile einen Link oder bette ihn ein. Avaluma betreibt Avatar-Server und Sprach-Pipeline für dich.
Self-Hosting
Betreibe Avatar-Server und LiveKit-Agent auf eigener Hardware — für volle Kontrolle über Daten, Modelle und Rechenleistung.
Was ist ein Agent?
Ein Agent ist ein konfigurierter, gehosteter Avatar in deinem Avaluma-Konto. Jeder Agent bündelt alles, was eine Live-Konversation braucht:- Einen fotorealistischen Avatar, gerendert aus einem Avaluma-
.hvia-Modell - Eine Stimme für die Sprachausgabe (Text-to-Speech)
- Eine KI-Persona — der System-Prompt und das Verhalten, die seine Antworten prägen
- Freigabe-Einstellungen — ein öffentlicher Link und optionale Einbettung auf deiner eigenen Webseite
Einen Agent erstellen
Im Dashboard anmelden
Melde dich auf avaluma.ai an und öffne den Bereich Agents in deinem Dashboard.
Neuen Agent anlegen
Klicke auf Neuer Agent, gib ihm einen Namen und wähle den gewünschten Avatar aus. Deine verfügbaren Avatare stammen aus den
.hvia-Dateien, die mit deiner Lizenz ausgestellt wurden.Stimme und Persona konfigurieren
Wähle eine Stimme für die Sprachausgabe und schreibe die Anweisungen des Agenten (System-Prompt). Die Anweisungen bestimmen Ton, Wissen und Verhalten des Agenten während einer Konversation.
Einen Agent konfigurieren
Öffne einen Agent, um seine Konfiguration jederzeit anzupassen. Häufige Einstellungen sind:| Einstellung | Beschreibung |
|---|---|
| Name | Interne Bezeichnung des Agenten in deinem Dashboard. |
| Avatar | Der .hvia-Avatar, den der Agent rendert. |
| Stimme | Die Text-to-Speech-Stimme für gesprochene Antworten. |
| Anweisungen | Der System-Prompt, der Persona und Verhalten des Agenten prägt. |
| Sprache | Standardsprache für Konversation und Oberfläche. |
| Freigabe | Ob der Agent über einen öffentlichen Link erreichbar ist. |
| Einbettung | Ob der Agent per <iframe> eingebettet werden darf — und auf welchen Origins. |
| Kiosk | Ob der Agent als eigenständige Vollbild-Seite (Kiosk) erreichbar ist. |
Nur freigegebene Agenten lassen sich über einen öffentlichen Link öffnen oder auf einer Webseite einbetten. Aktiviere die Freigabe, bevor du einen Agent-Link verteilst.
Agenten verwalten
In der Agents-Übersicht findest du bei jedem Agenten ein Menü (drei Punkte) mit zusätzlichen Aktionen:| Aktion | Beschreibung |
|---|---|
| Duplizieren | Erstellt eine vollständige Kopie des Agenten — inklusive Stimme, Anweisungen, Tools und aller hochgeladenen Dokumente. Die Kopie erhält eine neue Agent-ID und den Namen <Name> (Kopie). |
| Übertragen | Übergibt den Agenten an einen anderen Nutzer (per E-Mail-Adresse). Der neue Eigentümer erhält vollständigen Zugriff; bei dir verschwindet der Agent aus der Liste. |
| Löschen | Entfernt den Agenten endgültig. Diese Aktion kann nicht rückgängig gemacht werden. |
Beim Duplizieren werden auch die Einbettungs- und Kiosk-Einstellungen (inklusive der erlaubten Origins) übernommen. Die Kopie ist damit sofort unter denselben Bedingungen erreichbar wie das Original.
Teilen und einbetten
Jeder Agent ist über eine gehostete URL anhand seiner Agent-ID erreichbar:<iframe> ein und steuere ihn von deiner Seite aus.
Embedding
Bette einen Agent per
<iframe> in deine Webseite ein und passe Aussehen und Verhalten über Query-Parameter an.Messaging
Steuere den eingebetteten Avatar programmatisch und empfange Events über die
postMessage-API.Kiosk-Modus
Betreibe den Agenten im Vollbild auf einem unbeaufsichtigten Display — mit Wake-Lock und Auto-Reset.