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 của Looker cục bộ để dùng thử và phát triển cục bộ. Sau đó, (2) bạn sẽ triển khai tiện ích này cho bản phát hành công khai để những người dùng Looker khác trong thực thể Looker của bạn có thể sử dụng. Cuối cùng, (3) bạn có thể làm theo 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 trang tổng quan của Looker

Về chức năng, Tiện ích tóm tắt trang tổng quan Looker sẽ gửi dữ liệu của trang tổng quan Looker đến mô hình Gemini của Vertex AI. Sau đó, mô hình Gemini sẽ trả về bản tóm tắt dữ liệu trên trang tổng quan của bạn và hướng dẫn các bước tiếp theo. Tiện ích này sẽ hiển thị thông tin tóm tắt và các bước tiếp theo dưới dạng một ô 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 nội dung 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

  • Hiểu biết cơ bản về việc phát triển Node, Docker và Terraform
  • Đã làm quen với việc thiết lập dự án LookML của Looker

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

  • Cách thiết lập và phát triển tiện ích cục bộ
  • Cách triển khai tiện ích cho phiên bản phát hành công khai để những người dùng Looker khác trong thực thể 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ý tiện ích đã triển khai trong bản phát hành công khai

Bạn cần có

  • Một thực thể Looker, thông qua Giấy phép Looker gốc, thời gian dùng thử Looker Core đang hoạt động hoặc giấy phép Looker Core đang hoạt động.
  • Quyền develop và deploy trên phiên bản Looker của bạn.
  • Quyền chỉnh sửa trang tổng quan mà bạn muốn dùng 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.
  • Có quyền truy cập vào 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 giả định một môi trường theo 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 để dùng thử 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 cục bộ rồi chuyển đến thư mục gốc của kho lưu trữ. Trong lớp học lập trình này, tất cả các mẫu mã sẽ giả định rằng kho lưu trữ bạn sao chép nằm trong thư mục chính trên thiết bị của bạn.
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 và đổi tên tệp .env.example thành .env để bạn có thể đặt 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 trong kho lưu trữ được sao chép. Thư mục này chứa mã nguồn cho 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 NPM.
npm install
  1. Đổi tên tệp looker-example.ini thành looker.ini.
mv looker-example.ini looker.ini
  1. Trong tệp looker.ini, hãy cập nhật:
  2. client_id và client_secret bằng các khoá trong khoá Looker API của bạn.
  3. base_url có URL của thực thể Looker ở định dạng: https://<YOUR_LOOKER_URL_MINUS_PROTOCOL>:19999
  4. Văn bản giữa dấu ngoặc (tiêu đề phần) có máy chủ của URL thực thể Looker.

Ví dụ: nếu mã ứng dụng khách của bạn là ABC123, khoá bí mật của ứng dụng khách là XYZ789 và URL của thực thể Looker 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 trên đám mây của Google Cloud rồi đặt mã đó trên biến môi trường PROJECT. Thay 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 vùng 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 bắt đầu dịch vụ tại địa phương.
npm start
  1. Dịch vụ phụ trợ websocket cục bộ của bạn sẽ chạy trên http://localhost:5000.

Giờ thì 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 bảng điều khiển và LookML từ tiện ích giao diện người dùng của bạn, cùng dữ liệu được truy vấn từ Looker và ra lệnh cho mô hình Gemini của Vertex AI. Sau đó, dịch vụ này sẽ truyền trực tuyến phản hồi của Gemini đến tiện ích phần 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ụ, thực hiện các thay đổi về mã, sau đó chạy lại npm start.

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

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

  1. Trong cùng một môi trường cục bộ như 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 và 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.
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 dự án tóm tắt trang tổng quan. Giờ đây, dự án LookML trống sẽ tự động mở trong Looker IDE ở thẻ trình duyệt hiện tại.
  4. Tạo một tệp kê khai dự án trong thư mục gốc của dự án LookML. Tệp này sẽ có tên 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 một dự án LookML.
  5. Thay thế nội dung của tệp manifest.lkml mới bằng nội dung của tệp manifest.lkml trong thư mục gốc của kho lưu trữ khép kín. Chọn nút "Lưu thay đổi" ở góc trên 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 mối 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 mối kết nối cơ sở dữ liệu Looker. Bạn có thể chọn bất kỳ cổng kết nối nào. Nếu bạn không có quyền xem các mối kết nối cơ sở dữ liệu, hãy liên hệ với quản trị viên Looker và yêu cầu họ cung cấp tên của một mối kết nối cơ sở dữ liệu Looker.
  8. Quay lại thẻ trình duyệt có dự án LookML được mở trong Looker IDE. Tạo một tệp mô hình trong dự án LookML và đặt tên cho tệp đó là dashboard-summarization.
  9. Thay thế nội dung của tệp dashboard-summarization.model.lkml bằng đoạn mã mẫu bên dưới. 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 vào tệp.
connection: "<YOUR_CONNECTION_NAME>"
  1. Thiết lập một 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 "Set up a bare repository instead." (Thay vào đó, hãy thiết lập một 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. Chuyển về dự án trong Looker IDE bằng cách chọn "Quay lại dự án" hoặc chuyển về 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ẽ đổi thành "Commit changes and push" (Xác nhận thay đổi và đẩy).
  4. Chọn nút "Commit changes and push" (Xác nhận thay đổi và đẩy). Thêm tin nhắn bạn muốn rồi chọn "Commit" (Xác nhận).
  5. Chọn "Deploy to Production" (Triển khai cho phiên bản phát hành công khai) ở góc trên cùng bên phải của Looker IDE. Giờ đây, bạn đã thêm tiện ích vào phiên bản Looker của mình!
  6. Chuyển đến một 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 một ô 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 một ô.
  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 trang tổng quan của Looker trong trang tổng quan của mình. Tiện ích sẽ gửi siêu dữ liệu của trang tổng quan đến dịch vụ phụ trợ websocket cục bộ và hiển thị đầu ra của Gemini từ dịch vụ phụ trợ ngay trong ô tiện ích trang tổng quan.

Trong khi máy chủ giao diện người dùng cục bộ đang chạy, bạn có thể thay đổ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 trang tiện ích hoặc trang tổng quan để xem các thay đổi.

4. Triển khai phần phụ trợ cho bản phát hành công khai

Trong phần này, bạn sẽ thiết lập dịch vụ phụ trợ websocket để phân phát mọi thực thể của tiện ích tóm tắt bảng điều khiển trên mọi bảng điều khiển trong thực thể Looker của mình. Nhờ đó, những người dùng Looker khác có thể 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 một Thông tin đăng nhập mặc định của ứng dụng trong môi trường cục bộ bằng mã dự án của bạn cho các bước tiếp theo.
  2. Tạo một 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 mà bạn muốn kho lưu trữ của mình nằm ở đó.
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 trong kho lưu trữ bạn đã sao chép.
cd ~/dashboard-summarization/websocket-service/src
  1. Chỉnh sửa tệp cloudbuild.yaml và thay thế tất cả các trường hợp 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 vào tệp.
  2. Gửi 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 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ữ bạn đã 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 một trong những vị trí này.
  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 bạn đã chọn ở bước 8 trước đó. Lưu các thay đổi 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 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 trang tổng quan của 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 thực thể dịch vụ phụ trợ websocket đang chạy trên Cloud Run. Tính năng duy trì của dịch vụ phụ trợ sẽ duy trì tính toàn vẹn của việc truyền phát 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 từng người dùng khi họ sử dụng tiện ích của bạn.

5. Triển khai giao diện người dùng cho bản phát hành công khai

Đối với 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ữ bạn đã sao chép.
cd ~/dashboard-summarization
  1. Chỉnh sửa .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 chính đế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ẽ tự động được tạo cù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ở trình đơn điều hướng bên trái rồi bật nút "Chế độ nhà 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ẽ ở trong Looker IDE cho dự án LookML.
  3. Kéo và thả tất cả các tệp trong thư mục dist đã tạo trước đó vào thư mục gốc của dự án trong "File Browser" (Trình duyệt tệp). Hãy làm theo hướng dẫn này nếu bạn cần thêm trợ giúp.
  4. Mở tệp manifest.lkml trong Looker IDE. 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 Cloud Run ở cuối phần cuối cùng. Lưu các thay đổi vào 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ẽ đổi thành "Commit changes and push" (Xác nhận thay đổi và đẩy).
  2. Chọn nút "Commit changes and push" (Xác nhận thay đổi và đẩy). Thêm tin nhắn bạn muốn rồi chọn "Commit" (Xác nhận).
  3. Chọn "Deploy to Production" (Triển khai cho phiên bản phát hành công khai) ở 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 thực thể Looker của bạn thêm Tiện ích tóm tắt trang tổng quan của Looker vào trang tổng quan của họ. Khi những người dùng Looker khác sử dụng tiện ích này, tất cả các phiên bản của tiện ích sẽ gọi đến dịch vụ phụ trợ websocket mà bạn triển khai đang 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 về dự án LookML cho bản phát hành công khai

Hãy dùng thử Tiện ích tóm tắt 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 phục vụ tốt hơn nhu cầu của cộng đồng Looker. Vui lòng tạo một 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 trên Slack/Google Chat, tinh chỉnh bản tóm tắt và các bước tiếp theo của Gemini, 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 chức năng xuất

Giờ đây, bạn và người dùng Looker đã dùng thử tiện ích Tóm tắt trang tổng quan của Looker. Hãy chia sẻ thông tin chi tiết của tiện ích này với nhiều người dùng hơn. Hãy làm theo phần này để cho phép tiện ích gửi nội dung tóm tắt và các bước tiếp theo đến Google Chat hoặc Slack. Bạn nên làm quen với 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 trên Google Chat

  1. Bật Chat API trong dự án Google Cloud của bạn.
  2. Làm theo bước 1 trong hướng dẫn thiết lập OAuth của Google Workspace. Đối với các 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 phiên bản Looker làm URI trong mục "Nguồn gốc JavaScript được uỷ quyền", 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 mà bạn muốn xuất bản tóm tắt. Nếu bạn không biết cách, hãy làm theo hướng dẫn này.
  5. Chỉnh sửa .Tệp env. Thay 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 Chat Google. 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 cục bộ, 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 trên Slack

  1. Làm theo bước 1 và 2 trong tài liệu chính thức dành cho nhà phát triển Slack để thiết lập một Ứng dụng OAuth. Đối với các phạm vi, bạn phải thêm chat:write và channels:read. Lưu lại mã ứng dụng khách và khoá bí mật của ứ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 env. Thay 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 cục bộ, 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ó thể xuất trực tiếp 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 thông tin tóm tắt đến một không gian trò chuyện cụ thể được mã hoá cứng trên Google 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 các không gian và kênh để 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 của trang tổng quan và truy vấn dữ liệu. Bạn có thể cải thiện độ chính xác, chi tiết và mức độ chuyên sâu của bản tóm tắt và các bước đề xuất bằng cách thêm nhiều siêu dữ liệu và bối cảnh nhất có thể vào chính trang tổng quan. Hãy thử các bước này cho từng trang tổng quan mà tiện ích của bạn là một phần trong đó:

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

Bạn càng thêm nhiều thông tin vào trang tổng quan thì tiện ích càng có thể đưa ra bản tóm tắt và các bước tiếp theo hiệu quả hơn. Bạn có thể sửa đổi mã để đưa thêm siêu dữ liệu 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ý 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ẽ gọi Vertex AI cho từng truy vấn trong trang tổng quan, cộng thêm một lệnh gọi cuối cùng để định dạng tất cả bản tóm tắt. Làm theo phần này để ghi nhật ký các lệnh gọi Vertex AI mà tiện ích của bạn thực hiện để bạn có thể ước tính và giám sát chi phí cũng như lưu lượng truy cập của Vertex AI. Bạn chỉ nên làm theo các 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 một đích nhận nhật ký sẽ định tuyến nhật ký đến BigQuery. Đích đến của bồn lưu trữ dữ liệu phải là BigQuery. Đặt bộ lọc bao gồm 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 của Looker tại địa phương để dùng thử. Bạn cũng đã triển khai tiện ích này lên Google Cloud để những 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ể truy cập vào bản tóm tắt và các bước tiếp theo do Gemini cung cấp ngay trong trang tổng quan.

10. Bước tiếp theo