Automazione dei comandi Slack

1. Introduzione

In questo codelab, puoi trovare le istruzioni per creare un servizio di riepilogo in uno spazio di lavoro Slack fornendo un'integrazione con il comando slash di Slack.

L'utente richiama un comando slash /summarize e inserisce il testo da riassumere. L'applicazione Slack richiama quindi la funzione Cloud Functions associata che accetta il testo e richiama l'API PaLM per il riepilogo. Il testo riassuntivo viene quindi restituito al comando slash di Slack e visualizzato come risposta nell'applicazione Slack.

. L'elenco dei servizi Google Cloud utilizzati è:

  1. Cloud Functions
  2. API Vertex AI PaLM
  3. Cloud Logging

Cosa creerai

Creerai

  • Una funzione Cloud Functions che richiama l'API PaLM per il riepilogo del testo proveniente da Slack utilizzando il comando slash
  • Applicazione Slack che richiama la funzione Cloud Functions precedente per il riepilogo.

2. Requisiti

  • Un browser, ad esempio Chrome o Firefox
  • Un progetto cloud Google Cloud con la fatturazione abilitata

3. Prima di iniziare

  1. Nella console Google Cloud, nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud.
  2. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.
  3. Assicurati che le API Cloud Functions e Vertex AI siano abilitate.
  4. Attiva Cloud Shell dalla console Google Cloud seguendo le istruzioni riportate qui.
  5. Se il progetto non è impostato, utilizza il seguente comando per impostarlo:
gcloud config set project <YOUR_PROJECT_ID>
  1. In Cloud Shell, imposta le seguenti variabili di ambiente:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1

4. Deployment della funzione Cloud Functions

Per creare ed eseguire il deployment di Cloud Functions:

  1. Clona il codice dal repository https://github.com/rominirani/genai-apptemplates-googlecloud eseguendo questo comando nel terminale Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
  1. Questo comando clona i contenuti del repository nella cartella genai-templates-googlecloud.
  2. Vai alla cartella del progetto che ci interessa eseguendo questo comando dal terminale Cloud Shell:
cd genai-apptemplates-googlecloud/summarization-slack
  1. Dovresti visualizzare i file main.py e requirements.txt nella cartella summarization-slack eseguendo il comando dir o accedendo all'editor di Cloud Shell.
  2. Per eseguire il deployment della funzione cloud, esegui il comando gcloud functions deploy:
gcloud functions deploy summarizeText \
--gen2 \
--runtime=python311 \
--source=. \
--region=$GCP_REGION \
--project=$GCP_PROJECT \
--entry-point=summarizeText \
--trigger-http \
--set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION \
--max-instances=1

Dopo aver eseguito il deployment della funzione Cloud Functions, l'URL della funzione Cloud Functions di cui è stato eseguito il deployment viene visualizzato nel terminale Cloud Shell. L'URL ha il seguente formato:

https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText

Prendi nota dell'URL visualizzato, sarà necessario per creare il comando slash di Slack.

5. Creare il comando slash di Slack

Creiamo un comando slash personalizzato in Slack. Questo comando personalizzato /summarize richiama la funzione Cloud Functions che abbiamo eseguito il deployment nella sezione precedente.

Per creare un comando slash, segui questi passaggi:

  1. Vai su api.slack.com/apps.
  2. Fai clic su Crea nuova app.
  3. Nella finestra Crea un'app, scegli l'opzione Da zero.
  4. Inserisci un nome per l'app. Ad esempio, Summarization Slack Application. Seleziona lo spazio di lavoro Slack per lo sviluppo dell'app.
  5. Fai clic su Crea app. Si apre la pagina Impostazioni.
  6. Nella pagina Impostazioni, fai clic su Informazioni di base > Comandi slash. Fai clic su Crea nuovo comando.
  7. Nel modulo Crea nuovo comando, fornisci i seguenti valori:
  • Comando: dai un comando slash. Ad esempio, /summarize.
  • URL di richiesta: fornisci l'URL completo della funzione Cloud Functions che abbiamo implementato. Ad esempio, https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
  • Inserisci una descrizione breve, un suggerimento per l'utilizzo e salva.
  1. Torna a Impostazioni > Informazioni di base. Fai clic su Installa l'app e poi su Installa in Workspace. L'app viene installata nel tuo spazio di lavoro.

In questo modo viene completata la creazione dell'app Slack personalizzata, ora installata nel tuo workspace Slack e dotata di un comando slash personalizzato (/summarize) che aiuta un utente a riassumere il testo fornito nel messaggio.

6. Testare il comando slash

  1. Vai allo spazio di lavoro Slack in cui hai installato l'applicazione Slack di riepilogo:

Vai su https://slack.com/intl/en-in/workspace-signin e inserisci "Trova i tuoi spazi di lavoro" per individuare il nome del tuo spazio di lavoro. Selezionalo.

  1. Nella chat, inserisci il testo preceduto dal comando slash "/summarize ". Di seguito è riportato un esempio di chiamata:

bcb511e5909709db.png

  1. Fai clic sul pulsante Invia per richiamare la funzione Cloud Functions e visualizzare la risposta di riepilogo come mostrato di seguito:

a62b223f30bb163e.png

7. Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo post, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.
  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.
  4. Se vuoi conservare il progetto, salta i passaggi precedenti ed elimina la funzione Cloud navigando in Cloud Functions, selezionando la funzione che vuoi eliminare dall'elenco e facendo clic su ELIMINA.

8. Complimenti

Complimenti! Hai creato correttamente un servizio di riepilogo del testo nell'applicazione Slack.