Integrazione con Slack

Modifica online

Slack è un'applicazione di messaggistica basata su cloud che aiuta le persone a collaborare tra loro.

Dopo aver creato un'azione, è possibile integrare l'assistente con Slack.

Una volta integrato, a seconda degli eventi che hai configurato per essere supportati dall'assistente, il tuo assistente può rispondere alle domande poste in messaggi diretti o in canali in cui l'assistente viene menzionato direttamente.

Nel tutorial " Creare uno Slackbot basato su database " sono riportati un esempio e le istruzioni su come creare uno Slackbot utilizzando un assistente AI, Slack e Db2.

Prima di iniziare

Per integrare Slack con l'assistente, è necessario disporre di un'app Slack e dei ruoli e dei permessi necessari:

Ruoli

Autorizzazioni

Titolare dello spazio di lavoro o dell'organizzazione

Visualizza informazioni Pubblica informazioni Esegui azioni

Per creare un'app Slack, consulta la guida introduttiva: Avvia un flusso di lavoro.

Per ulteriori informazioni sui ruoli e sulle autorizzazioni, consulta la guida introduttiva di Slack.

Aggiunta dell'integrazione Slack

  1. Vai alla pagina "Integrazioni " cliccando sull'icona delle integrazioni (Icona delle integrazioni) nel menu a sinistra.

  2. Fate clic su Aggiungi nel riquadro Slack.

  3. Quindi, fare nuovamente clic su Aggiungi.

Introduzione

Le fasi di configurazione di Slack sono quattro:

  • Configurare il bot Slack

  • Collegare l'watsonx Assistant a Slack

  • Configurare il bot Slack

  • Collegare l'assistente

Configura il tuo bot di Slack

  1. Vai alla pagina "Le tue app" sul sito web di Slack, quindi clicca sull'app che desideri utilizzare oppure creane una nuova.

Collega watsonx Assistant a Slack

  1. Nella pagina " Impostazioni dell'app Slack, andare alla scheda " Informazioni di base e scorrere fino alla sezione " Credenziali dell'app.

  2. Copiare il token di verifica e incollarlo nella pagina 'Configurazione dell'assistente.

  3. Nella pagina delle impostazioni dell'app Slack, vai su Funzionalità > " OAuth " e autorizzazioni e scorri verso il basso fino alla sezione Ambiti dei token dei bot.

  4. Fai clic su Aggiungi un ambito OAuth e seleziona gli ambiti seguenti:

    • app_mentions:read

    • chat:write

    • im:history

    • im:read

    • im:write

  5. Scorri la pagina verso l'alto fino alla sezione " OAuth : token per il tuo Workspace ", fai clic su "Installa l'app nel Workspace " e poi su "Consenti ".

Dovresti essere reindirizzato alla pagina " OAuth e e autorizzazioni".

  1. Copia e incolla il token di accesso dell' OAuth e utente del tuo bot nella pagina di configurazione dell'Assistente.

  2. Fare clic su Avanti per continuare.

Configura il tuo bot di Slack

  1. Copiare la richiesta generata URL.

  2. Nella pagina 'Impostazioni dell'app Slack, andare su 'Caratteristiche > 'Abbonamenti agli eventi e commutare il 'Abilitare gli eventi su 'on.

  3. Incollare il link URL sotto Richiesta URL.

Aspettate di vedere Verificato con un segno di spunta verde accanto a Richiedi URL.

  1. Scorrere verso il basso e fare clic su Iscriviti agli eventi bot.

  2. Selezionare i tipi di eventi a cui ci si vuole abbonare. Devi selezionare almeno uno dei seguenti tipi:

    • message.im: elenca gli eventi messaggio pubblicati in un canale di messaggi diretti.

    • app_mention: elenca solo gli eventi messaggio che citano la tua applicazione o il bot.

Scegliete la voce app_mention in carattere normale, non la voce app_mention in carattere grassetto.

  1. Fare clic su Salva modifiche.

  2. Nella pagina 'Configurazione dell'assistente, fare clic su 'Avanti.

Collega il tuo assistente

  1. Nella pagina 'Impostazioni dell'app Slack, andare a 'Caratteristiche > 'AppHome e fare clic su 'Modifica accanto a 'Nome visualizzato dell'app.

  2. Una volta apportate le modifiche, fare clic su Salva.

  3. Passare la levetta Mostra sempre il mio bot come online a 'on.

  4. Andate nella sezione Mostra schede e spostate la levetta della scheda Messaggi su 'on.

  5. Selezionate la casella di controllo Consenti agli utenti di inviare comandi e messaggi Slash dalla scheda Messaggi.

  6. Se si desidera aggiungere il supporto per la visualizzazione di pulsanti, menu e opzioni di disambiguazione nell'app Slack, procedere come segue:

    1. Accedere alla scheda Interattività e scorciatoie e attivare la funzione

    2. Incollate la vostra richiesta URL nell'apposito campo di inserimento testo.

    3. Fare clic su Salva modifiche.

  7. Nella pagina 'Configurazione dell'assistente, fare clic su 'Finitura.

Se un campo " token richiesto per l'autenticazione viene modificato, tutte le voci dei campi correlati devono essere compilate e convalidate nuovamente.

Considerazioni sull'azione

Le risposte complete aggiunte a un'azione vengono visualizzate in un canale Slack, con le seguenti eccezioni:

  • Connettersi all'agente in carne e ossa: Questo tipo di risposta viene ignorato.

  • Option: questo tipo di risposta mostra un elenco delle opzioni tra cui può scegliere l'utente.

    • Dopo che l'utente fa clic su una delle opzioni, le selezioni esistenti scompaiono e vengono sostituite con l'input dell'utente generato dalla sua selezione. Se si includono più tipi di risposta in una singola risposta, è necessario posizionare il tipo di risposta opzionale alla fine, per evitare confusioni dovute alla mescolanza di risposte e input dell'utente.

    • Se le opzioni sono visualizzate in un elenco a discesa, ogni valore dell'opzione deve avere una lunghezza massima di 75 caratteri. Quando un elenco comprende 5 o più opzioni, viene visualizzato in un elenco a discesa.

Chat con l'assistente

Per avviare una chat con l'assistente, completa i seguenti passi:

  1. Apri Slack e vai allo spazio di lavoro associato alla tua applicazione.

  2. Fai clic sull'applicazione che hai creato dalla sezione Apps.

  3. Avvia una chat con l'assistente.

L'azione di benvenuto non viene elaborata dall'integrazione Slack. Il messaggio di benvenuto non viene visualizzato nel canale Slack come nell'anteprima dell'assistente. Non viene attivato da qui perché i nodi con la condizione speciale 'welcome vengono saltati nei flussi di azione avviati dagli utenti. Slack attende che l'utente inizi la conversazione.

Il flusso di azioni per la sessione corrente viene riavviato dopo 60 minuti di inattività (5 minuti per i piani Lite e Standard). Ciò significa che se un utente smette di interagire con l'assistente, dopo 60 (o 5) minuti, i valori delle variabili di contesto impostati durante la conversazione precedente vengono impostati su null o riportati ai loro valori predefiniti.