Connessione a Slack

Modifica online

Utilizza l'integrazione Slack per abilitare Slack come canale di comunicazione per il tuo agente. I team che utilizzano Slack possono comunicare con i propri agenti in tempo reale direttamente all'interno di Slack.

Integra il tuo agente con Slack utilizzando le app Slack, che mettono a disposizione degli utenti le funzioni disponibili dell'agente. A seconda della sua configurazione, l'app Slack può rispondere agli utenti nei canali in cui viene menzionata o nei messaggi diretti. È inoltre possibile collegare gli agenti in fase di bozza a un'app Slack per testarli prima di distribuirli in produzione. L'integrazione utilizza l'ID cliente, il segreto cliente e il segreto di firma dell'app per stabilire una connessione sicura e autenticata.

Interazioni supportate

L'integrazione Slack supporta le seguenti interazioni dai flussi di lavoro Agentic come entità avanzate:

  • Input di testo

  • Inserimento numerico

  • moduli

Per abilitare i moduli interattivi nella tua configurazione Slack esistente, consulta la guida "Abilitare l'interazione con i moduli all'interno di Slack".

Cosa imparerai

In questo argomento imparerai come:

  • Verifica i prerequisiti necessari prima di configurare l'integrazione con Slack.

  • Configurare l'integrazione con Slack, inclusa l'impostazione degli ambiti dell' OAuth e degli URL di reindirizzamento.

  • Abilita la visibilità delle e-mail in Slack in modo che il tuo agente possa recuperare gli indirizzi e-mail degli utenti.

  • Configura la tua app Slack per supportare la messaggistica diretta.

  • Abilita le interazioni in modalità split-view per migliorare l'esperienza utente su Slack.

Prima di iniziare

Per avviare l'integrazione, assicurati che siano soddisfatti i seguenti prerequisiti:

  • Uno spazio di lavoro Slack con autorizzazione a creare o gestire app.

  • Un'app Slack creata all'interno del tuo spazio di lavoro. Puoi creare un'app Slack qui.

  • Accesso alle credenziali di autenticazione dell'app, tra cui:

    • ID cliente : un identificatore univoco per la tua app Slack, utilizzato per autenticare le richieste API.

    • Segreto cliente : una chiave riservata utilizzata per verificare l'identità della tua app Slack durante l'autenticazione.

    • Segreto di firma : un token segreto che garantisce che le richieste in arrivo alla tua app provengano da Slack.

    • OAuth e utente del bot : il token di accesso del bot (che inizia con ) utilizzato per le chiamate API effettuate per conto del bot.
    • ID del team : l'ID del tuo spazio di lavoro Slack (che inizia con T), che puoi trovare all'indirizzo URL del tuo spazio di lavoro o nelle impostazioni.

Per trovare queste credenziali nella tua app Slack:

  • ID cliente, segreto cliente e segreto di firma : vai su Informazioni di base > Credenziali dell'app
  • Token dell'utente del bot OAuth : vai su OAuth e seleziona Autorizzazioni > Token dell'utente del bot OAuth (inizia con xoxb-)
  • ID del team : lo trovi nel tuo ID Slack (inizia con T, lo trovi nell'area di lavoro URL o nelle impostazioni)
Importante:

Le app di prova sono applicazioni Slack preconfigurate che puoi utilizzare per dimostrazioni o ambienti di staging. Utilizzate le bozze di app per testare le funzioni di integrazione di Slack, verificare l'autenticazione ed esplorare il comportamento dei canali prima di passare alla produzione.

Configura l'integrazione con Slack

Segui questi passaggi per integrare Slack come canale di comunicazione:

  1. Vai su https://api.slack.com/apps e seleziona la tua app.
  2. Vai su Canali > Slack.
  3. Seleziona l'ambiente (Bozza o Live) e clicca su Crea nuovo.
  4. Nella pagina Introduzione, leggi le istruzioni e segui i passaggi pertinenti. Quando sei pronto, clicca su Avanti.
  5. Nella pagina Crea la tua app Slack, seguite le indicazioni fornite e applicate i passaggi pertinenti. Quindi, fare clic su Avanti.
  6. Nella pagina Connetti a Slack, inserisci, Client ID Client secret, e Signing secret che hai salvato in precedenza.

    Segui i passaggi relativi a nella pagina " Connettiti a Slack ". I passaggi potrebbero includere l'abilitazione di OAuth, la configurazione degli ambiti richiesti e l'impostazione degli URL di reindirizzamento appropriati:

    • app_mentions:read
    • chat:write
    • im:history
    • im:write
    • users.profile:read

    Puoi trovare i dettagli di ciascuna funzione nella documentazione di Slack.

  7. Fare clic su Avanti.
  8. Nella pagina Installa (agente, bot) in Slack, fare clic su Imposta per installare l'app Slack nell'area di lavoro. Seguire le istruzioni visualizzate. Al termine dell'installazione, fare clic su Avanti.
    Nota: se sei uno sviluppatore e non un amministratore dell'area di lavoro Slack, Slack ti chiederà di inviare una richiesta di installazione quando provi ad aggiungere l'app. Invia la richiesta e attendi che un amministratore dell'area di lavoro la approvi. Dopo l'approvazione dell'app, torna alla procedura di configurazione e segui gli stessi passaggi per completare l'installazione.
  9. Nella pagina Configura agente in Slack, segui le istruzioni per aggiornare le impostazioni dell'app Slack. Applica e salva le modifiche consigliate.
  10. Fare clic su Fine.
  11. Esegui l'installazione dell'agente e copia l' URL e degli eventi dall'output dell'installazione.
  12. Aggiorna l' URL e degli eventi nelle impostazioni degli abbonamenti agli eventi della tua app Slack.
    Importante: dopo aver distribuito l'agente, copia l' URL e dell'evento dall'output della distribuzione e aggiornala nelle impostazioni degli abbonamenti agli eventi della tua app Slack. L' URL e dell'evento cambia ad ogni distribuzione.
  13. Verifica che il tuo ambiente Draft o Live sia connesso. Accedi a Slack e aggiungi l'applicazione appena creata al tuo spazio di lavoro. Devi essere in grado di comunicare con l'agente tramite l'app Slack.

Dopo aver salvato l'integrazione, puoi modificarla o eliminarla in qualsiasi momento in base alle tue esigenze.

Suggerimento:

Per consentire al tuo agente di recuperare gli indirizzi e-mail e i nomi degli utenti, assicurati che le impostazioni di visibilità di e-mail e nomi siano attivate nel tuo spazio di lavoro Slack. Per ulteriori informazioni, consulta la sezione "Abilita la visibilità delle e-mail su Slack".

Abilitare la visibilità delle e-mail su Slack

Slack nasconde gli indirizzi e-mail degli utenti se l'impostazione Visualizzazione e-mail è disattivata nel tuo spazio di lavoro. Quando ciò accade, users.profile.get l'API non è in grado di restituire i valori delle e-mail. watsonx Orchestrate utilizza l'indirizzo e-mail dell'utente per identificare i partecipanti e gestire le variabili di contesto, pertanto questa impostazione deve essere abilitata affinché l'integrazione funzioni correttamente. Per evitare questi problemi, assicurati che l'impostazione "Visualizzazione e-mail" sia abilitata nel tuo spazio di lavoro Slack, in modo che l'operatore possa accedere agli indirizzi e-mail degli utenti tramite l'API di Slack. Per abilitare la visibilità delle e-mail su Slack:

  1. Su Slack, clicca sull'icona Strumenti di amministrazione situata nel menu a sinistra e seleziona l'opzione Impostazioni dell'area di lavoro.

  2. Nella pagina "Impostazioni e autorizzazioni ", individua la sezione "Visualizzazione e-mail" ed espandila per visualizzare l'impostazione corrente relativa alla domanda: "Chi può vedere gli indirizzi e-mail dei membri di _[nome dell'area di lavoro]_?"

  3. Selezionare una delle seguenti opzioni:

    • Membri e ospiti di _[nome dello spazio di lavoro]_

    • I membri e gli ospiti di _[nome dello spazio di lavoro]_, oltre alle persone appartenenti a organizzazioni esterne con cui sei in contatto

Selezionando una delle due opzioni, watsonx Orchestrate potrà recuperare gli indirizzi e-mail degli utenti tramite l'API di Slack.

Nota:

Se desideri che l'agente possa accedere sia agli indirizzi e-mail che ai nomi visualizzati, assicurati che le impostazioni "Visualizzazione e-mail" e "Visualizzazione nome" siano entrambe attivate nella pagina "Impostazioni e autorizzazioni".

Abilita la comunicazione diretta con l'app in Slack

Per impostazione predefinita, gli utenti possono interagire con un'app Slack solo quando l'app è stata aggiunta a un canale e menzionata esplicitamente utilizzando il simbolo @. Per consentire agli utenti di comunicare direttamente con la tua app Slack, devi aggiornare le autorizzazioni e le impostazioni di configurazione dell'app.

Abilita i messaggi diretti con l'app Slack

  1. Vai su https://api.slack.com/apps e seleziona la tua app.

  2. Vai alla Home dell'app e scorri fino alla sezione Mostra schede.

  3. Nella scheda Messaggi, imposta l'interruttore su On per consentire la messaggistica diretta con la tua app.

  4. Seleziona Consenti agli utenti di inviare comandi Slash e messaggi dalla scheda Messaggi.

Ora puoi avviare interazioni dalla finestra dei messaggi dell'app.

Abilita le interazioni in modalità a schermo diviso

Se desideri che gli utenti interagiscano con la tua app in modalità Split View ↗, configura l'impostazione seguente:

  1. Vai su https://api.slack.com/apps e seleziona la tua app.

  2. Vai su " OAuth " e "Permissions" nel menu e imposta gli ambiti:

    • assistant:write

  3. Nella sezione Agenti e app AI, individua l'opzione Agente o Assistente.

  4. Attiva l'interruttore per attivare il supporto per le conversazioni in modalità split-view.

Ora dovresti essere in grado di comunicare direttamente con la tua app Slack tramite messaggi diretti e, se abilitato, interazioni in modalità split-view.

Cosa fare successivamente

Per aggiungere variabili di contesto specifiche per Slack, segui le istruzioni fornite in Variabili di contesto Slack.

Per ulteriori dettagli sulle app di IA in Slack, consulta la guida "Informazioni sulle app di IA in Slack" ↗.