Tập hợp, chạy và tuỳ chỉnh Tiện ích bổ sung dành cho nhân viên đánh giá trang trình bày cho Trang trình bày trên Google Workspace bằng dự án mã này. Dù bạn thực hiện một bài thuyết trình mỗi tuần hay mỗi năm một bài, hầu hết chúng ta đều có thể trợ giúp để hoàn thành bài thuyết trình đúng cách. Con có muốn đưa quá nhiều nội dung vào một trang trình bày không? Có thể bạn quên chia nhỏ bản trình bày của mình bằng các hình ảnh? Thậm chí, bạn có thể có một bộ nguyên tắc của tổ chức mình về các bản trình bày hiệu quả. Bạn có đọc dữ liệu đó gần đây không?
Dự án Trang trình bày cố vấn là một nguồn mở, Tiện ích bổ sung của Google Workspace. Tiện ích này sử dụng công nghệ trí tuệ nhân tạo (AI) để xem xét và đưa ra ý kiến phản hồi về các bản trình bày của bạn, bất cứ khi nào bạn cần. Dự án này sử dụng các tính năng xử lý văn bản và hình ảnh API Gemini của Google để phân tích Google Trang trình bày của bạn dựa trên một bộ nguyên tắc, đồng thời cho biết tiến độ của bạn đối với những nguyên tắc đó. Hơn nữa, bạn có thể tuỳ chỉnh các nguyên tắc đó để làm theo đề xuất của tổ chức hoặc nhắc bạn cải thiện bản trình bày dựa trên các quy tắc mà bạn tự xác định.
Để xem video tổng quan về dự án này và cách mở rộng dự án, bao gồm cả thông tin chi tiết của những đội ngũ tạo ra dự án, hãy xem bài viết Trình đánh giá trang trình bày dựa trên AI – Xây dựng bằng AI của Google. Nếu không, bạn có thể bắt đầu mở rộng dự án bằng cách làm theo các hướng dẫn sau.
Hình 1. Tiện ích bổ sung cố vấn của Trang trình bày dành cho Google Trang trình bày chạy dưới dạng bảng điều khiển thanh bên.
Thiết lập dự án
Các hướng dẫn này sẽ hướng dẫn bạn thiết lập dự án Trang trình bày cố vấn để phát triển và kiểm thử. Các bước chung bao gồm tạo dự án Tập lệnh Google Apps, thiết lập dự án Google Cloud để truy cập API và thiết lập một số thuộc tính Tập lệnh cho dự án.
Tạo dự án Apps Script
Dự án Trang trình bày cố vấn này chạy dưới dạng một Tiện ích bổ sung cho Google Trang trình bày. Bạn có thể thiết lập dự án bằng giao diện web của Google Trang trình bày rồi tạo một dự án Apps Script cho mã này.
Cách tạo dự án Apps Script mới:
- Chuyển đến ứng dụng web Trang trình bày dành cho Google Workspace.
- Mở bản trình bày hiện có hoặc tạo bản trình bày mới.
- Trong bản trình bày trên Trang trình bày, hãy chọn Tiện ích > Apps Script.
Sau khi hoàn tất các bước này, bạn sẽ có một Untitled project (Dự án chưa đặt tên) mới trong giao diện người dùng web Apps Script. Bản trình bày này được đính kèm vào bản trình bày mà bạn đã bắt đầu. Đặt tên cho dự án để dễ tìm hơn.
Cách đặt tên cho dự án Apps Script:
- Trong giao diện web của Apps Script, hãy chọn văn bản Mã dự án chưa đặt tên.
- Trong hộp thoại Đổi tên dự án, hãy nhập:
My Slides Advisorrồi chọn Đổi tên.
Chuẩn bị tệp dự án
Dự án Trang trình bày DoubleClick có 5 tệp mã và bạn cần thiết lập các tệp đó rồi mới có thể sao chép mã vào dự án Apps Script mới. Phần này mô tả cách chuẩn bị dự án và lấy mã.
Cách chuẩn bị tệp dự án:
- Mở giao diện web của Apps Script có chứa dự án My Trang trình bày cố vấn.
- Trên trình đơn bên trái, hãy chọn chế độ xem < > Trình chỉnh sửa.
- Đổi tên tệp Code.gs thành main.gs bằng cách di chuột qua tên tệp mã Code.gs, chọn Đổi tên từ trình đơn theo bối cảnh,
nhập
main. Giao diện tự động thêm đuôi .gs. - Hiển thị tệp kê khai appscript.json của dự án bằng cách chọn biểu tượng bánh răng (Project Settings (Cài đặt dự án)) trên trình đơn bên trái, sau đó bật lựa chọn Show "appscript.json" manifest file (Hiển thị tệp kê khai "appscript.json".
- Trong giao diện web Apps Script, ở trình đơn bên trái, hãy chọn chế độ xem < > Editor (Trình chỉnh sửa).
- Tạo tệp mã ui.gs bằng cách chọn biểu tượng + (dấu cộng) ở bên phải tiêu đề Files (Tệp), chọn Script (Tập lệnh) rồi nhập
ui. - Lặp lại bước trước đó để tạo các tệp mã
slides.gsvàai.gs.
Dự án Apps Script của bạn hiện sẽ chứa 5 tệp mã sau đây hầu hết đều trống:
- appscript.json
- main.gs
- ui.gs
- slides.gs
- ai.gs
Đối với bước tiếp theo, hãy lấy mã dự án từ kho lưu trữ và sao chép mã đó vào dự án Apps Script.
Lấy mã dự án
Mã nguồn cho dự án Trang trình bày cố vấn được lưu trữ trong kho lưu trữ mã. Bạn cần sao chép mã đó vào dự án Apps Script để xử lý mã đó. Phần này mô tả cách lấy mã dự án.
Cách lấy mã dự án:
- Chuyển đến kho lưu trữ mã dự án cho tệp kê khai dự án,
appsscript.json - Sao chép nội dung của tệp mã này vào bảng nhớ tạm.
- Quay lại giao diện web của Apps Script, chọn tên tệp appsscript.json rồi dán mã vào bảng điều khiển trình soạn thảo mã, thay thế mọi mã trước đó.
- Lặp lại quy trình này cho 4 tệp mã khác:
Kết nối dự án trên Google Cloud
Dự án này sử dụng một dự án Google Cloud để truy cập vào các mô hình AI của Gemini. Google Cloud cung cấp các chính sách cụ thể về quyền riêng tư đối với dữ liệu, cũng như nhiều dịch vụ phần mềm hữu ích để xây dựng các ứng dụng như Trang trình bày cố vấn. Bạn kết nối mã Tiện ích bổ sung với API Gemini bằng cách tạo một dự án Cloud có quyền truy cập API AI, tạo tài khoản dịch vụ cho dự án, tạo khoá cho tài khoản dịch vụ và cài đặt khoá đó trong dự án Tiện ích bổ sung của bạn.
Định cấu hình dự án Cloud
Dự án Cloud mà bạn sử dụng để kết nối với API Gemini phải bật dịch vụ Vertex AI API và bạn cần tạo mối kết nối đã xác thực từ Tiện ích bổ sung cố vấn của Trang trình bày với dự án này. Vertex AI API cũng yêu cầu bạn phải bật tính năng thanh toán trong các dự án mà bạn sử dụng API này.
Cách định cấu hình dự án Cloud có quyền truy cập vào Vertex AI API:
- Chuyển đến bảng điều khiển Google Cloud rồi đăng nhập nếu cần.
- Trong bảng điều khiển Google Cloud, hãy chọn một Dự án trên đám mây hiện có hoặc tạo một dự án mới.
- Trên trang Trang tổng quan của dự án trên bảng điều khiển, trong bảng điều khiển API, hãy chọn Go to APIs Overview (Chuyển đến trang tổng quan về API) hoặc chuyển đến https://console.cloud.google.com/apis/.
- Trong trang API và Dịch vụ, ở đầu trang, hãy chọn + BẬT API VÀ DỊCH VỤ.
- Trên trang Thư viện API, hãy tìm kiếm
vertex ai api, chọn tuỳ chọn Vertex AI API (API Vertex AI) rồi chọn nút Bật. - Nếu chưa hoạt động, bạn phải Bật tính năng thanh toán cho dự án Google Cloud, sau đó bật API AI bằng cách chọn nút Enable (Bật) trên trang bảng điều khiển Vertex AI API.
- Xác minh rằng bạn đã bật Vertex AI API bằng cách chuyển đến trang API và dịch vụ cho dự án của bạn. Bây giờ, bạn sẽ thấy Vertex AI API được liệt kê trên trang này.
Tạo một tài khoản dịch vụ
Tiện ích Trang trình bày cố vấn yêu cầu kết nối đã xác thực với dự án Cloud của bạn để truy cập API Vertex AI và các mô hình Gemini. Trước tiên, bạn có thể tạo kết nối đó bằng cách tạo một tài khoản dịch vụ trong dự án trên Google Cloud có quyền truy cập vào Vertex AI API. Dự án Trang trình bày cố vấn kết nối bằng tài khoản dịch vụ này.
Cách tạo tài khoản dịch vụ cho Tiện ích bổ sung của Trang trình bày DoubleClick:
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang API và dịch vụ cho dự án Cloud của bạn.
- Ở bên trái trang, hãy chọn Thông tin xác thực.
- Ở đầu trang, hãy chọn + TẠO CREENTIALS > Tài khoản dịch vụ.
- Trên trang Tạo tài khoản dịch vụ, phần Thông tin chi tiết về tài khoản dịch vụ, hãy nhập tên, mã và nội dung mô tả của tài khoản dịch vụ.
- Tạo tài khoản dịch vụ bằng cách chọn Tạo và tiếp tục.
- Trong phần Cấp quyền truy cập vào dự án cho tài khoản dịch vụ này, hãy chọn chế độ kiểm soát Vai trò.
- Trong trường Bộ lọc, hãy tìm kiếm, sau đó chọn tập hợp quyền Người dùng Vertex AI, rồi chọn Tiếp tục.
- Hoàn tất quá trình tạo tài khoản dịch vụ này bằng cách chọn Xong.
Để biết thêm thông tin về cách tạo tài khoản dịch vụ, hãy xem tài liệu Tạo tài khoản dịch vụ của Google Cloud.
Tạo và cài đặt khoá tài khoản dịch vụ
Dự án Trang trình bày cố vấn phải có khả năng xác thực tài khoản dịch vụ bạn đã tạo trong quy trình trước đó. Bạn có thể bật tính năng xác thực đó bằng cách tạo khoá cho tài khoản dịch vụ và định cấu hình khoá đó trong dự án Google Trang trình bày Advisor Apps Script dưới dạng Thuộc tính tập lệnh. Quy trình sau đây giải thích cách tạo khoá và định cấu hình khoá đó trong dự án của bạn.
Cách tạo và định cấu hình khoá tài khoản dịch vụ:
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang API và dịch vụ cho dự án Cloud của bạn.
- Ở bên trái trang, hãy chọn Thông tin xác thực.
- Trong phần Tài khoản dịch vụ, hãy tìm tài khoản dịch vụ bạn đã tạo, chọn địa chỉ email của tài khoản hoặc biểu tượng bút chì để chỉnh sửa.
- Trong cửa sổ chỉnh sửa tài khoản dịch vụ, ở gần đầu trang, hãy chọn tiêu đề thẻ KEYS.
- Trong phần Khoá, hãy chọn Thêm khoá > Tạo khoá mới.
- Trong hộp thoại Create private key for... (Tạo khoá riêng tư cho...), hãy chọn JSON rồi chọn Create (Tạo). Bước này sẽ tạo một tệp khoá có tên projectid-hashcode.json và tự động tải tệp này xuống máy tính của bạn.
- Mở tệp projectid - hashcode.json đã tải xuống rồi sao chép nội dung.
- Mở giao diện web của Apps Script chứa dự án My Trang trình bày cố vấn và trên trình đơn bên trái, hãy chọn chế độ xem Settings (Cài đặt).
- Trong phần Thuộc tính tập lệnh, hãy chọn nút Chỉnh sửa thuộc tính tập lệnh, sau đó chọn nút Thêm thuộc tính tập lệnh.
- Trong trường Property (Thuộc tính) mới, hãy nhập
SERVICE_ACCOUNT_KEYvà trong trường Value (Giá trị), hãy sao chép nội dung của tệp projectid-hashcode.json đã tải xuống. - Lưu thuộc tính mới bằng cách chọn nút Lưu thuộc tính tập lệnh.
Để biết thêm thông tin về cách tạo khoá tài khoản dịch vụ, hãy xem tài liệu Tạo và xoá khoá tài khoản dịch vụ của Google Cloud.
Kiểm thử dự án Tiện ích bổ sung
Việc kiểm thử dự án Trang trình bày cố vấn yêu cầu bạn tạo một hoạt động triển khai thử nghiệm
của mã Tiện ích bổ sung và cài đặt quá trình triển khai thử nghiệm đó. Trong cấu hình kiểm thử này, dự án chỉ có sẵn trong bản trình bày trên Google Trang trình bày, nơi bạn bắt đầu dự án Thêm Apps Script trên dự án, và không có bản trình bày nào khác trên Trang trình bày. Bạn có thể tìm hiểu thêm về cách triển khai Tiện ích bổ sung để sử dụng rộng rãi hơn trong tài liệu về Google Workspace Apps Script, chủ đề Tạo và quản lý các hoạt động triển khai.
Cách triển khai và kiểm thử mã dự án Apps Script:
- Ở trên cùng của giao diện web Apps Script, hãy chọn Triển khai > Triển khai thử nghiệm.
- Trong hộp thoại kiểm thử Triển khai, bên cạnh mục Chọn loại, hãy chọn biểu tượng bánh răng và Tiện ích bổ sung của Google Workspace.
- Bên cạnh(các) Ứng dụng: Tiêu đề trang trình bày, hãy chọn nút Cài đặt.
- Giữ nguyên chế độ cài đặt mặc định cho mục Kiểm tra mã mới nhất rồi chọn Xong.
- Di chuyển bản trình bày trên Google Trang trình bày được kết nối với dự án Apps Script rồi tải lại trang web.
- Ở góc dưới cùng bên phải của ứng dụng web Trang trình bày, hãy chọn biểu tượng ( < ) để mở bảng điều khiển bên, sau đó chọn biểu tượng mắt đen trắng để mở bảng điều khiển Slide Advisor.
Sau khi hoàn tất bước này và chạy thành công Tiện ích bổ sung, bạn có thể bắt đầu sửa đổi tiện ích này để sử dụng các nguyên tắc khác nhau hoặc làm theo một quy trình làm việc khác. Hãy xem các phần tiếp theo để biết hướng dẫn về cách thực hiện một số sửa đổi cơ bản đối với Tiện ích bổ sung dành cho Trợ lý Trang trình bày.
Sửa đổi hành vi đánh giá
Bạn có thể thay đổi hành vi xem xét của Trang trình bày cố vấn, cả về kết quả bạn nhận được từ API Gemini và giao diện người dùng do Tiện ích bổ sung cung cấp, bằng cách sửa đổi mã dự án. Hướng dẫn này tập trung vào việc thay đổi hướng dẫn nhắc để sửa đổi hành vi xem lại trang trình bày. Để biết thêm thông tin về cách mở rộng giao diện người dùng của Google Trang trình bày bằng Apps Script, hãy xem phần Mở rộng Google Trang trình bày.
Thay đổi nguyên tắc đánh giá
Trang trình bày hữu ích được lập trình với một bộ nguyên tắc đánh giá trang trình bày cơ bản gồm các danh mục về tính đơn giản, màu sắc và kiểu chữ, cấu trúc và khoảng trắng, đồ hoạ và biểu tượng. Nguyên tắc đánh giá chỉ là hướng dẫn bằng văn bản đi kèm câu lệnh thông qua API Gemini, cùng với ảnh chụp nhanh của một trang trình bày đã chọn và mọi ghi chú của người thuyết trình.
Bạn có thể thay đổi hành vi xem xét của Tiện ích bổ sung bằng cách thay đổi hướng dẫn bằng văn bản. Ví dụ: bạn có thể hướng dẫn mô hình Gemini xuất bài đánh giá với điểm xếp hạng danh mục trên cùng một dòng với tiêu đề danh mục hoặc thay đổi tên của danh mục.
Cách thay đổi vị trí xếp hạng danh mục và tên danh mục:
- Mở giao diện web của Apps Script có chứa dự án My Trang trình bày cố vấn. Nếu cần, hãy chuyển đến cửa sổ dự án bằng cách mở bản trình bày Google Trang trình bày chứa dự án Apps Script rồi chọn Tiện ích > Apps Script.
- Trên trình đơn bên trái, hãy chọn chế độ xem < > Editor (Trình chỉnh sửa), rồi chọn tên tệp ai.gs.
- Trong tệp mã ai.gs, hãy tìm hằng số chuỗi
SYSTEM_PROMPTrồi sửa đổi hướng dẫn như sau bằng văn bản in đậm:const SYSTEM_PROMPT = ` ... For each of the following categories evaluate the given slide. Score each category on a scale of 0 to 100, show the score next to the category heading, and concisely explain the reasoning. Do not suggest improvements if the score is 80 or above.
- Trong cùng một hằng số chuỗi
SYSTEM_PROMPT, hãy thay đổi văn bản danh mụcSimplicitythànhMessage:const SYSTEM_PROMPT = ` ... * Message -- Slides should focus on one main idea per slide and ...
- Lưu nội dung thay đổi vào tệp mã ai.gs.
- Di chuyển bản trình bày trên Google Trang trình bày được kết nối với dự án Apps Script, tải lại trang web và kiểm tra các thay đổi đối với Tiện ích bổ sung bằng cách chạy lại Tiện ích bổ sung đó.
Nếu bạn chưa thiết lập quy trình triển khai thử nghiệm cho Tiện ích bổ sung trợ giúp trình bày, hãy làm theo hướng dẫn trong bài viết Kiểm thử dự án Tiện ích bổ sung.
Bạn có thể xoá, thay thế hoặc viết lại hướng dẫn về danh mục bài đánh giá trong hằng số chuỗi SYSTEM_PROMPT để phù hợp với các yêu cầu về bài đánh giá. Nếu bạn muốn thử nhiều phương pháp khác nhau liên quan đến lời nhắc xem xét hoặc viết lại toàn bộ lời nhắc xem xét, hãy xem ứng dụng web Google AI Studio. Ứng dụng này cho phép bạn tạo nguyên mẫu, kiểm thử và lưu lời nhắc cho Gemini trong một giao diện tiện lợi. Đồng thời, ứng dụng này cũng sử dụng cùng một API Gemini như dự án của Trang trình bày cố vấn. Để biết thêm thông tin về cách sử dụng AI Studio, hãy xem Hướng dẫn bắt đầu nhanh về AI Studio.
Thay đổi cấu hình hành vi của mô hình
API Gemini cung cấp một số chế độ cài đặt để thay đổi hoạt động chung của mô hình nhằm phản hồi lời nhắc yêu cầu. Cụ thể, chế độ cài đặt nhiệt độ cho mô hình cho phép bạn đặt mức biến thể mà mô hình được phép trong một phản hồi, trong đó 0 là thấp nhất và 1 là cao nhất. Việc đặt giá trị này ở mức 0.1 sẽ tạo ra các phản hồi rất nhất quán, nhưng hành vi đó có vẻ lặp lại và không hữu ích cho người dùng khi nhận ý kiến phản hồi đánh giá. Cân nhắc đặt giá trị nhiệt độ cao hơn và lưu ý rằng nhiệt độ càng cao thì kết quả càng không nhất quán, có thể bao gồm việc triển khai hướng dẫn theo cách khác và thậm chí là bỏ qua hoàn toàn một số hướng dẫn.
Cách tăng nhiệt độ cho bài đánh giá:
- Mở giao diện web của Apps Script có chứa dự án My Trang trình bày cố vấn.
- Trên trình đơn bên trái, hãy chọn chế độ xem < > Editor (Trình chỉnh sửa), rồi chọn tên tệp ai.gs.
Trong tệp mã ai.gs, hãy tìm hàm
analyzeSlides()và sửa đổi hằng sốgenerationConfigbằng cách đặt giá trịtemperaturethành0.3:function analyzeSlides(slide) { const generationConfig = { temperature: 0.3, maxOutputTokens: 1024 * 2, };Lưu nội dung thay đổi vào tệp mã ai.gs.
Di chuyển bản trình bày trên Google Trang trình bày được kết nối với dự án Apps Script, tải lại trang web và kiểm tra các thay đổi đối với Tiện ích bổ sung bằng cách chạy lại Tiện ích bổ sung đó.
Để biết thêm thông tin về chế độ cài đặt cấu hình hành vi của mô hình, hãy xem tài liệu về API Gemini cho GenerationConfig.
Tài nguyên bổ sung
Để biết thêm thông tin về dự án Trang trình bày cố vấn, hãy xem kho lưu trữ mã. Nếu bạn cần trợ giúp để tạo ứng dụng hoặc muốn cộng tác với các nhà phát triển khác, hãy xem máy chủ Discord của Cộng đồng Google Developers. Để tìm hiểu các dự án AI khác trong ứng dụng Xây dựng với Google, hãy xem danh sách phát video.