1. Giới thiệu
Trong lớp học lập trình này, bạn có thể xem hướng dẫn tạo dịch vụ tóm tắt trong Slack Workspace bằng cách tích hợp với Lệnh Slash Slash.
Người dùng gọi Lệnh dấu gạch chéo /summarize rồi nhập văn bản cần tóm tắt. Sau đó, ứng dụng Slack sẽ gọi Cloud Function được liên kết chấp nhận văn bản và gọi PaLM API để tóm tắt. Sau đó, văn bản tóm tắt được trả về Lệnh Slash của Slack và hiển thị dưới dạng một phản hồi trong Ứng dụng Slack.
của Google. Dưới đây là danh sách các dịch vụ của Google Cloud được sử dụng:
- Cloud Functions
- Vertex AI PaLM API
- Cloud Logging
Sản phẩm bạn sẽ tạo ra
Bạn sẽ tạo
- Một hàm đám mây gọi API PaLM để tóm tắt nội dung văn bản từ Slack bằng cách sử dụng Lệnh Dấu gạch chéo
- Ứng dụng Slack gọi chức năng đám mây ở trên để tóm tắt.
2. Yêu cầu
3. Trước khi bắt đầu
- Trong Google Cloud Console, trên trang bộ chọn dự án, hãy chọn hoặc tạo một dự án trên Google Cloud
- Nhớ bật tính năng thanh toán cho dự án Google Cloud của bạn. Tìm hiểu cách kiểm tra xem tính năng thanh toán có được bật trên một dự án hay không
- Đảm bảo rằng bạn đã bật Cloud Functions API và Vertex AI API.
- Kích hoạt Cloud Shell thông qua bảng điều khiển Google Cloud bằng cách làm theo hướng dẫn tại đây
- Nếu dự án của bạn chưa được thiết lập, hãy sử dụng lệnh sau để thiết lập dự án:
gcloud config set project <YOUR_PROJECT_ID>
- Trong Cloud Shell, hãy thiết lập các biến môi trường sau:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1
4. Triển khai chức năng đám mây
Để tạo và triển khai Cloud Functions, hãy làm theo các bước sau:
- Sao chép mã từ kho lưu trữ https://github.com/rominirani/genai-apptemplates-googlecloud bằng cách thực thi lệnh sau trong thiết bị đầu cuối Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
- Lệnh này sẽ sao chép nội dung kho lưu trữ vào thư mục genai-templates-googlecloud.
- Chuyển đến thư mục của dự án mà chúng ta quan tâm bằng cách thực thi lệnh sau trên Cloud Shell Terminal:
cd genai-apptemplates-googlecloud/summarization-slack
- Bạn sẽ thấy cả tệp main.py và requirements.txt trong thư mục summarization-slack bằng cách thực thi lệnh dir hoặc chuyển đến Trình chỉnh sửa Cloud Shell.
- Để triển khai Chức năng đám mây, hãy chạy lệnh gcloud function triển khai:
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
Sau khi bạn triển khai Chức năng đám mây, URL của Chức năng đám mây đã được triển khai sẽ hiển thị trên Thiết bị đầu cuối của Cloud Shell. URL có định dạng như sau:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
Lưu ý rằng URL hiển thị sẽ được yêu cầu để tạo Lệnh Slash Slack.
5. Tạo lệnh Slash Slack
Hãy tạo một lệnh Dấu gạch chéo tuỳ chỉnh trong Slack. Lệnh tuỳ chỉnh /summarize này gọi Hàm đám mây mà chúng ta đã triển khai trong phần trước.
Để tạo Lệnh dấu gạch chéo, hãy thực hiện các bước sau:
- Truy cập api.slack.com/apps.
- Nhấp vào Create New App (Tạo ứng dụng mới).
- Trong cửa sổ Tạo ứng dụng, hãy chọn Từ đầu.
- Nhập tên cho ứng dụng của bạn. Ví dụ:
Summarization Slack Application.Chọn Không gian làm việc của Slack để phát triển ứng dụng. - Nhấp vào Create App (Tạo ứng dụng). Trang Cài đặt sẽ mở ra.
- Trong trang Cài đặt, hãy nhấp vào Thông tin cơ bản > Lệnh dấu gạch chéo. Nhấp vào Create New Command (Tạo lệnh mới).
- Trong biểu mẫu Create New Command (Tạo lệnh mới), hãy cung cấp các giá trị sau:
- Lệnh: dùng lệnh dấu gạch chéo. Ví dụ:
/summarize. - URL yêu cầu: cung cấp URL đầy đủ của Chức năng đám mây mà chúng tôi đã triển khai. Ví dụ:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText - Nhập nội dung mô tả ngắn, gợi ý sử dụng rồi lưu.
- Quay lại phần Cài đặt > Thông tin cơ bản. Nhấp vào Cài đặt ứng dụng của bạn, sau đó nhấp vào Cài đặt vào Workspace. Ứng dụng này được cài đặt vào không gian làm việc của bạn.
Đến đây, bạn sẽ tạo xong Ứng dụng Slack tuỳ chỉnh, hiện đã được cài đặt trong Slack Workspace và có lệnh Slash tuỳ chỉnh (/summarize) để giúp người dùng tóm tắt nội dung mà họ cung cấp trong thông báo.
6. Kiểm thử lệnh Dấu gạch chéo
- Truy cập vào Slack Workspace mà bạn đã cài đặt ứng dụng Slack tóm tắt:
Truy cập vào https://slack.com/intl/en-in/workspace-signin rồi nhập "Tìm không gian làm việc của bạn" để tìm tên không gian làm việc của bạn. Chọn mục đó.
- Trong cuộc trò chuyện, nhập văn bản có tiền tố là lệnh dấu gạch chéo "/summarize". Dưới đây là lệnh gọi mẫu:
- Nhấp vào nút Send (Gửi) để gọi Cloud Function và hiển thị phản hồi tóm tắt như minh hoạ dưới đây:
7. Dọn dẹp
Để tránh bị tính phí vào tài khoản Google Cloud cho các tài nguyên sử dụng trong bài đăng này, hãy làm theo các bước sau:
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên.
- Trong danh sách dự án, hãy chọn dự án mà bạn muốn xoá, sau đó nhấp vào Delete (Xoá).
- Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.
- Nếu bạn muốn giữ lại dự án, hãy bỏ qua các bước ở trên và xoá Hàm đám mây bằng cách chuyển đến Cloud Functions và trong danh sách hàm, hãy chọn hàm bạn muốn xoá rồi nhấp vào XOÁ.
8. Xin chúc mừng
Xin chúc mừng! Bạn đã tạo thành công dịch vụ tóm tắt văn bản trong Ứng dụng Slack.