Otomatisasi Perintah Slack

1. Pengantar

Dalam codelab ini, Anda dapat menemukan petunjuk untuk membuat layanan ringkasan di Ruang Kerja Slack dengan menyediakan integrasi dengan Perintah Slash Slack.

Pengguna memanggil Perintah Garis Miring /summarize dan memasukkan teks yang akan diringkas. Kemudian, aplikasi Slack memanggil Cloud Function terkait yang menerima teks dan memanggil PaLM API untuk meringkas. Teks yang diringkas kemudian dikembalikan ke Perintah Slash Slack dan ditampilkan sebagai respons di Aplikasi Slack.

. Daftar layanan Google Cloud yang digunakan adalah:

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

Yang akan Anda build

Anda akan membuat

• Cloud Function yang memanggil PaLM API untuk meringkas teks yang berasal dari Slack menggunakan Perintah Slash
• Aplikasi Slack yang memanggil Cloud Function di atas untuk meringkas.

2. Persyaratan

• Browser, seperti Chrome atau Firefox
• Project Google Cloud yang mengaktifkan penagihan

3. Sebelum memulai

1. Di Konsol Google Cloud, di halaman pemilih project, pilih atau buat project Google Cloud.
2. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda. Pelajari cara memeriksa apakah penagihan telah diaktifkan pada suatu project.
3. Pastikan Cloud Functions API dan Vertex AI API diaktifkan.
4. Aktifkan Cloud Shell dari konsol Google Cloud dengan mengikuti petunjuk di sini
5. Jika project Anda belum ditetapkan, gunakan perintah berikut untuk menetapkannya:

gcloud config set project <YOUR_PROJECT_ID>

6. Di Cloud Shell, tetapkan variabel lingkungan berikut:

export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1

4. Men-deploy Cloud Function

Untuk membuat dan men-deploy Cloud Functions, ikuti langkah-langkah berikut:

1. Buat clone kode dari repo https://github.com/rominirani/genai-apptemplates-googlecloud dengan menjalankan perintah berikut di terminal Cloud Shell Anda:

git clone https://github.com/rominirani/genai-apptemplates-googlecloud

2. Perintah ini akan meng-clone konten repo ke folder genai-templates-googlecloud.
3. Buka folder project yang kita inginkan dengan menjalankan perintah berikut dari Cloud Shell Terminal:

cd genai-apptemplates-googlecloud/summarization-slack

4. Anda akan melihat file main.py dan requirements.txt di folder summarization-slack dengan menjalankan perintah dir atau membuka Cloud Shell Editor.
5. Untuk men-deploy Cloud Function, jalankan perintah 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

Setelah Anda men-deploy Cloud Function, URL Cloud Function yang telah di-deploy akan ditampilkan di Terminal Cloud Shell. URL dalam format berikut:

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

Catat URL yang ditampilkan, karena akan diperlukan untuk membuat Perintah Slash di Slack.

5. Membuat Perintah Garis Miring Slack

Mari kita buat Perintah Garis Miring kustom di Slack. Perintah kustom /summarize ini memanggil Cloud Function yang telah kita deploy di bagian sebelumnya.

Untuk membuat Perintah Garis Miring, lakukan langkah-langkah berikut:

1. Buka api.slack.com/apps.
2. Klik Create New App.
3. Di jendela Create an app, pilih opsi From scratch.
4. Masukkan nama untuk aplikasi Anda. Misalnya, Summarization Slack Application. Pilih Ruang Kerja Slack untuk pengembangan aplikasi Anda.
5. Klik Create App. Halaman Settings akan terbuka.
6. Di halaman Setelan, klik Informasi Dasar > Perintah Miring. Klik Create New Command.
7. Di formulir Create New Command, berikan nilai berikut:

• Perintah: berikan perintah garis miring. Misalnya, /summarize.
• URL Permintaan: berikan URL lengkap Cloud Function yang kita deploy. Misalnya, https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
• Masukkan Deskripsi Singkat, Petunjuk Penggunaan, lalu simpan.

8. Kembali ke Setelan > Informasi Dasar. Klik Instal aplikasi Anda, lalu klik Instal ke Workspace. Aplikasi diinstal ke ruang kerja Anda.

Dengan demikian, pembuatan Aplikasi Slack kustom yang kini diinstal di Ruang Kerja Slack Anda dan memiliki perintah Slash kustom (/summarize) yang membantu pengguna meringkas teks yang mereka berikan dalam pesan telah selesai.

6. Menguji Perintah Garis Miring

1. Buka Ruang Kerja Slack tempat Anda telah menginstal Aplikasi Slack Ringkasan:

Buka https://slack.com/intl/en-in/workspace-signin dan masukkan "Find your workspaces" untuk menemukan nama ruang kerja Anda. Pilih opsi tersebut.

2. Dalam chat, masukkan teks yang diawali dengan perintah garis miring "/summarize ". Contoh pemanggilan ditampilkan di bawah:

3. Klik tombol Send untuk memanggil Cloud Function dan menampilkan respons ringkasan seperti yang ditunjukkan di bawah:

7. Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam posting ini, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Manage resources.
2. Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
4. Jika Anda ingin mempertahankan project, lewati langkah-langkah di atas dan hapus Cloud Function dengan membuka Cloud Functions, lalu dari daftar fungsi, centang fungsi yang ingin Anda hapus dan klik HAPUS.

8. Selamat

Selamat! Anda telah berhasil membuat layanan ringkasan teks di Aplikasi Slack.