Import von Trainingsbeispielen per API
Für den Import von Trainingsbeispielen zu einem Intent steht für Entwickler und Fortgeschrittene eine API zur Verfügung.
Um die Funktionsweise zu erläutern, stellen wir die Import-Schritte als Kommandozeilen-Befehle vor.
Auf diese Weise kann man auch ohne tiefere Programmierkenntnisse einen Mehrfachimport von Trainingsbeispielen für eine Absicht umsetzen.
Voraussetzung
- Kiko CMS-Konto mit System-Berechtigung "Admin" - https://www.kiko.bot/kostenlos-registrieren-chatbot-cms/
- Kommandozeile mit dem Befehl "curl" z.B. auf dem eigenen Rechner
- Kommandozeilentool "jsonpp" zur Formatierung der JSON-Ausgabe
Schritte im Kiko CMS
API Key holen
- Als Nutzer einloggen mit der System-Berechtigung "Admin".
- Oben rechts zu Profil gehen und den API Key merken.
ML-basierte Intent-Erkennung aktivieren
- Zur Bot-Liste gehen - z.B. zum Metabot - Aktionen: Bot bearbeiten
- Zum Feld "Verwendung von NLU / NLP" gehen und "Erkennung der Absichten anhand von Trainingssätzen (NLU) und Entitätstypen (NLP)" wählen.
Lege einen Intent fürs Training an
- Zu "Inhalt" gehen - Metabot - Absichten - Aktion: Neue Absicht hinzufügen
- Bezeichnung: Uhrzeit
- Ergebnis: Text - "Es ist 12 Uhr."
Per Kommandozeile
Variablen vorbereiten
- JSON-Textdatei "beispiele-uhrzeit.json" mit folgendem Inhalt speichern und Pfad zur Datei merken.
- {
- "question": [
- "Wie spät ist es?",
- "Wie spät?",
- "Was ist die Uhrzeit?"
- ]
- }
- Start der Konsole oder Kommandozeile
- Variaben per Kommandozeile anlegen:
Ermittlung der Bot-ID
- Die Liste aller Bots per Kommandozeile ermitteln:
- curl -X GET "${HOST}/api/api/v1/bot" -H "Authorization: ${APIKEY}" | json_pp
- Nach Zeile suchen: "name" : "metabot"
- Die zugehörige ID des gewünschten Bots ermitteln, eine Zeile unter dem Namen
- Die Bot-ID in einer Variable speichern:
- BOTID=2badd3cc-xxxx-xxxx-85fa-d4e4d7dec8b4
Ermittlung der Intent-ID
- Die Liste aller Intents des Bots ermitteln:
- curl -X GET "${HOST}/api/api/v1/bot/${BOTID}/intent" -H "Authorization: ${APIKEY}" | json_pp
- Nach der Zeile suchen: "name" : "Uhrzeit"
- Die zugehörige ID des gewünschten Bots ermitteln, zwei Zeilen unter dem Namen.
- Die Intent-ID in einer Variable speichern:
- INTENTID=5ebe1f5e-xxxx-xxxx-85ec-c67a0abf037b
Beispiele zum Intent hinzufügen
- Variante 1 - per Json-Datei (s.o.):
- curl -X POST -d @${JSONFILE} "${HOST}/api/api/v1/bot/${BOTID}/intent/${INTENTID}/example-question" -H "Content-Type: application/json" -H "Authorization: ${APIKEY}"
- Variante 2 - direkte Speicherung der Trainingsbeispiele:
- curl -X POST "${HOST}/api/api/v1/bot/${BOTID}/intent/${INTENTID}/example-question" \
- -H "Content-Type: application/json; charset=utf-8" -H "Authorization: ${APIKEY}" \
- --data-binary @- << EOF
- {
- "question": [
- "Wie spät ist es?",
- "Was ist die Uhrzeit?"
- ]
- }
- EOF
Kontrolle der Inhalte im CMS
- Kiko CMS - Inhalt - metabot - Beispielfragen - Uhrzeit ... die drei Beispielfragen werden angezeigt
Kontrolle des Trainings
- Bot-Aktion "ML-Training starten" wählen
- In den Testchat tippen: "Wie spät ist es gerade?" --> "Es ist 12 Uhr."
Referenzen:
- Kiko Chatbot API Referenz - Post Intent Example
Related Articles
PDF - Formular per Chat (Teil 1)
In der öffentlichen Verwaltung und in den Unternehmen werden die bisherigen Papierformulare immer häufiger durch PDF-Dokumente ersetzt. Mithilfe des Service "pdf-fill-in" kann der Nutzer beim Ausfüllen eines solchen PDF-Formulars durch einen Chatbot ...
Anzeige von PDFs im Infobereich
Über den Support können Sie sich den zusätzlichen WYSIWYG-Editor für Antworten freischalten lassen. Mit dem Editor können Sie eine externe Webseite oder eine PDF mit einer Textstelle der Antwort verlinken. Den Link können Sie dabei so konfigurieren, ...
Webchat-Widget abhängig von der Fensterbreite positionieren (responsiv)
Moderne Webseiten passen das eigene Layout an die Größe des aktuellen Fensters an. Dabei kann es zu einer Überlappung des Widgets mit einem anderen Layout-Element der Hintergrund-Seite kommen. Eine mögliche Lösung für dieses Darstellungsproblem ist ...
Nutzerdaten abfragen und per Mail weiterleiten - Tutorial 1 für Fortgeschrittene (19 min)
Aufgabe Ø Dauer 6. Mailer-Bot anlegen 5 min 7. Formular-Parameter einrichten 3 min 8. Formular-Einleitung erstellen 6 min 9. Formular-Weiterleitung einrichten 5 min In diesem Tutorial erkläre ich Ihnen, wie man eine Formular-Funktion anlegt. Bitte ...
Kiko Leistungsbeschreibung
Allgemeines Mit der Chatbot-Plattform Kiko kann man sich einen eigenen Chatbot mit einem CMS entwickeln. Diesen Bot kann man in die eigene Website oder in andere Kommunikationskanäle integrieren und seinen Nutzern zur Verfügung stellen. Die Inhalte ...