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
1
Im Dashboard anmelden
Melde dich auf avaluma.ai an und öffne den Bereich Agents in deinem Dashboard.
2
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.3
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. Eine Standardstimme ist bereits vorausgewählt — eine Stimme muss gewählt sein, damit der Agent spricht.
4
Speichern und testen
Speichere den Agent und starte ein Testgespräch im Dashboard, um zu prüfen, ob der Avatar spricht und wie erwartet antwortet.
Einen Agent konfigurieren
Öffne einen Agent, um seine Konfiguration jederzeit anzupassen. Häufige Einstellungen sind: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: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.
Nutzungsstatistik pro Agent
In der Agents-Übersicht zeigt jede Agenten-Kachel, wie viele Gesprächsminuten dieser Agent im laufenden Monat genutzt wurde. Über das Statistik-Symbol auf der Kachel öffnest du ein Fenster mit den wichtigsten Kennzahlen:
Dazu zeigt ein Verlauf die Gespräche im Zeitverlauf, umschaltbar zwischen 1 Tag (stündlich), 7 Tagen und 30 Tagen. Über das Datumsfeld wählst du das Enddatum des Zeitraums (Standard: heute) und blätterst so auch zu vergangenen Tagen oder Wochen zurück.
Den monatlichen Gesamtverbrauch aller Agenten und dein Tarif-Limit siehst du im Balken oben auf der Agents-Seite — mehr dazu unter Preise & Abrechnung.
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.
