Liveanbieter einrichten

Zugangsdaten kommen ausschließlich aus der Betreiberumgebung. Das Dashboard zeigt, ob die notwendigen Variablen gesetzt sind; diese Anzeige bestätigt noch keine erfolgreiche Verbindung oder verfügbare Modellberechtigung.

LLM-Anbieter

Anbieter	Erforderliche Betreiber-Variablen
OpenAI	OPENAI_API_KEY, OPENAI_MODEL
Anthropic	ANTHROPIC_API_KEY, ANTHROPIC_MODEL
Gemini	GEMINI_API_KEY, GEMINI_MODEL
Groq	GROQ_API_KEY, GROQ_MODEL
Eigener kompatibler Anbieter	CUSTOM_LLM_API_KEY, CUSTOM_LLM_MODEL, CUSTOM_LLM_URL

Setze ein Modell, das in deinem Anbieterkonto tatsächlich verfügbar ist. Ein im Agenten ausgewähltes Modell wird verwendet; bei leerem Agentmodell dient die Betreiber-Modellvariable als Standard. Die Kataloganzeige „konfiguriert“ verlangt zusätzlich einen solchen Betreiberstandard. Die eigene URL muss HTTPS verwenden und ist nur durch die Betreiberumgebung festgelegt. Verwende einen vollständigen /chat/completions-Endpunkt oder eine Basisadresse, an die dieser Pfad angehängt werden kann; /v1 gehört bei Bedarf zur Basisadresse.

Dreifache Livefreigabe

1. Betreiber setzt AIHUB_LIVE_ENABLED=1.
2. Betreiber trägt die genaue Arbeitsbereich-ID in AIHUB_LIVE_WORKSPACE_IDS ein, bei mehreren IDs kommasepariert. manage.py list-workspaces zeigt die IDs.
3. Owner/Admin aktiviert live_enabled in diesem Arbeitsbereich.

Demobereiche bleiben unabhängig von diesen Werten gesperrt. Ein Kanal oder Request braucht zusätzlich mode=live. Für öffentliche Widgets/Telefonie wird ein veröffentlichter Agent verwendet. Livekampagnen erfordern außerdem confirm_live=true; Anrufe bestätigte Einwilligung.

Stimme, Transkription und Telefonie

ElevenLabs benötigt ELEVENLABS_API_KEY und standardmäßig ELEVENLABS_VOICE_ID; optional ELEVENLABS_MODEL. POST /api/voice/speech erzeugt eine MP3-Datei bis 3.000 Textzeichen. Stimmen werden nicht automatisch geklont.

Deepgram benötigt DEEPGRAM_API_KEY, optional DEEPGRAM_MODEL; POST /api/voice/transcribe verarbeitet eine Audiodatei. Sprache ist standardmäßig de; auto aktiviert Spracherkennung. Es ist keine kontinuierliche Streaming-STT-Session.

Twilio benötigt Account-SID, Auth-Token, eigene Rufnummer und korrekte öffentliche HTTPS-Adresse. Die Kanaldokumentation beschreibt die signierten Voice-/Statuscallbacks. Twilio verwendet im aktuellen Telefonpfad seine eigene Gather/Say-Verarbeitung.

Für bidirektionale Echtzeittelefonie dient der separate LiveKit-Worker. Er nutzt Deepgram-Streaming-STT, Cartesia oder ElevenLabs als Streaming-TTS und OpenAI oder Groq als Cloud-LLM. CARTESIA_API_KEY/CARTESIA_VOICE_ID, LIVEKIT_URL/LIVEKIT_API_KEY/LIVEKIT_API_SECRET, AIHUB_VOICE_WORKER_TOKEN und AIHUB_REDIS_URL müssen eingerichtet sein. Mit VOICE_LLM_PROVIDER und VOICE_LLM_MODEL setzt du den Betreiberstandard; die Agentversion kann Anbieter/Modell/Stimme überschreiben. Der Katalog prüft gesetzte Werte, keine echte Verbindung.

SIP-Carrier werden mit LiveKit-Trunks und einer kanal-/arbeitsbereichbezogenen Betreiberbindung verbunden. Der optionale DGX-Pfad wechselt bei Fehler oder überschrittenem Startbudget zur Cloud, solange noch keine Antwort ausgegeben wurde. Azure/OpenAI-Azure und Soniox besitzen weiterhin keinen fertigen Adapter. Ein eigener SIP-/RTP-Server und automatisches Carrierfailover sind nicht enthalten. Ein Anbieterfehler benötigt Prüfung von Konfiguration, Erreichbarkeit und Limits im jeweiligen Anbieterportal.

Führe vor dem Start der Worker manage.py check-config --voice aus, bei DGX zusätzlich --hybrid. Dieser Befehl nennt fehlende Variablen ohne Schlüsselwerte und löst keine Anbieteraktion aus. Die gesamte Reihenfolge steht in der Konfigurationsanleitung.

E-Mail und Ereignis-Webhooks

Assistenten können Benachrichtigungen für Beginn, Aktualisierung, Ende und manuelle Bewertung eines Livegesprächs in einer MariaDB-Outbox ablegen. Standard sind Ende und Bewertung. Der Betreiber verarbeitet diese mit manage.py notify-worker --limit 20. Ein Lauf darf 1 bis 1.000 Einträge bearbeiten. Die Outbox bleibt über Neustarts erhalten. Demo-/Testgespräche werden nicht zum externen Versand eingereiht.

SMTP-Variablen: AIHUB_SMTP_HOST, AIHUB_SMTP_PORT, AIHUB_SMTP_USER, AIHUB_SMTP_PASSWORD, AIHUB_SMTP_FROM, AIHUB_SMTP_STARTTLS, AIHUB_SMTP_SSL. Richte zum Mailserver passende TLS- und Authentifizierungswerte ein. Eine unklare SMTP-Antwort wird nicht automatisch wiederholt, um doppelte E-Mails zu vermeiden.

Webhooks benötigen einen freigegebenen öffentlichen HTTPS-Host in AIHUB_WEBHOOK_HOSTS, eine exakte arbeitsbereichbezogene Zieladresse in AIHUB_WEBHOOK_ENDPOINTS und den Betreiber-Signaturschlüssel AIHUB_WEBHOOK_SECRET. Ein global freigegebener Host allein berechtigt einen Kundenbereich noch nicht zum Versand an andere Endpunkte.

AIHUB_WEBHOOK_HOSTS=crm.example.at
AIHUB_WEBHOOK_ENDPOINTS='{"WORKSPACE_ID":["https://crm.example.at/events"]}'
AIHUB_WEBHOOK_SECRET=LANGEN_ZUFAELLIGEN_SIGNATURSCHLUESSEL_SETZEN

Sie enthalten X-AIHub-Signature: sha256=HEX_SIGNATURE. Berechne HMAC-SHA256 mit dem Secret über die exakten empfangenen UTF-8-Bodybytes, bevor du JSON neu serialisierst, und vergleiche die Signatur zeitkonstant. X-AIHub-Event-ID entspricht payload.id und bleibt bei Wiederholungen stabil.

Payloadfelder: id, event, workspace_id, conversation_id, agent_id, mode, status, summary bis 4.000 Zeichen und goal_reached. Prüfe als Empfänger zusätzlich die erwartete Arbeitsbereich-ID. Vollständige Transkripte und Kontaktfelder werden nicht in den Ereignispayload übernommen; eine Zusammenfassung kann trotzdem persönliche Angaben enthalten.

Wiederholbare Zustellfehler können bis zu fünf Versuche auslösen, mit Pausen von 30, 120, 600 und 1.800 Sekunden. Der Worker muss für spätere Versuche erneut laufen. Empfänger deduplizieren anhand der stabilen Ereignis-ID. Outboxstatus sind pending, sending, retry, sent, failed, unknown und blocked. Unklare SMTP-Zustellung benötigt manuelle Prüfung; fehlende Livefreigabe führt zu blockiertem Versand.

GET /api/notifications erlaubt Owner/Admin einen Blick in die Arbeitsbereich-Outbox. Die optionalen Service-/Timer-Vorlagen werden unter Betrieb beschrieben. Demoarbeitsbereiche und nicht freigegebene Bereiche dürfen auch über den Worker keine externen Nachrichten versenden.