In Slack integrieren

Slack ist eine cloudbasierte Messaging-Anwendung zur Unterstützung der Onlinezusammenarbeit von Benutzern.

Nachdem Sie eine Aktion erstellt haben, können Sie Ihren Assistenten in Slack integrieren.

Nach der Integration kann Ihr Assistent abhängig von den Ereignissen, für deren Unterstützung Sie den Assistenten konfigurieren, auf Fragen antworten, die in direkten Nachrichten oder in Kanälen, in denen der Assistent direkt erwähnt wird, gestellt werden.

Ein Beispiel und eine Anleitung zur Erstellung eines Slackbots unter Verwendung von KI-Assistent, Slack und Db2 finden Sie im Lösungs-Tutorial Build a database-driven Slackbot.

Vorbereitende Schritte

Um Slack in Ihren Assistenten zu integrieren, müssen Sie über eine Slack-App und die erforderlichen Rollen und Berechtigungen verfügen:

Rollen Berechtigungen
Arbeitsbereich oder '
Org-Eigentümer		 Informationen anzeigen '
Informationen buchen '
Aktionen durchführen

Um eine Slack-App zu erstellen, siehe Schnellstart: Starten Sie einen Workflow.

Weitere Informationen zu Rollen und Berechtigungen finden Sie unter Slack - Erste Schritte.

Slack-Integration hinzufügen

  1. Rufen Sie die Seite Integrationen auf, indem Sie im linken Menü auf das Symbol für Integrationen (Symbol 'Integrationen') klicken.

  2. Klicken Sie auf der Kachel Slack auf Hinzufügen.

  3. Klicken Sie dann erneut auf Hinzufügen.

Erste Schritte

Die Einrichtung von Slack erfolgt in vier Schritten:

  • Einrichten Ihres Slack-Bots
  • Verbinden Sie watsonx Assistant mit Slack
  • Konfigurieren Sie Ihren Slack-Bot
  • Verbinden Sie Ihren Assistenten

Einrichten Ihres Slack-Bots

  1. Gehen Sie auf die Seite Ihre Apps auf der Slack-Website und klicken Sie dann auf die App, die Sie verwenden möchten, oder erstellen Sie eine neue App.

Verbinden Sie watsonx Assistant mit Slack

  1. Gehen Sie auf der Seite mit den Einstellungen für die Slack-App auf die Registerkarte Grundlegende Informationen und scrollen Sie nach unten zum Abschnitt Anmeldeinformationen für die App.

  2. Kopieren Sie Ihr Verifizierungs-Token und fügen Sie es auf der Einrichtungsseite des Assistenten ein.

  3. Gehen Sie auf der Einstellungsseite der Slack-App zu Funktionen > OAuth & Berechtigungen und scrollen Sie nach unten zum Abschnitt Bot Token Scopes.

  4. Klicken Sie auf OAuth Scope hinzufügen und wählen Sie die folgenden Scopes aus:

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write

  5. Scrollen Sie auf der Seite nach oben zum Abschnitt OAuth Tokens für Ihren Arbeitsbereich und klicken Sie auf App im Arbeitsbereich installieren und dann auf Zulassen.

    Sie sollten wieder zur Seite OAuth & Berechtigungen weitergeleitet werden.

  6. Kopieren Sie Ihr OAuth-Zugangs-Token für den Bot-Benutzer und fügen Sie es auf der Einrichtungsseite des Assistenten ein.

  7. Klicken Sie auf Weiter, um fortzufahren.

Konfigurieren Sie Ihren Slack-Bot

  1. Kopieren Sie die generierte Anfrage URL.

  2. Gehen Sie auf der Einstellungsseite der Slack-App zu Features > Event Subscriptions und schalten Sie den Schalter Enable Events ' on um.

  3. Fügen Sie den Link URL unter URL ein.

    Warten Sie, bis Sie "Verified" mit einem grünen Häkchen neben " Request URL " sehen.

  4. Scrollen Sie nach unten und klicken Sie auf Bot-Ereignisse abonnieren.

  5. Wählen Sie die Ereignistypen aus, die Sie abonnieren möchten. Sie müssen mindestens einen der folgenden Typen auswählen:

    • message.im: Überwacht Nachrichtenereignisse, die in einem Direktnachrichtenkanal übergeben werden.

    • app_mention: Hört nur auf Nachrichtenereignisse, die Ihre App oder Ihren Bot erwähnen.

      Wählen Sie den Eintrag app_mention in normaler Schrift und nicht den Eintrag app_mention in fetter Schrift.

  6. Klicken Sie auf Änderungen speichern.

  7. Klicken Sie auf der Seite zur Einrichtung des Assistenten auf Weiter.

Verbinden Sie Ihren Assistenten

  1. Gehen Sie auf der Einstellungsseite der Slack-App zu Funktionen > AppHome und klicken Sie auf Bearbeiten neben App-Anzeigename.

  2. Klicken Sie auf Speichern, sobald Sie die Änderungen vorgenommen haben.

  3. Schalten Sie den Schalter Meinen Bot immer als online anzeigen auf ' on um.

  4. Gehen Sie zum Abschnitt Registerkarten anzeigen und schalten Sie die Registerkarte Nachrichten auf " on um.

  5. Aktivieren Sie das Kontrollkästchen Benutzern das Senden von Slash-Befehlen und Nachrichten über die Registerkarte Nachrichten erlauben.

  6. Wenn Sie Unterstützung für die Anzeige von Schaltflächen, Menüs und Disambiguierungsoptionen in der Slack-App hinzufügen möchten, führen Sie die folgenden Schritte aus:

    1. Gehen Sie zur Registerkarte " Interaktivität & Verknüpfungen" und aktivieren Sie die Funktion
    2. Fügen Sie Ihre Anfrage URL in das vorgesehene Texteingabefeld ein.
    3. Klicken Sie auf Änderungen speichern.

  7. Klicken Sie auf der Seite für die Einrichtung des Assistenten auf Fertig stellen.

Wenn ein für die Authentifizierung erforderliches " token -Feld geändert wird, müssen alle Einträge in den entsprechenden Feldern erneut ausgefüllt und validiert werden.

Hinweise zu Aktionen

Die Rich-Antworten, die Sie einer Aktion hinzufügen, werden in einem Slack-Kanal angezeigt, mit folgenden Ausnahmen:

  • Verbindung zum Live-Agenten herstellen: Dieser Antworttyp wird ignoriert.

  • Option: Dieser Antworttyp zeigt eine Liste der Optionen, die für den Benutzer zur Auswahl stehen.

    • Nachdem ein Benutzer auf eine der Optionen geklickt hat, verschwindet die vorhandene Auswahl und wird durch die Benutzereingabe ersetzt, die durch die Auswahl des Benutzers erzeugt wird. Wenn Sie mehrere Antworttypen in eine einzige Antwort einbeziehen, müssen Sie die Option Antworttyp am Ende positionieren, um Verwirrungen aufgrund einer Mischung von Antworten und Benutzereingaben zu vermeiden.

    • Wenn die Optionen in einer Dropdown-Liste angezeigt werden, darf jeder Optionswert höchstens 75 Zeichen lang sein. Wenn eine Liste 5 oder mehr Optionen enthält, wird sie in einer Dropdown-Liste angezeigt.

Mit dem Assistenten chatten

So starten Sie einen Chat mit dem Assistenten:

  1. Öffnen Sie Slack und rufen Sie den Arbeitsbereich auf, der Ihrer App zugeordnet ist.
  2. Klicken Sie im Abschnitt für Anwendungen auf die Anwendung, die Sie erstellt haben.
  3. Chatten Sie mit dem Assistenten.

Die Begrüßungsaktion wird von der Slack-Integration nicht verarbeitet. Die Begrüßungsnachricht wird im Slack-Kanal nicht wie in der Vorschau des Assistenten angezeigt. Dies liegt daran, dass Knoten mit der Sonderbedingung welcome in den von Benutzern gestarteten Aktionsabläufen übersprungen werden. Slack wartet, bis der Benutzer das Dialogmodul startet.

Der Aktionsablauf für die aktuelle Sitzung wird nach 60 Minuten Inaktivität erneut gestartet (5 Minuten für Lite- und Standardpläne). Mit anderen Worten: Wenn ein Benutzer 60 bzw. 5 Minuten lang nicht mit dem Assistenten interagiert, werden alle während des vorherigen Dialogs gesetzten Werte für Kontextvariablen auf null oder auf die jeweiligen Standardwerte zurückgesetzt.