Automazione dei comandi Slack

1. Introduzione

In questo codelab puoi trovare le istruzioni per creare un servizio di riepilogo in un'area di lavoro Slack fornendo un'integrazione con il comando Slack Slash.

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

di Google. Ecco 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 riassunto del testo proveniente da Slack utilizzando il comando Slash
• Applicazione Slack che richiama la funzione Cloud Functions sopra per il riepilogo.

2. Requisiti

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

3. Prima di iniziare

1. Nella pagina del selettore dei progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
2. Assicurati che la fatturazione sia abilitata per il tuo progetto Google Cloud. Scopri come controllare se la fatturazione è abilitata su un progetto
3. Assicurati che l'API Cloud Functions e le API Vertex AI siano abilitate.
4. Attiva Cloud Shell dalla console Google Cloud seguendo le istruzioni riportate qui
5. Se il progetto non è configurato, utilizza il comando seguente per impostarlo:

gcloud config set project <YOUR_PROJECT_ID>

6. 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, segui questi passaggi:

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

2. Questo comando clonerà i contenuti del repository nella cartella genai-templates-googlecloud.
3. Vai alla cartella del progetto che ci interessa eseguendo questo comando dal terminale Cloud Shell:

cd genai-apptemplates-googlecloud/summarization-slack

4. Dovresti vedere entrambi i file main.py e requirements.txt nella cartella summarization-slack eseguendo il comando dir o accedendo all'editor di Cloud Shell.
5. Per eseguire il deployment della funzione Cloud Functions, esegui il comando gcloud features 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

Nota che l'URL che è stato visualizzato sarà necessario per creare il comando slash di Slack.

5. Crea il comando slash di Slack

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

Per creare un comando slash, segui questi passaggi:

1. Vai ad api.slack.com/apps.
2. Fai clic su Create New App (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 l'area di lavoro di Slack per lo sviluppo della tua app.
5. Fai clic su Crea app. Si apre la pagina Impostazioni.
6. Nella pagina Impostazioni, fai clic su Informazioni di base > Comandi barra. Fai clic su Crea nuovo comando.
7. Nel modulo Crea nuovo comando, inserisci i seguenti valori:

• Comando: assegna un comando con barra. Ad esempio, /summarize.
• URL richiesta: fornisci l'URL completo della funzione Cloud Functions di cui abbiamo eseguito il deployment. Ad esempio, https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
• Inserisci una descrizione breve, un suggerimento di utilizzo e salva.

8. Torna a Impostazioni > Informazioni di base. Fai clic su Installa app e quindi su Installa in Workspace. L'app è installata nell'area di lavoro.

La creazione dell'app Slack personalizzata, ora installata nell'area di lavoro di Slack, è completata e include un comando slash personalizzato (/summarize) che consente all'utente di riassumere il testo fornito nel messaggio.

6. Testa il comando slash

1. Vai all'area di lavoro Slack in cui hai installato l'applicazione Summarization Slack:

Vai alla pagina https://slack.com/intl/en-in/workspace-signin e inserisci "Trova le tue aree di lavoro" per individuare il nome della tua area di lavoro. Selezionalo.

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

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

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 Functions accedendo a Cloud Functions e, nell'elenco delle funzioni, seleziona la funzione che vuoi eliminare e fai clic su ELIMINA.

8. Complimenti

Complimenti Hai creato un servizio di riassunto del testo nell'applicazione Slack.