Beispiel für einen KI-Support-Chat bereitstellen

Sie schalten die Funktion KI-Antworten von Webspace ein und prüfen den Support-Ablauf mit der Datei chat.html, die bei der Bereitstellung erzeugt wird. Diese Konfiguration verwendet das Modell und die Agent-Ausführungspipeline, die der Administrator bereits eingerichtet hat, statt für jeden Webspace ein neues Modell oder einen neuen Agent anzulegen.

Bevor Sie beginnen

Erforderliche Berechtigung: Benutzer, die Schemas und APIs bereitstellen können
Der Serveradministrator muss einen KI-Anbieter verbinden und das zu verwendende Chat-Modell registrieren und aktivieren.
Legen Sie fest, welchen Mitgliedern, Stufen, Teams oder Administratorbedingungen Sie die Berechtigung Verwenden für KI-Antworten erteilen.
Mitglieder, die chat.html nutzen, müssen sich an derselben SetFN-Site anmelden können.
Prüfen Sie den Veröffentlichungsumfang der für den Support verwendeten Daten und die Systemanweisungen.

KI-Modell des Administrators vorbereiten

Verbinden Sie in den Administratoreinstellungen einen KI-Anbieter und registrieren und aktivieren Sie das Chat-Modell, das für den Support verwendet werden soll. Lassen Sie Primäres Modell und Ersatzmodell im Webspace leer, wählt der Server automatisch bevorzugt ein aktives, einsatzbereites Chat-Modell aus. Bei Anfragen mit Bildern wird zusätzlich die vom Administrator festgelegte Priorität der OCR/VL-Modelle berücksichtigt.

Nur wenn ein bestimmter Webspace ein festes Modell benötigt, legen Sie Primäres Modell und Ersatzmodell unter Erweiterte Einstellungen fest. Tragen Sie weder in der Webspace-Oberfläche noch in chat.html Anbieterschlüssel oder Modellgeheimnisse ein. Die Support-Oberfläche ruft die bereitgestellte Verbindung der KI-Funktion auf; Modellauswahl und Agent-Ausführung folgen der vorhandenen Server-Pipeline.

Erweiterte Einstellungen für KI-Antworten konfigurieren

Schalten Sie in API-Erstellung des Schemas KI-Antworten ein und öffnen Sie anschließend Erweiterte Einstellungen.

Schalten Sie die Funktion KI-Antworten ein.
Lassen Sie Primäres Modell und Ersatzmodell leer, wenn Sie kein bestimmtes Modell festlegen müssen.
Schalten Sie Tools verwenden ein, wenn Tools benötigt werden. Standardmäßig ist die Option ausgeschaltet.
Tragen Sie den Support-Umfang und die Antwortgrundsätze in die Systemanweisungen ein.
Legen Sie die Berechtigung Verwenden fest.
Schalten Sie Beispiel für einen Support-Chat erzeugen ein.

In der Schemadatei wird der letzte Punkt in folgender Struktur gespeichert.

{
  "apiBuild": {
    "features": {
      "ai-chat": {
        "enabled": true,
        "sampleChat": true
      }
    }
  }
}

sampleChat bestimmt nur, ob die Beispieloberfläche erzeugt wird. Vorhandene Administrator-Modelle und Agent-Einstellungen werden weder kopiert noch überschrieben.

chat.html automatisch erzeugen

Wenn sowohl enabled als auch sampleChat von KI-Antworten auf true gesetzt sind und die Bereitstellung das Frontend-Beispiel einschließt, wird chat.html erzeugt. Geben Sie den Bereitstellungspfad des Clients an und stellen Sie das Schema bereit. chat.html wird zusammen mit index.html und test.html im aktuellen Ausgabeordner des Frontend-Beispiels gespeichert; ein separater Ordner nur für den KI-Support wird nicht angelegt.

Support-Service/
├── index.html
├── test.html
├── chat.html
├── style.css
└── README.md

Melden Sie sich als Mitglied an derselben SetFN-Site an, öffnen Sie chat.html und prüfen Sie die folgenden Punkte. Das Beispiel initialisiert die Mitgliedsinformationen aus der aktuellen Anmeldesitzung; gehen Sie daher nicht davon aus, dass es als anonymer öffentlicher Chat funktioniert.

Prüfen Sie, dass Anfragen von Mitgliedern ohne die Berechtigung Verwenden für KI-Antworten nicht zugelassen werden.
Senden Sie eine Nachricht mit einem berechtigten Konto.
Prüfen Sie, ob die Antwort über das vorhandene Administrator-Modell oder die Agent-Pipeline eintrifft.
Wenn Sie Tools verwenden eingeschaltet haben, prüfen Sie, ob Tools nur im zugelassenen Umfang ausgeführt werden.
Prüfen Sie, ob bei einer unterbrochenen Verbindung ein Fehlerstatus angezeigt wird und keine doppelten Nachrichten entstehen.

Support-Oberfläche anpassen

Die automatisch erzeugte Datei chat.html ist ein Ausgangspunkt, um Verbindung und Berechtigungen zu prüfen. Hinweistexte, vorgeschlagene Fragen und das Design der Oberfläche können Sie an den Zweck Ihres Dienstes anpassen. Verbindungsadresse, Authentifizierung und die vom Server verwaltete Logik der Modellauswahl ändern Sie nicht eigenmächtig in Client-Einstellungen.

Damit die KI keine ungeprüften Inhalte als Tatsachen darstellt, beschreiben Sie in den Systemanweisungen den Support-Umfang und den Umgang mit unbekannten Fragen. Prüfen Sie vor dem Produktivbetrieb mit echten Konten jeder Berechtigungsstufe Fragen, Tool-Aufrufe und Fehlerantworten.

Hinweise

chat.html ist ein Beispiel-Client und erstellt kein eigenes KI-Modell und keinen eigenen Agent.
Lassen Sie Primäres Modell und Ersatzmodell leer, wählt der Server das Modell automatisch anhand der Administratoreinstellungen und des Status der verfügbaren Modelle aus.
Die Erzeugung des Beispiels und die Verbindung zum Agent-Protokoll allein garantieren keine Antwort eines echten KI-Anbieters. Senden Sie vor dem Produktivbetrieb echte Nachrichten an den auf dem Server konfigurierten Anbieter, das Modell oder den Agent und prüfen Sie die Antworten.
Das Beispiel verwendet das vorhandene AI-Agent-Protokoll und zeigt den Ausführungsstatus von Tools sowie Hinweise auf ausstehende Genehmigungen und ausstehende zusätzliche Eingaben an. Eine Oberfläche, um die Genehmigung oder die zusätzliche Eingabe selbst abzuschließen, stellt es jedoch nicht bereit.
Tools verwenden ist standardmäßig ausgeschaltet. Prüfen Sie vor dem Einschalten von Tools, ob eine separate Oberfläche vorhanden ist, die die vom jeweiligen Agent geforderten Genehmigungen oder zusätzlichen Eingaben verarbeitet.
Das Beispiel erfordert eine Mitgliederanmeldung und eine Sitzungsinitialisierung; eine anonyme öffentliche Nutzung wird nicht garantiert.
Prüfen Sie die Berechtigung zur Tool-Nutzung getrennt von der Berechtigung Verwenden für KI-Antworten.
Weisen Sie gesondert darauf hin, dass in Support-Eingaben keine personenbezogenen Daten oder Geheimnisse eingegeben werden dürfen.
Prüfen Sie beim erneuten Bereitstellen nach Änderungen am Beispiel, welche Dateien überschrieben werden.