Lớp học lập trình về tiện ích tóm tắt thông tin trên trang tổng quan Looker

1. Trước khi bắt đầu

Trong lớp học lập trình này (1), bạn sẽ thiết lập Tiện ích tóm tắt trang tổng quan Looker trên thiết bị để dùng thử và phát triển tại địa phương. Sau đó, (2) bạn sẽ triển khai tiện ích này cho phiên bản chính thức để những người dùng Looker khác trong phiên bản Looker của bạn có thể sử dụng tiện ích đó. Cuối cùng, (3) bạn có thể thực hiện các bước bổ sung để tinh chỉnh và nâng cao chức năng của tiện ích. Bạn phải hoàn tất tất cả các phần không bắt buộc theo thứ tự tuần tự.

Tổng quan về Tiện ích tóm tắt trên trang tổng quan Looker

Về mặt chức năng, Tiện ích tóm tắt nội dung trên trang tổng quan của Looker gửi dữ liệu trên trang tổng quan Looker của bạn đến mô hình Gemini của Vertex AI. Sau đó, mô hình Gemini sẽ trả về một bản tóm tắt dữ liệu trên trang tổng quan của bạn và danh sách các bước tiếp theo. Tiện ích này hiển thị thông tin tóm tắt và các bước tiếp theo dưới dạng thẻ thông tin trong trang tổng quan, tích hợp vào trải nghiệm trang tổng quan của bạn. Ngoài ra, tiện ích này có thể xuất bản tóm tắt và các bước tiếp theo sang Slack hoặc Google Chat. Tiện ích này sử dụng một ứng dụng giao diện người dùng React kết hợp với dịch vụ phụ trợ websocket để gửi và nhận dữ liệu đến và đi từ mô hình Gemini của Vertex AI.

Điều kiện tiên quyết

  • Có kiến thức cơ bản về cách phát triển Nút, Docker và Terraform
  • Quen thuộc với việc thiết lập dự án Looker LookML

Kiến thức bạn sẽ học được

  • Cách thiết lập và phát triển tiện ích trên thiết bị
  • Cách triển khai tiện ích này cho phiên bản chính thức để người dùng Looker khác trong phiên bản Looker của bạn có thể sử dụng tiện ích này
  • Cách tinh chỉnh hiệu suất của tiện ích và mở rộng chức năng của tiện ích (không bắt buộc).
  • Cách quản lý phần mở rộng đã triển khai trong môi trường phát hành chính thức

Bạn cần có

  • Một thực thể Looker thông qua Giấy phép gốc của Looker, Bản dùng thử Looker Core còn hiệu lực hoặc giấy phép Looker Core còn hiệu lực.
  • Các quyền develop và deploy trên thực thể Looker của bạn.
  • Quyền chỉnh sửa trang tổng quan mà bạn muốn thử với tiện ích.
  • Khoá API Looker từ thực thể Looker của bạn.
  • Một dự án trên Google Cloud đã bật tính năng thanh toán.
  • Cloud Run API, Vertex AI API và Artifact Registry API đã được bật trên dự án.
  • Truy cập vào một môi trường cục bộ đã cài đặt gcloud CLI. Các bước trong lớp học lập trình này giả định môi trường kiểu Linux.

2. Thiết lập phần phụ trợ để phát triển cục bộ

Trong phần này, bạn sẽ thiết lập dịch vụ phụ trợ websocket để thử nghiệm và phát triển cục bộ. Dịch vụ này sẽ có quyền truy cập vào Vertex AI.

  1. Cài đặt Node phiên bản 18 trở lên trong môi trường cục bộ. Làm theo hướng dẫn này để cài đặt Node.
  2. Sao chép kho lưu trữ của tiện ích vào thư mục gốc trên máy rồi chuyển đến thư mục gốc của kho lưu trữ. Theo mục đích của lớp học lập trình này, tất cả mã mẫu sẽ giả định rằng kho lưu trữ được sao chép của bạn nằm trong thư mục gốc trên máy.
cd ~
git clone git@github.com:looker-open-source/dashboard-summarization.git
  1. Chuyển đến thư mục gốc của kho lưu trữ đã sao chép rồi đổi tên tệp .env.example thành .env để thiết lập các biến môi trường trong các phần sau của lớp học lập trình này.
cd ~/dashboard-summarization
mv .env.example .env
  1. Chuyển đến thư mục src của phần phụ trợ ổ cắm web của kho lưu trữ đã sao chép. Thư mục này chứa mã nguồn của máy chủ.
cd ~/dashboard-summarization/websocket-service/src
  1. Cài đặt các phần phụ thuộc của dịch vụ bằng Trạng thái đối sánh của Google (Gradle).
npm install
  1. Đổi tên tệp looker-example.ini thành looker.ini.
mv looker-example.ini looker.ini
  1. Bên trong bản cập nhật tệp Looker.ini:
  2. client_id và client_secret cùng với các tham số từ khoá API Looker của bạn.
  3. base_url có URL của thực thể Looker có định dạng: https://<YOUR_LOOKER_URL_MINUS_PROTOCOL>:19999
  4. Văn bản nằm giữa các dấu ngoặc (tiêu đề của mục) với máy chủ lưu trữ URL của phiên bản Looker.

Ví dụ: nếu mã ứng dụng khách của bạn là ABC123, mật khẩu ứng dụng khách của bạn là XYZ789 và URL phiên bản Looker của bạn là https://mycompany.cloud.looker.com, thì tệp looker.ini của bạn sẽ có dạng như sau:

[mycompany]
base_url=https://mycompany.cloud.looker.com:19999
client_id=ABC123
client_secret=XYZ789
verify_ssl=true
  1. Xác định mã dự án Google Cloud và đặt mã đó trên biến môi trường PROJECT. Thay thế YOUR_PROJECT_ID bằng mã dự án của bạn.
export PROJECT="YOUR_PROJECT_ID"
  1. Vertex AI cung cấp mô hình Gemini ở nhiều khu vực được liệt kê tại đây. Xác định khu vực mà phần phụ trợ cục bộ của bạn sẽ gửi và nhận dữ liệu từ mô hình Gemini của Vertex AI. Đặt khu vực trên biến môi trường REGION. Thay thế YOUR_VERTEX_REGION bằng khu vực của bạn, chẳng hạn như us-central1.
export REGION="YOUR_VERTEX_REGION"
  1. Bây giờ, hãy khởi động dịch vụ địa phương của bạn.
npm start
  1. Dịch vụ phụ trợ websocket cục bộ sẽ chạy trên http://localhost:5000.

Bây giờ, bạn đã thiết lập xong dịch vụ phụ trợ websocket trong môi trường cục bộ của mình!!

Dịch vụ này đóng vai trò là giao diện giữa tiện ích giao diện người dùng và mô hình Gemini của Vertex AI. Dịch vụ này sẽ lấy dữ liệu trang tổng quan và LookML từ tiện ích giao diện người dùng của bạn bằng dữ liệu được truy vấn từ Looker và nhắc mô hình Gemini của Vertex AI. Sau đó, dịch vụ sẽ truyền trực tuyến phản hồi của Gemini đến tiện ích giao diện người dùng để hiển thị trong trang tổng quan của bạn.

Bạn cũng có thể thay đổi mã nguồn của dịch vụ phụ trợ. Trước tiên, bạn cần dừng quy trình dịch vụ, thay đổi mã rồi chạy lại npm start.

3. Thiết lập giao diện người dùng để phát triển cục bộ

Bạn sẽ thiết lập tiện ích giao diện người dùng để thử nghiệm và phát triển cục bộ trong phần này.

  1. Trong cùng một môi trường cục bộ ở các bước trước, hãy chuyển đến thư mục gốc của kho lưu trữ đã sao chép rồi cài đặt các phần phụ thuộc của máy chủ giao diện người dùng cho giao diện người dùng của bạn.
cd ~/dashboard-summarization
npm install
  1. Khởi động máy chủ phát triển giao diện người dùng cục bộ
npm run develop
  1. Máy chủ giao diện người dùng cục bộ của bạn hiện đang phân phát javascript của tiện ích tại http://localhost:8080/bundle.js.
  2. Mở một trình duyệt web rồi đăng nhập vào phiên bản Looker của bạn.
  3. Hãy làm theo hướng dẫn này để thiết lập một dự án LookML trống. Đặt tên cho mục tóm tắt trên trang tổng quan của dự án. Bây giờ, bạn sẽ tự động mở dự án LookML trống trong IDE Looker trong thẻ trình duyệt hiện tại.
  4. Tạo một tệp kê khai dự án trong gốc của dự án LookML. Tệp sẽ được gọi là manifest.lkml. Nếu bạn không biết cách, hãy làm theo hướng dẫn này về cách thêm tệp vào dự án LookML.
  5. Thay thế nội dung của tệp manifest.lkml mới bằng nội dung của manifest.lkml trong thư mục gốc của kho lưu trữ đã đóng. Chọn nút "Save Changes" (Lưu thay đổi) ở góc trên cùng bên phải để lưu các thay đổi vào tệp.
  6. Trong một thẻ trình duyệt riêng, hãy chuyển đến danh sách các kết nối cơ sở dữ liệu trong phiên bản Looker của bạn. Hãy làm theo hướng dẫn này nếu bạn không biết cách thực hiện.
  7. Chọn Tên của một kết nối cơ sở dữ liệu Looker. Bạn có thể chọn kết nối bất kỳ. Nếu bạn không có quyền xem các kết nối cơ sở dữ liệu, hãy liên hệ với quản trị viên Looker và hỏi tên của một kết nối cơ sở dữ liệu Looker.
  8. Quay lại thẻ trình duyệt khi dự án LookML của bạn đang mở trong IDE Looker. Tạo một tệp mô hình trong dự án LookML rồi đặt tên cho tệp tóm tắt trên trang tổng quan.
  9. Thay thế nội dung của tệp console-summarization.model.lkml bằng mã mẫu bên dưới. Hãy nhớ thay thế chuỗi trong dấu ngoặc kép bằng tên kết nối cơ sở dữ liệu mà bạn đã chọn ở bước 9. Lưu các thay đổi đối với tệp.
connection: "<YOUR_CONNECTION_NAME>"
  1. Thiết lập kho lưu trữ để lưu dự án của bạn. Chọn nút "Configure Git" (Định cấu hình Git) ở trên cùng bên phải. Chọn "Thiết lập kho lưu trữ trống". Chọn "Tạo kho lưu trữ".
  2. Giờ đây, bạn đã có một kho lưu trữ cơ bản để lưu trữ các tệp dự án LookML. Quay lại dự án trong Looker IDE bằng cách chọn "Quay lại dự án" hoặc quay lại theo cách thủ công.
  3. Chọn nút "Xác thực LookML" ở góc trên cùng bên phải. Nút này sẽ thay đổi thành "Xác nhận các thay đổi và đẩy".
  4. Chọn nút ""Xác nhận các thay đổi và đẩy". Thêm bất kỳ thông báo nào bạn muốn rồi chọn "Xác nhận".
  5. Chọn "Triển khai lên môi trường sản xuất" ở góc trên cùng bên phải của Looker IDE. Giờ đây, bạn đã thêm phần mở rộng này vào phiên bản Looker của mình!
  6. Chuyển đến trang tổng quan Looker mà bạn muốn thêm tiện ích.
  7. Làm theo hướng dẫn để thêm thẻ thông tin tiện ích vào trang tổng quan. Thêm tiện ích mới vào trang tổng quan dưới dạng thẻ thông tin.
  8. Đảm bảo dịch vụ phụ trợ websocket cục bộ mà bạn thiết lập trước đó đang chạy.

Xin chúc mừng! Giờ đây, bạn có thể dùng thử Tiện ích tóm tắt nội dung trên trang tổng quan Looker trong trang tổng quan của mình. Tiện ích của bạn sẽ gửi siêu dữ liệu của trang tổng quan đến dịch vụ phụ trợ websocket tại địa phương và sẽ hiển thị kết quả của Gemini từ dịch vụ phụ trợ ngay trong ô tiện ích của trang tổng quan.

Khi máy chủ giao diện người dùng cục bộ đang chạy, bạn có thể thực hiện các thay đổi đối với mã nguồn JavaScript của tiện ích và máy chủ sẽ tự động tạo và phân phát các thay đổi đó. Bạn sẽ cần tải lại tiện ích hoặc trang tổng quan để xem các thay đổi.

4. Triển khai phần phụ trợ vào giai đoạn sản xuất

Trong phần này, bạn sẽ thiết lập dịch vụ phụ trợ websocket để phân phát mọi phiên bản của tiện ích tóm tắt trang tổng quan trên mọi trang tổng quan trong phiên bản Looker của bạn. Điều này sẽ cho phép người dùng Looker khác dùng thử tiện ích này trong trang tổng quan của riêng họ mà không cần thiết lập dịch vụ phụ trợ của riêng họ. Các bước này giả định rằng bạn đã triển khai thành công phần phụ trợ để phát triển cục bộ trong cùng một môi trường cục bộ trước đó.

  1. Hãy làm theo hướng dẫn này để thiết lập Thông tin xác thực mặc định của ứng dụng trong môi trường cục bộ bằng mã dự án cho các bước tiếp theo.
  2. Tạo kho lưu trữ Artifact Registry cho hình ảnh Docker của dịch vụ phụ trợ. Thay thế YOUR_REGION bằng khu vực nơi bạn muốn kho lưu trữ của mình nằm trong đó.
gcloud artifacts repositories create dashboard-summarization-repo \
    --repository-format=docker \
    --location=YOUR_REGION \
  1. Chuyển đến thư mục src của phần phụ trợ ổ cắm web của kho lưu trữ đã sao chép.
cd ~/dashboard-summarization/websocket-service/src
  1. Chỉnh sửa tệp cloudbuild.yaml rồi thay thế mọi bản sao của YOUR_REGION và YOUR_PROJECT_ID bằng mã khu vực và mã dự án của bạn. Lưu các thay đổi đối với tệp.
  2. Gửi một bản dựng bằng Cloud Build. Bản dựng này sẽ tạo hình ảnh Docker của dịch vụ phụ trợ và đẩy hình ảnh đó vào kho lưu trữ Artifact Registry mà bạn vừa tạo. Thay thế YOUR_REGION bằng khu vực mà bạn muốn sử dụng dịch vụ Cloud Build.
gcloud builds submit --region=YOUR_REGION --config cloudbuild.yaml
  1. Hãy nhớ rằng URL hình ảnh Docker mới tạo của bạn nằm ở YOUR_REGION-docker.pkg.dev/YOUR_PROJECT_ID/dashboard-summarization-repo/websocketserviceimage:latest. Thay thế YOUR_PROJECT_ID bằng mã dự án của bạn. Thay thế YOUR_REGION bằng khu vực ở bước 2 mà bạn đã dùng để tạo kho lưu trữ Artifact Registry.
  2. Chuyển đến thư mục websocket-service/terraform trong kho lưu trữ đã sao chép.
cd ~/dashboard-summarization/websocket-service/terraform
  1. Xác định vị trí của Google Cloud Run mà bạn muốn chạy dịch vụ phụ trợ websocket. Chọn trong số những vị trí sau.
  2. Chỉnh sửa tệp variables.tf và thay thế YOUR_PROJECT_ID và YOUR_DOCKER_IMAGE_URL bằng các giá trị thích hợp. Kiểm tra bước 6 để biết URL hình ảnh docker. Thay thế YOUR_REGION bằng khu vực mà bạn đã chọn ở bước 8 trước đó. Lưu các thay đổi của bạn vào tệp.
  3. Triển khai các tài nguyên mà dịch vụ phụ trợ của bạn sẽ sử dụng bằng terraform.
terraform init
terraform plan
terraform apply
  1. Lưu Điểm cuối URL của Cloud Run đã triển khai cho phần tiếp theo.

Xin chúc mừng! Bạn đã triển khai dịch vụ phụ trợ websocket và dịch vụ này hiện đang chạy trên Google Cloud Run. Giờ đây, mọi phiên bản của tiện ích Tóm tắt trên trang tổng quan Looker đều có thể giao tiếp với dịch vụ phụ trợ của bạn. Bạn nên luôn có ít nhất một phiên bản của dịch vụ phụ trợ websocket đang chạy trên Cloud Run. Tính liên tục của dịch vụ phụ trợ giúp duy trì tính toàn vẹn của luồng dữ liệu giữa dịch vụ phụ trợ websocket và giao diện người dùng của tiện ích, đồng thời giúp duy trì phiên của mỗi người dùng khi họ sử dụng tiện ích.

5. Triển khai giao diện người dùng vào giai đoạn sản xuất

Trong phần cuối cùng này, bạn sẽ thực hiện các bước cuối cùng để triển khai giao diện người dùng của tiện ích cho tất cả người dùng Looker trong phiên bản Looker của bạn.

  1. Chuyển đến thư mục gốc của kho lưu trữ được nhân bản.
cd ~/dashboard-summarization
  1. Chỉnh sửa tệp .Tệp env. Thay thế YOUR_CLOUD_RUN_URL bằng Điểm cuối URL Cloud Run trong phần trước. Lưu các thay đổi đối với tệp. Thao tác này sẽ trỏ giao diện người dùng của tiện ích phát hành công khai đến dịch vụ phụ trợ websocket đang chạy trên Cloud Run.
  2. Tạo javascript của tiện ích. Thư mục dist sẽ được tạo tự động với tệp bundle.js và các tệp khác trong đó.
npm run build
  1. Mở một trình duyệt web rồi đăng nhập vào phiên bản Looker của bạn. Mở phần điều hướng bên trái rồi bật nút "Chế độ phát triển" ở dưới cùng.
  2. Khi bảng điều hướng bên trái đang mở, hãy chọn "Develop" (Phát triển), sau đó di chuyển xuống và chọn "dashboard-summarization" (tóm tắt trang tổng quan), dự án LookML của tiện ích. Bây giờ, bạn sẽ thấy mình đang ở trong IDE Looker cho dự án LookML.
  3. Kéo và thả tất cả tệp trong thư mục dist đã tạo trước đó vào thư mục gốc của dự án trong "Trình duyệt tệp". Hãy làm theo hướng dẫn này nếu bạn cần được trợ giúp thêm.
  4. Mở tệp manifest.lkml trong IDE Looker. Bên trong tệp này, hãy thay thế dòng
url: "http://localhost:8080/bundle.js"

với

file: "bundle.js"

Thay thế YOUR_CLOUD_RUN_URL bằng Điểm cuối URL trên Cloud Run ở cuối phần trước. Lưu các thay đổi đối với tệp.

  1. Chọn nút "Xác thực LookML" ở góc trên cùng bên phải. Nút này sẽ thay đổi thành "Xác nhận các thay đổi và đẩy".
  2. Chọn nút ""Xác nhận các thay đổi và đẩy". Thêm bất kỳ thông báo nào bạn muốn rồi chọn "Xác nhận".
  3. Chọn "Triển khai lên môi trường sản xuất" ở góc trên cùng bên phải của Looker IDE.

Xin chúc mừng! Giờ đây, bạn đã cho phép tất cả người dùng Looker trong phiên bản Looker của mình thêm Tiện ích tóm tắt trang tổng quan Looker vào trang tổng quan của họ. Khi người dùng Looker khác sử dụng tiện ích này, tất cả các thực thể của tiện ích sẽ thực hiện lệnh gọi đến dịch vụ phụ trợ websocket đã triển khai của bạn chạy trên Google Cloud Run.

Xin lưu ý rằng nếu thực hiện bất kỳ thay đổi nào đối với mã nguồn, bạn phải:

  1. Tạo lại javascript của tiện ích
  2. Thay thế các tệp đã tạo mà bạn đã thêm vào dự án LookML bằng các tệp mới tạo trong thư mục dist.
  3. Xác thực, cam kết và triển khai các thay đổi của dự án LookML trong giai đoạn phát hành chính thức

Hãy dùng thử Tiện ích tóm tắt nội dung trên trang tổng quan của Looker! Bạn nên đóng góp cho tiện ích này để giúp tiện ích này phục vụ tốt hơn nhu cầu của cộng đồng Looker. Vui lòng tạo yêu cầu kéo trên kho lưu trữ.

Hãy xem các phần không bắt buộc sau đây để bật tính năng xuất dữ liệu của Slack/Google Chat, tinh chỉnh nội dung tóm tắt của Gemini và các bước tiếp theo, cũng như thiết lập tính năng ghi nhật ký của Gemini.

6. [Không bắt buộc] Thiết lập tính năng xuất

Giờ đây, khi bạn và người dùng Looker đã dùng thử tiện ích Tóm tắt trang tổng quan Looker, bạn có thể chia sẻ thông tin chi tiết về tiện ích này với nhiều đối tượng hơn. Hãy làm theo phần này để cho phép tiện ích của bạn gửi bản tóm tắt và các bước tiếp theo đến Google Chat hoặc Slack. Bạn cần làm quen với cách thiết lập OAuth để tiếp tục với phần này của lớp học lập trình.

Bật tính năng xuất dữ liệu của Google Chat

  1. Bật API Chat trong dự án Google Cloud.
  2. Làm theo bước 1 trong hướng dẫn thiết lập OAuth của Google Workspace. Đối với phạm vi, bạn phải thêm spaces.messages.create.
  3. Làm theo bước 2 trong hướng dẫn thiết lập OAuth của Google Workspace. Thêm URL của thực thể trình tìm kiếm dưới dạng một URI trong phần "Nguồn gốc JavaScript được cho phép", ví dụ: https://mycompany.cloud.looker.com. Ghi lại Mã ứng dụng khách đã tạo.
  4. Xác định mã nhận dạng của phòng Google Chat nơi bạn muốn xuất nội dung tóm tắt. Nếu bạn không chắc chắn về cách thực hiện, hãy làm theo hướng dẫn này.
  5. Chỉnh sửa .Tệp env. Thay thế YOUR_GOOGLE_CLIENT_ID bằng Mã ứng dụng khách. Thay thế YOUR_GOOGLE_SPACE_ID bằng mã nhận dạng phòng Google Chat. Lưu các thay đổi đối với tệp. Thao tác này sẽ định cấu hình giao diện người dùng của tiện ích để có thể gửi thông tin chi tiết đến không gian Google Chat mà bạn muốn.
  6. Nếu bạn đang chạy giao diện người dùng của tiện ích trên máy, hãy tạo lại tiện ích. Nếu không, nếu bạn đang triển khai giao diện người dùng của tiện ích, hãy triển khai lại giao diện người dùng của tiện ích.

Bật tính năng xuất dữ liệu sang Slack

  1. Làm theo bước 1 và 2 trong các tài liệu chính thức dành cho nhà phát triển Slack để thiết lập Ứng dụng OAuth. Đối với phạm vi, bạn phải thêm chat:write và channels:read. Ghi lại mã ứng dụng khách và mật khẩu ứng dụng khách đã tạo.
  2. Xác định mã nhận dạng của kênh Slack mà bạn muốn xuất bản tóm tắt.
  3. Chỉnh sửa tệp .Tệp env. Thay thế YOUR_SLACK_CLIENT_ID bằng Mã ứng dụng khách. Thay thế YOUR_SLACK_CLIENT_SECRET bằng Mật khẩu ứng dụng khách. Thay thế YOUR_SLACK_CHANNEL_ID bằng mã nhận dạng kênh. Lưu các thay đổi đối với tệp. Thao tác này sẽ định cấu hình giao diện người dùng của tiện ích để có thể gửi thông tin chi tiết đến kênh Slack mà bạn muốn.
  4. Nếu bạn đang chạy giao diện người dùng của tiện ích trên máy, hãy tạo lại tiện ích. Nếu không, nếu bạn đang triển khai giao diện người dùng của tiện ích, hãy triển khai lại giao diện người dùng của tiện ích.

Giờ đây, tiện ích của bạn có thể xuất trực tiếp các bản tóm tắt sang Slack hoặc Google Chat. Xin lưu ý rằng tiện ích này chỉ có thể gửi nội dung tóm tắt đến một không gian trò chuyện cụ thể trên Google được mã hoá cứng hoặc kênh Slack. Bạn có thể thêm các phạm vi Oauth khác và sửa đổi mã để tìm nạp và hiển thị danh sách không gian và kênh cần gửi bản tóm tắt.

7. [Không bắt buộc] Tinh chỉnh phần tóm tắt và các bước tiếp theo

Tiện ích này sẽ nhắc mô hình Gemini bằng tất cả siêu dữ liệu và dữ liệu truy vấn của trang tổng quan. Bạn có thể cải thiện độ chính xác, chi tiết và chuyên sâu của phần tóm tắt cũng như các bước quy định bằng cách thêm càng nhiều siêu dữ liệu và ngữ cảnh vào trang tổng quan càng tốt. Hãy thử các bước sau cho từng trang tổng quan mà tiện ích của bạn là một phần:

  • Làm theo hướng dẫn để thêm thông tin trên trang tổng quan vào trang tổng quan. Việc này sẽ giúp cung cấp thông tin cho LLM về bối cảnh chung của trang tổng quan.
  • Làm theo hướng dẫn để thêm ghi chú vào ô của từng trang tổng quan. Việc này giúp cung cấp cho LLM (mô hình ngôn ngữ lớn) về ngữ cảnh của từng truy vấn riêng lẻ trên trang tổng quan. Các ghi chú nhỏ theo bối cảnh sẽ ảnh hưởng đến các bản tóm tắt được tạo.

Bạn càng thêm nhiều thông tin vào trang tổng quan thì phần tóm tắt và các bước tiếp theo của tiện ích càng hiệu quả. Bạn có thể sửa đổi đoạn mã này để thêm siêu dữ liệu bổ sung của trang tổng quan vào câu lệnh cho mô hình Gemini.

8. [Không bắt buộc] Thiết lập tính năng ghi nhật ký cho mô hình Gemini

Mỗi khi người dùng yêu cầu tiện ích tạo bản tóm tắt cho một trang tổng quan, tiện ích đó sẽ thực hiện một lệnh gọi đến Vertex AI cho mỗi truy vấn trong trang tổng quan cùng với một lệnh gọi cuối cùng để định dạng tất cả các bản tóm tắt. Hãy làm theo phần này để ghi lại các lệnh gọi của Vertex AI mà tiện ích của bạn thực hiện, từ đó bạn có thể ước tính và theo dõi chi phí cũng như lưu lượng truy cập của Vertex AI. Bạn chỉ nên làm theo những hướng dẫn này nếu đã triển khai dịch vụ phụ trợ websocket.

  1. Xác định vị trí Cloud Run của dịch vụ phụ trợ websocket đã triển khai.
  2. Làm theo hướng dẫn này để thiết lập bồn lưu trữ nhật ký sẽ định tuyến nhật ký đến Big Query. Đích của bồn lưu trữ phải là BigQuery. Đặt bộ lọc đưa vào bằng mã mẫu sau đây, trong đó YOUR_CLOUD_RUN_LOCATION được thay thế bằng vị trí Cloud Run của bước trước.
resource.type = "cloud_run_revision"
resource.labels.service_name = "websocket-service"
resource.labels.location = "YOUR_CLOUD_RUN_LOCATION"
 severity>=DEFAULT
jsonPayload.component="dashboard-summarization-logs"

9. Xin chúc mừng!

Bạn đã thiết lập tiện ích Tóm tắt trang tổng quan Looker trên máy để thử nghiệm. Bạn cũng đã triển khai tiện ích này cho Google Cloud để người dùng khác cũng có thể dùng thử! Giờ đây, bạn và những người dùng khác có thể xem các bản tóm tắt và các bước tiếp theo do Gemini hỗ trợ ngay trong trang tổng quan của mình.

10. Bước tiếp theo