Probierdialog und Abnahme

Bevor ein Assistent auf Ihre Website kommt, lässt er sich an zwei Stellen prüfen. Im Probierdialog stellen Sie selbst Fragen und sehen Antwort, Belege und Endzustand, bevor ein Besucher sie zu sehen bekommt. In der Abnahme legen Sie Prüffragen mit Musterantwort an und lassen sie gesammelt gegen die veröffentlichte Fassung laufen; das Urteil wird nachgerechnet und fragt kein Modell.

Probierdialog

Den Probierdialog finden Sie im Menü unter Arbeit › Probierdialog (app.xicbot.de/probe). Im Einrichtungsweg eines Assistenten führt der Schritt Probieren zwischen Wissen verbinden und Einbinden direkt hierher und wählt diesen Assistenten vor. Jeder Probierdialog ist ein eigenes Gespräch im Kanal Test. Die Antwort entsteht auf demselben Weg wie im Widget, einschließlich der hinterlegten Notfallantwort.

Starten

Haben Sie mehrere Assistenten, wählen Sie im Feld Assistent; bei nur einem steht sein Name hinter Getestet wird. Eine Adresse mit ?a= und der Kennung eines Assistenten wählt ihn vor, eine unbekannte Kennung fällt ohne Meldung auf den ersten Assistenten zurück. Probierdialog starten legt das Gespräch an, während des Ladens steht dort Wird geladen …. Hat der Assistent eine Begrüßung, erscheint sie als erste Zeile.

Das Gespräch hält die Fassung fest, die beim Start veröffentlicht war. Veröffentlichen Sie danach eine neue Fassung, sehen Sie deren Wirkung erst nach Neuer Probierdialog. Ohne veröffentlichte Fassung lehnt der Dienst den Start mit 422 no_version ab, und der Probierdialog zeigt Zu diesem Assistenten gibt es keine veröffentlichte Fassung. Veröffentlichen Sie eine Fassung und beginnen Sie neu. Ein neu angelegter Assistent hat seine erste Fassung aber bereits veröffentlicht.

Nachricht senden

Die Frage steht sofort im Gespräch, noch bevor die Antwort beginnt. Während der Assistent schreibt, zeigt der Knopf Antwortet …; die Zeilen sind mit Sie und Assistent beschriftet. Unter einer Antwort stehen bis zu drei Belege, weitere hinter + n weitere anzeigen. Solange eine Antwort läuft, nimmt das Gespräch keine zweite Nachricht an (409 reply_in_progress); eine laufende Antwort belegt es höchstens 180 Sekunden. Lehnt der Dienst eine Nachricht deshalb ab, zeigt der Probierdialog Es läuft bereits eine Antwort auf diese Frage. Ist die Nachricht länger als die Höchstlänge Ihres Kontos, steht dort Die Nachricht ist zu lang: höchstens … Zeichen. An der Stelle der Punkte steht die Grenze Ihres Kontos als Zahl.

Abbrechen beendet die Antwort auch beim Dienst, sie läuft dort nicht unbemerkt weiter. Der bis dahin geschriebene Text bleibt stehen; Belege kommen nach einem Abbruch keine mehr, und die Statuszeile zeigt abgebrochen. Ist keine Antwort unterwegs, stehen neben Senden zwei Wege: Dieses Gespräch im Verlauf ansehen öffnet es unter Gespräche, Neuer Probierdialog beginnt ein leeres Gespräch. Das alte bleibt erhalten und lässt sich im Verlauf über den Filter Kanal mit Test finden.

Nach der ersten Antwort erscheint Antwortet der Assistent passend, ist der nächste Schritt das Einbinden auf Ihrer Website. mit dem Link Widget einbinden. Wie das geht, beschreibt Widget einbauen.

Der Probierdialog zeigt Text, Belege und den Endzustand einer Antwort. Werkzeugkarten, Folgefragen, das Kontaktangebot und eine Übergabe erscheinen hier nicht; im Widget stehen Folgefragen und das Angebot, mit einem Menschen zu sprechen, als Knöpfe unter der Antwort. Einen vorgeschlagenen Werkzeugaufruf bestätigen Sie unter Dieses Gespräch im Verlauf ansehen. Berichtigt der Dienst eine Antwort nach dem Schreiben, etwa weil eine Angabe ohne Quelle einem Platzhalter weicht (in einer deutschen Antwort „[nicht belegt]“, sonst „[not backed]“) oder ein Pflichthinweis durch den zugesagten ersetzt wird, übernimmt der Probierdialog den berichtigten Wortlaut, so wie er gespeichert ist und wie ihn das Widget zeigt. Fällt das Modell mitten in einer Antwort aus, zeigt der Probierdialog nur die hinterlegte Notfallantwort, nicht den abgebrochenen Anfang.

Endzustand einer Antwort

Endet eine Antwort nicht regulär, steht unter dem Gespräch ihr Endzustand. Eine regulär beendete Antwort zeigt keinen Zusatz.

Jede Antwort, die der Assistent mit dem Modell formuliert, ist ein Modellaufruf und zählt gegen das Kontingent Ihres Pakets, auch im Probierdialog. Trifft eine Frage ein aktives Frage-Antwort-Paar, geht dessen Antwort im Wortlaut hinaus, ohne Modellaufruf, und gebucht wird nichts; siehe Wissen. Ist das Kontingent aufgebraucht, kommt die Notfallantwort, und gebucht wird nichts. Einzelheiten stehen unter Pakete und Kontingente. Probierdialoge und die Gespräche der Abnahme laufen im Kanal Test und unterliegen der eigenen Frist Testgespräche; ist dort nichts eingetragen, gilt die allgemeine Frist für Gespräche. Siehe Aufbewahrung und Löschung.

Rechte und Drossel

Mit der Rolle Lesen sind die Auswahl unter Assistent, Probierdialog starten, das Feld Ihre Nachricht und Senden gesperrt. Oben im Probierdialog steht dann, auch solange noch kein Assistent angelegt ist, der Hinweis Mit der Rolle Lesen lässt sich hier nur ansehen. Ändern kann, wer mindestens die Rolle Bearbeiten hat. Der Dienst selbst lehnt Start und Senden mit dieser Rolle mit 403 role_too_low ab; kommt eine solche Ablehnung beim Senden an, zeigt der Probierdialog dieselbe Meldung. Wer die Drossel überschreitet, erhält 429 und die Meldung Zu viele Versuche. Bitte warten Sie einen Moment. Die Rollen erklärt Team und Rollen.

Abnahme

Die Abnahme finden Sie unter Nachweis › Abnahme (app.xicbot.de/abnahme). Jede Prüffrage wird einmal gestellt wie von einem Besucher, und zwar gegen die veröffentlichte Fassung des Assistenten. Die Oberfläche empfiehlt einen Lauf vor dem Livegang und nach jeder Änderung. Beim Öffnen ist der erste Assistent gewählt; haben Sie mehrere, wechseln Sie im Feld Assistent.

Prüffrage anlegen

Füllen Sie die Felder aus und wählen Sie Prüffrage anlegen; während des Speicherns steht dort Wird gespeichert …. Danach sind Frage, Musterantwort, Muss enthalten und Darf nicht enthalten wieder leer, Mindestdeckung und Läuft mit behalten ihren Wert. Eine neue Prüffrage kommt ans Ende der Liste.

Unter den Begriffsfeldern steht Ein Begriff je Zeile, höchstens 10. Groß- und Kleinschreibung und die Schreibweise der Umlaute spielen keine Rolle. Leerzeichen am Rand und leere Zeilen fallen weg. Doppelte Begriffe speichert der Dienst nur einmal, wenn sie Zeichen für Zeichen gleich sind: „Preis“ und „preis“ bleiben beide stehen, obwohl der Vergleich mit der Antwort die Groß- und Kleinschreibung nicht unterscheidet. Die Grenze von 10 Begriffen prüft er vor dem Entfernen der Doppelten: 11 Zeilen lehnt er ab, auch wenn zwei davon gleich sind.

So entsteht das Urteil

Eine Prüffrage gilt als bestanden, wenn drei Bedingungen zugleich erfüllt sind. Fehlt eine davon, ist sie durchgefallen.

• Jeder Begriff aus Muss enthalten kommt in der Antwort vor. Was fehlt, steht im Ergebnis unter Fehlt.
• Kein Begriff aus Darf nicht enthalten kommt vor. Was doch vorkommt, steht unter Verboten und doch gesagt.
• Die Deckung erreicht die Mindestdeckung. Diese Bedingung entfällt bei Mindestdeckung 0 und wenn die Musterantwort kein bedeutungstragendes Wort enthält.

Begriffe werden als Zeichenfolge gesucht, nicht als ganzes Wort: Versand trifft auch „Versandkosten“. Verglichen wird in Kleinschreibung, mit gefalteten Umlauten und Akzenten (ä wie ae, ß wie ss, é wie e) und mit zusammengezogenen Leerzeichen, damit ein umbrochener Begriff nicht scheitert.

Die Deckung ist der Anteil der bedeutungstragenden Wörter der Musterantwort, die auch in der Antwort stehen. Als Wort zählt eine Folge aus Buchstaben, Ziffern und Bindestrichen mit 3 bis 64 Zeichen; Füllwörter wie „der“, „die“ oder „und“ fallen weg, und jedes Wort zählt einmal. Eine Zusammensetzung mit Bindestrich zählt als ihre Teile und als zusammengeschriebenes Ganzes. Der Wert wird auf drei Stellen gerundet und in Prozent angezeigt.

nicht messbar heißt: Es kam keine auswertbare Antwort, etwa weil das Kontingent aufgebraucht war, die Notfallantwort kam oder die Antwort leer blieb. Eine solche Zeile ist nicht durchgefallen. Der Grund steht daneben, und die Quote lässt sie aus.

Abnahme starten

1. 1

   Schritt 1

   Lauf anstoßen

   Abnahme starten reiht einen Lauf ein; der Dienst antwortet sofort mit 202, die Arbeit geschieht im Hintergrund. Der Knopf ist gesperrt, solange ein Lauf offen ist, ohne veröffentlichte Fassung, ohne angehakte Prüffrage und mit der Rolle Lesen. Ist für den Assistenten schon ein Lauf eingereiht oder in Arbeit, der jünger als eine Stunde ist, bekommen Sie diesen zurück statt eines zweiten. Während des Startens zeigt der Knopf Wird geladen ….

2. 2

   Schritt 2

   Fragen stellen

   Der Lauf nimmt die angehakten Prüffragen, höchstens 50, geordnet nach Position und dann nach Anlagezeitpunkt, und die Fassung, die bei seinem Beginn veröffentlicht ist. Für jede Prüffrage legt er ein eigenes Gespräch im Kanal Test an und stellt die Frage auf demselben Weg, den eine Besucherfrage im Widget nimmt, mit Suche und Werkzeugen; Werkzeuge gelten dabei als Besucher (öffentlicher Chat). Die Antwortsprache folgt der Sprache, die der Dienst an der Frage erkennt. Gelingt das nicht, gilt die Sprache der Prüffrage, die sich nur über die Schnittstelle setzen lässt, und ohne sie die Sprache der Fassung.

3. 3

   Schritt 3

   Verfolgen

   Während des Laufs steht Der Lauf ist eingereiht. Diese Seite frischt sich selbst auf, solange er läuft. Die Seite fragt alle 3 Sekunden nach, solange das Fenster sichtbar ist. Die Zähler wachsen nach jeder Prüffrage; die Liste der Prüffragen lädt nach dem Ende einmal neu.

4. 4

   Schritt 4

   Auswerten

   Unter Letzter Lauf stehen Fragen, Bestanden, Durchgefallen, Nicht messbar, Quote und Dauer, dazu Stand, Zeitpunkt und gegebenenfalls ein Grund. Der Zeitpunkt ist der des Einreihens. Dauer zeigt Nicht gemessen, solange der Lauf eingereiht ist oder läuft, und bleibt so, wenn er abgebrochen wurde. Darunter folgen die Ergebnisse je Prüffrage. In der Liste zeigt jede Prüffrage ihr letztes Urteil und unter Zuletzt dessen Zeitpunkt. Gab es noch keinen Lauf, steht Noch kein Lauf.

Die Quote ist die Zahl der bestandenen geteilt durch bestandene plus durchgefallene Zeilen; nicht messbare zählen nicht mit. Wurde keine Zeile gemessen, gibt es keine Quote, und angezeigt wird Nicht gemessen. Sind Zeilen nicht messbar, steht Eine nicht messbare Zeile ist nicht durchgefallen. Der Grund steht daneben, und die Quote lässt sie aus. Die Oberfläche zeigt nur den letzten Lauf; die Schnittstelle liefert die 30 neuesten.

Ergebnisse lesen

Stände, Urteile und Gründe

Eine Kennung ohne Anzeigetext, etwa tenant_unknown, zeigt die Oberfläche unverändert an, statt sie zu verschlucken.

Prüffragen ändern und löschen

In der Liste zeigt jede Prüffrage Frage, Musterantwort, ihr letztes Urteil mit Zuletzt, die Begriffe unter Muss enthalten und Darf nicht enthalten sowie die Mindestdeckung in Prozent. Der Haken Läuft mit wird sofort einzeln gespeichert. Text und Begriffe lassen sich in der Oberfläche nicht bearbeiten: Löschen Sie die Prüffrage und legen Sie sie neu an, oder ändern Sie sie über die Schnittstelle.

Löschen entfernt die Prüffrage sofort und ohne Rückfrage. Frühere Ergebnisse bleiben mit ihrer Frage und Musterantwort lesbar, verlieren aber den Bezug zur Prüffrage. Wird der Assistent gelöscht, verschwinden seine Prüffragen und Läufe mit.

Rollen und Drossel

Ansehen darf jede Rolle. Anlegen, Ändern, Löschen und Abnahme starten verlangen mindestens Bearbeiten. Mit der Rolle Lesen sehen Sie Prüffragen, Lauf und Urteile, aber Formular, Haken und Abnahme starten sind gesperrt, Löschen fehlt, und oben steht Mit der Rolle Lesen lässt sich hier nur ansehen. Ändern kann, wer mindestens die Rolle Bearbeiten hat. Anlegen, Ändern und Starten sind auf 30 Anfragen je Minute und Person gedrosselt. Der Zähler ist derselbe wie beim Anlegen und Ändern von Assistenten, ihren Fassungen und Werkzeugen. Löschen hat keine eigene Drossel. Mehr unter Team und Rollen.

Schnittstelle

Alle Pfade beginnen mit /api/v1/ und verlangen eine Anmeldung mit bestätigter E-Mail-Adresse; siehe Grundlagen der Schnittstelle, Anmeldung und Grenzen. Der Probierdialog nutzt POST /api/v1/conversations mit assistant_id und danach POST /api/v1/conversations/{id}/send mit text; beide beschreibt Gespräche und Verwaltung. Für die Abnahme gelten die folgenden Endpunkte. Ist der Assistent {id} unbekannt, antwortet jeder von ihnen mit 404 not_found.

Eine Prüffrage in check und checks trägt id, question, expected, must_contain, must_not_contain, min_overlap, language, position und is_active, dazu last_result (pass, fail, error, vor dem ersten Lauf null) und last_run_at. Die beiden letzten setzt nur ein Lauf, auch bei einem nicht messbaren Ergebnis; über die Schnittstelle lassen sie sich nicht schreiben.

Häufige Fragen