1. Pengantar
Dalam codelab ini, Anda dapat menemukan petunjuk untuk membuat layanan ringkasan di Ruang Kerja Slack dengan menyediakan integrasi dengan Perintah Slash di 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 ringkasan. Teks yang diringkas kemudian dikembalikan ke Slack Slash Command dan ditampilkan sebagai respons dalam Aplikasi Slack.
kami. Daftar layanan Google Cloud yang digunakan adalah:
- Cloud Functions
- Vertex AI PaLM API
- Cloud Logging
Yang akan Anda build
Anda akan membuat
- Cloud Function yang memanggil PaLM API untuk peringkasan teks pada teks yang berasal dari Slack menggunakan Perintah Garis miring
- Aplikasi Slack yang memanggil Cloud Function di atas untuk fitur ringkasan.
2. Persyaratan
3. Sebelum memulai
- Di Konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud
- Pastikan penagihan diaktifkan untuk project Google Cloud Anda. Pelajari cara memeriksa apakah penagihan diaktifkan pada sebuah project
- Pastikan Cloud Functions API dan Vertex AI API diaktifkan.
- Aktifkan Cloud Shell dari Konsol Google Cloud dengan mengikuti petunjuk di sini
- Jika project Anda belum ditetapkan, gunakan perintah berikut untuk menetapkannya:
gcloud config set project <YOUR_PROJECT_ID>
- 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:
- 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
- Perintah ini akan meng-clone konten repo ke dalam folder genai-templates-googlecloud.
- Buka folder project yang penting bagi kita dengan menjalankan perintah berikut dari Terminal Cloud Shell:
cd genai-apptemplates-googlecloud/summarization-slack
- Anda akan melihat file main.py dan requirements.txt di folder summarization-slack dengan menjalankan perintah dir atau dengan membuka Cloud Shell Editor.
- 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 menggunakan format berikut:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
Perhatikan URL yang ditampilkan. URL tersebut akan diperlukan untuk membuat Perintah Garis miring Slack.
5. Membuat Perintah Garis miring di Slack
Mari kita buat Perintah Garis miring khusus 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:
- Buka api.slack.com/apps.
- Klik Create New App.
- Di jendela Create an app, pilih opsi From scratch.
- Masukkan nama untuk aplikasi Anda. Misalnya,
Summarization Slack Application.
Pilih Workspace Slack untuk pengembangan aplikasi Anda. - Klik Create App. Halaman Setelan akan terbuka.
- Di halaman Setelan, klik Informasi Dasar > Perintah Garis miring. Klik Create New Command.
- Dalam formulir Create New Command, berikan nilai berikut:
- Command: berikan perintah garis miring. Misalnya,
/summarize.
- URL Permintaan: berikan URL lengkap Cloud Function yang telah di-deploy. Misalnya,
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
- Masukkan Deskripsi Singkat, Petunjuk Penggunaan, lalu simpan.
- Kembali ke Setelan > Informasi Dasar. Klik Instal aplikasi Anda, lalu klik Instal ke Workspace. Aplikasi diinstal ke ruang kerja Anda.
Langkah ini menyelesaikan pembuatan Aplikasi Slack kustom yang sekarang diinstal di Slack Workspace dan memiliki perintah Slash kustom (/summarize
) yang membantu pengguna meringkas teks yang mereka berikan dalam pesan.
6. Menguji Perintah Garis miring
- Buka Workspace Slack tempat Anda menginstal Aplikasi Summarization Slack:
Buka https://slack.com/intl/en-in/workspace-signin dan masukkan "Temukan ruang kerja Anda" untuk menemukan nama ruang kerja Anda. Pilih opsi itu.
- Di chat, masukkan teks yang diawali dengan perintah garis miring "/summarize ". Contoh pemanggilan ditampilkan di bawah ini:
- Klik tombol Send, untuk memanggil Cloud Function dan menampilkan respons ringkasan seperti yang ditunjukkan di bawah ini:
7. Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam posting ini, ikuti langkah-langkah berikut:
- Di konsol Google Cloud, buka halaman Manage resource.
- Dalam daftar project, pilih project yang ingin dihapus, lalu klik Delete.
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
- Jika Anda ingin menyimpan project, lewati langkah-langkah di atas dan hapus Cloud Function dengan membuka Cloud Functions. Dari daftar fungsi, centang fungsi yang ingin dihapus, lalu klik DELETE.
8. Selamat
Selamat! Anda telah berhasil membuat layanan ringkasan teks di Aplikasi Slack.