Anrufkript: Erstellen eines Grok xAI-Echtzeit-Sprachagenten

Einführung

The grokvoiceagent.cs sample connects an inbound 3CX call to an xAI Grok real-time voice session. The agent can answer callers, search the approved company directory, connect calls, offer voicemail or chat, and save caller context when configured.

The sample includes a disabled get_department_hours custom tool that demonstrates how to register a safe AI-callable function.

Das Beispiel grokvoiceagent.cs verbindet einen eingehenden 3CX-Anruf mit einer xAI Grok-Echtzeit-Sprachsitzung. Der Agent kann Anrufer annehmen, im genehmigten Firmenverzeichnis suchen, Anrufe weiterleiten, Mailbox oder Chat anbieten und, sofern konfiguriert, den Anruferkontext speichern.

Das Beispiel enthält ein deaktiviertes benutzerdefiniertes Tool namens get_department_hours, das die Registrierung einer sicheren, KI-aufrufbaren Funktion demonstriert.

Für dieses Skript benötigen Sie eine 3CX AI Edition-Lizenz, eine PBX-Version Update 10 und ein xAI API-Konto.

Erstellen des Anrufskripts in 3CX

• Melden Sie sich in der 3CX-Administrationskonsole an.
• Gehen Sie zu Integrationen > Anrufskripte.
• Wählen Sie „+Aus Store hinzufügen“.

• Wählen Sie grokvoiceagent.cs.

• Geben Sie einen Skriptnamen in Kleinbuchstaben ohne Leerzeichen ein, z. B. grokreception.
• Wählen Sie aus, wie das Skript ausgeführt werden soll, und weisen Sie die gewünschte DID, Trunk-Route oder das interne Ziel zu.
• Wählen Sie die Abteilung aus, der das Skript gehört.
• Bestätigen Sie Ihre Auswahl, um den Code-Editor zu öffnen.

xAI und das Skript konfigurieren

Fügen Sie der Telefonanlage die folgenden Parameter hinzu:

• GROK_API_KEY - der API-Schlüssel für Ihr xAI-Konto.
• GROK_REALTIME_MODEL - das Grok-Echtzeit-Sprachmodell.

Lassen Sie ApiKeyOverride und ModelOverride im Skript leer. Wenn diese Werte leer sind, liest das Skript den API-Schlüssel und das Modell automatisch aus den PBX-Parametern.

Geben Sie den Grok-API-Schlüssel nicht direkt im Skript ein, insbesondere wenn das Skript geteilt, exportiert oder veröffentlicht werden soll. Ein in ApiKeyOverride oder ModelOverride konfigurierter Wert hat Vorrang vor dem entsprechenden PBX-Parameter.

Überprüfen Sie als Nächstes diese Kundeneinstellungen im oberen Bereich des Skripts:

Setzen Sie AllowAllVisibilityForTesting vor der Produktion auf false und konfigurieren Sie die kleinstmögliche Sichtbarkeitsliste.

Um die optionale Beispielfunktion zu aktivieren, überprüfen Sie deren Daten und entfernen Sie die Kommentarzeichen:

RegisterExampleCustomTool();



Wählen Sie „Speichern“ und überprüfen Sie, ob die Kompilierung erfolgreich war.

So funktioniert es

• Der Anrufer erreicht das Skript.
• Das Skript erstellt eine Liste mit eingeschränkter Verzeichnissichtbarkeit.
• 3CX bereitet den Medienkanal vor und startet die Grok-Echtzeit-Sprachsitzung.
• Der Agent spricht mit dem Anrufer und ruft genehmigte 3CX-Funktionen auf.
• Weiterleitungen erfolgen über Tools anstatt über Gesprächsversprechen.
• Bei einem Provider- oder Medienausfall wird der Anrufer an den konfigurierten Ausweichkanal weitergeleitet.

Testen Sie das Skript

• Bestätigen Sie die ausgewählte Grok-Stimme und das mehrsprachige Verhalten.
• Suchen Sie nach zugelassenen und ausgeblendeten Nebenstellen.
• Prüfen Sie, ob der Agent nach der Anruferbestätigung eine Weiterleitung durchführt.
• Testen Sie Mailbox und Chat, wenn ein Nutzer nicht erreichbar ist.
• Verabschieden Sie sich und überprüfen Sie, ob die Sitzung ordnungsgemäß beendet wird.
• Testen Sie das Verhalten bei Providerausfällen und Ausweichlösungen.

Fehlerbehebung

• Die Sitzung schlägt sofort fehl: Überprüfen Sie GROK_API_KEY, das unterstützte Modell, die Lizenz, die PBX-Konfiguration und die Verbindung zum ausgehenden Provider.
• Die Weiterleitung wird angekündigt, aber nicht ausgeführt: Stellen Sie sicher, dass die benutzerdefinierten Anweisungen weiterhin das Verbindungstool benötigen und nicht überschrieben wurden.
• Die Verzeichnissuche liefert zu viele Ergebnisse: Deaktivieren Sie AddAll() und schränken Sie die Sichtbarkeit ein.
• Der Fallback schlägt fehl: Überprüfen Sie die Berechtigungen für Ziel und Abteilung.
• Das Prompt fehlt: Stellen Sie sicher, dass im aktiven Prompt ERROR vorhanden ist.

Siehe auch

• Erstellen eines Anrufverarbeitungsskripts
• Beispiel-Anrufverarbeitungsskript für PIN 
• 3CX-Administrationshandbuch

Letztes Update

Dieser Leitfaden wurde zuletzt am 31. Juli 2026 aktualisiert.

https://www.3cx.de/docs/grok-ai-voice-agent/