Bereitstellen

Einen KI-Assistenten bereitzustellen bedeutet, ihn außerhalb der QAnswer-App verfügbar zu machen — als Chat-Widget auf Ihrer Website, als öffentlichen Link, den Sie an beliebige Personen senden können, als REST-API für Ihren eigenen Code oder über ein Werkzeug, das Ihr Team bereits nutzt, etwa Slack oder Confluence. Alles Nötige finden Sie im Tab „Bereitstellen“ des Assistenten.

Den Tab „Bereitstellen“ öffnen

Öffnen Sie einen KI-Assistenten und wählen Sie dann Bereitstellen in der Leiste oben auf der Seite des Assistenten, neben Chat und Analysen.

Die Tabs Chat, Analysen und Bereitstellen auf der Seite eines KI-Assistenten
Hinweis
Der Tab „Bereitstellen“ steht nur Benutzern mit Schreibzugriff auf den Assistenten zur Verfügung. Bei reinem Lesezugriff ist der Tab ausgeblendet.

Die Seite „Bereitstellen“

Die Seite „Bereitstellen“ zeigt jeden verfügbaren Kanal als Karte. Ein Klick auf eine Karte öffnet eine kurze, nummerierte Installationsanleitung für diesen Kanal; der Link „Zurück“ oben führt zurück zu dieser Übersicht.

Die Seite „Bereitstellen“ mit der Karte „KI-Assistenten-Bibliothek“ und den integrierten QAnswer-Kanälen
  • KI-Assistenten-Bibliothek — veröffentlicht den Assistenten in der öffentlichen QAnswer-Bibliothek, sodass ihn jeder finden und nutzen kann. Diese Karte sehen nur Plattformadministratoren.
  • Mit QAnswer bereitstellen — die integrierten Kanäle, für die keine externen Werkzeuge oder Konten nötig sind.
  • Drittanbieter-Integrationen — fertige Konnektoren für die Plattformen, mit denen Ihr Team bereits arbeitet.

Integrierte Kanäle

Die Kanäle unter „Mit QAnswer bereitstellen“ werden von QAnswer selbst gehostet:

  • Website-Chatbot — ein Chat-Widget, das Sie mit einem Skript-Snippet in jede Website einbinden.
  • Chat-Oberfläche — ein öffentlicher Chat als ganze Seite, der als Link geteilt wird.
  • Suchoberfläche — eine öffentliche Suche über die Daten des Assistenten als ganze Seite, die als Link geteilt wird.
  • Berichtsgenerator — eine öffentliche Fassung einer Ihrer Berichtsvorlagen, die andere ausfüllen und ausführen können.
  • REST-API — programmatischer Zugriff auf den Assistenten für Ihre eigenen Anwendungen.
  • SPARQL-Oberfläche, Entity-Linker-Oberfläche und KI-Tabelle — öffentliche Oberflächen für die jeweiligen spezialisierten Aufgabentypen.
Warnung
Welche Karten erscheinen, hängt vom Aufgabentyp des Assistenten ab. Ein Chat-Assistent bietet den Website-Chatbot, die Chat-Oberfläche und die REST-API; ein Such-Assistent die Suchoberfläche; ein Berichtsgenerator-Assistent den Berichtsgenerator. Drittanbieter-Integrationen werden nur für Chat-Assistenten aufgeführt. Den Aufgabentyp ändern Sie unter „Aufgabentyp“ im Tab „Allgemein“ des Assistenten-Editors.

Drittanbieter-Integrationen

Unterhalb der integrierten Kanäle verbindet der Abschnitt „Drittanbieter-Integrationen“ den Assistenten mit einer externen Plattform. Die meisten davon binden dasselbe Website-Chatbot-Widget auf die für die jeweilige Plattform übliche Weise ein.

Das Kartenraster „Drittanbieter-Integrationen“ auf der Seite „Bereitstellen“

Jede Karte öffnet eine Schritt-für-Schritt-Anleitung für diese Plattform. Die eigenen Seiten in diesem Abschnitt der Dokumentation behandeln sie im Detail.

Der Zugriff wird einmal für den gesamten Assistenten festgelegt

Jeder integrierte Kanal enthält denselben Schritt „Zugriff wählen“. Es handelt sich um eine Einstellung auf Assistentenebene: Ihre Auswahl gilt für alle Oberflächen des Assistenten gleichzeitig, nicht nur für die gerade konfigurierte. Er bietet diese Optionen:

  • Öffentlich — alle können den Assistenten nutzen, ohne Anmeldung oder API-Schlüssel.
  • Angemeldete Nutzer — alle mit einem Konto auf dieser QAnswer-Plattform, sobald sie angemeldet sind. Der Website-Chatbot bietet diese Option nicht an, da Besucher Ihrer Website nicht bei QAnswer angemeldet sind.
  • Nur mit API-Schlüssel — der Assistent bleibt privat, und die Integration greift mit einem API-Schlüssel darauf zu: einem der vorhandenen Schlüssel des Assistenten oder einem direkt neu generierten.
Hinweis
Unter den Optionen zeigt eine Statusmeldung, ob die Integration bereit ist. Bis dahin bleiben die späteren Schritte jeder Anleitung — das Export-Snippet und der öffentliche Link — ausgegraut. Das Teilen mit bestimmten Benutzern, Teams oder Organisationen ist davon getrennt und befindet sich im Dialog „Teilen“ , den Sie über die Schaltfläche „Teilen“ in der oberen Leiste des Assistenten öffnen.

Das Expose-Add-on

Um einen Assistenten außerhalb von QAnswer erreichbar zu machen, braucht die Organisation, der er gehört, das Expose-Add-on. Ohne es:

  • zeigt die Expose-Seite den Hinweis „Expose-Add-on erforderlich“, und jede Kanalkarte trägt das Abzeichen „Expose-Add-on“. Die Kanäle lassen sich weiterhin öffnen, aber nur lesend: Jeder zeigt denselben Hinweis über seiner Anleitung, und alle Schritte sind ausgegraut und lassen sich nicht ändern;
  • werden die API-Schlüssel des Assistenten abgelehnt: Jedes Widget, jeder Link, jeder REST-Aufruf und jede Drittanbieter-Integration, die einen davon verwendet, erhält HTTP 403 und die Meldung „Dieser API-Schlüssel gehört zu einem Assistenten, dessen Organisation das Expose-Add-on nicht hat, daher kann er außerhalb von QAnswer nicht verwendet werden.“ Die Schlüssel werden nicht gelöscht und funktionieren wieder, sobald die Organisation das Add-on hat.
Die Expose-Seite eines Assistenten, dessen Organisation das Expose-Add-on nicht hat: der Hinweis „Expose-Add-on erforderlich“ mit seiner Schaltfläche, über den Kanalkarten, jede mit einem „Expose-Add-on“-AbzeichenEine ohne Expose-Add-on geöffnete Kanalanleitung: der Hinweis „Expose-Add-on erforderlich“ über der Anleitung für den API-Zugriff, die ausgegraut ist, sodass sich kein Schlüssel erzeugen lässt

Das Teilen des Assistenten mit Benutzern, Teams und Organisationen innerhalb von QAnswer ist nicht betroffen, ebenso wenig Assistenten, die keiner Organisation gehören.

Hinweis
Die Schaltfläche „Add-on erhalten“ im Hinweis öffnet die Abrechnungsseite der Organisation, auf der ein Organisationsadministrator Expose hinzufügen kann. Siehe Plans & Billing.
Hinweis
Um zunächst einen KI-Assistenten zu erstellen, siehe den Abschnitt Einen KI-Assistenten erstellen .