Live-Datenquellen (Speisekarte, Preisliste, Bestand)

Eine Datenquelle ist eine URL, die Ihnen gehört (eine Speisekarte, eine Preisliste, ein Bestand, freie Termine) und die die Plattform nach Zeitplan abruft, in reinen Text umwandelt und dem Agent zu Beginn des Anrufs vorlegt. Während des Anrufs wird nichts nachgeschlagen: Der Agent beantwortet „Welche Crêpe ist die günstigste?" aus der ganzen Liste, vom ersten Wort an.

Wann sie sich eignet#

• Die Wissensdatenbank ist für Dokumente, die sich selten ändern und durchsucht werden. Ein Katalog, der sich täglich ändert und als Ganzes gelesen werden muss (Preise, was wozu gehört), passt besser zu einer Datenquelle.
• Ein Werkzeug holt eine einzelne Antwort, während der Anrufer wartet. Nehmen Sie ein Werkzeug für Abfragen pro Kunde (eine Bestellung, eine Buchung) und eine Datenquelle für die Liste, nach der alle fragen.

Eine Quelle verbinden#

1. Öffnen Sie den Agent und wechseln Sie zur Registerkarte Data sources.
2. Klicken Sie auf Add data source und beantworten Sie Where does the data come from? mit Ihrem Anbieter. iotSoft POS steht oben in der Liste; fehlt Ihr Anbieter, nehmen Sie Catalogue JSON API oder Text or CSV page.
3. Geben Sie die URL ein und, falls Ihr Anbieter eines verlangt, das Access token. Das Token wird als Geheimnis im Projekt gespeichert und nie wieder angezeigt.
4. Stellen Sie Refresh every (minutes) ein (mindestens 5, Standard 60) und bei Bedarf Max characters (Standard 15000).
5. Klicken Sie auf Connect and fetch. Der erste Abruf läuft sofort, Sie sehen also gleich, ob Adresse und Token funktionieren.
6. Attach die Quelle an den Agent, dann Save und Deploy.

Preview what the agent sees zeigt genau den Text, den der Agent erhält.

So bleibt sie aktuell#

Jede Quelle wird im Hintergrund nach ihrem eigenen Zeitplan abgerufen, von genau einem Server zur Zeit; ein Anruf wartet nie auf einen Abruf. Ein Abruf, der nichts Neues findet, lässt die gespeicherten Daten unangetastet und vermerkt nur, wann die Quelle zuletzt geprüft wurde: Die Liste zeigt sowohl die letzte Prüfung als auch die letzte Änderung. Ein fehlgeschlagener Abruf behält den letzten gültigen Stand und markiert die Quelle mit error und dem Grund; mitten im Anruf ändert sich nichts. Refresh now ruft außerhalb des Zeitplans ab.

Eigenes JSON beschreiben#

Bei Catalogue JSON API sagt das Mapping (JSON) der Plattform, wo in Ihrem Feed was liegt, in Punktnotation: die Liste der Kategorien (list_path), der Kategoriename, die Artikel, Name und Preis jedes Artikels, seine Bestandteile und seine Optionsgruppen. Kostenlose Gruppen werden zu Bestandteilen des Artikels oder zu einer Wahl des Kunden; kostenpflichtige Gruppen werden zu Extras. Passen Sie das Mapping an, bis sich die Vorschau so liest, wie ein Kunde es hören würde.

Gut zu wissen#

• Bis zu 8 Quellen pro Agent.
• Ein Feed über dem Limit wird an einer Kategoriegrenze gekürzt, und der Text sagt, dass die Liste weitergeht, damit der Agent nie behauptet, ein Artikel existiere nicht.
• Adressen in privaten Netzen werden abgelehnt.
• Das Löschen einer Quelle löscht auch ihr gespeichertes Token.