Kiểm chứng thông tin bằng mô hình Gemini và tác nhân AI ADK

Cấp độ lập trình: Nâng cao
Thời lượng: 30 phút
Loại dự án: Hàm tuỳ chỉnh

Tổng quan

Một hàm tuỳ chỉnh kiểm chứng thông tin cho Google Trang tính được dùng làm dự án Apps Script liên kết, hoạt động dựa trên một tác nhân Vertex AI và mô hình Gemini.

Mẫu này minh hoạ cách bạn có thể sử dụng trực tiếp 2 loại tài nguyên AI mạnh mẽ trong bảng tính Google Trang tính:

1. Tác nhân AI có khả năng suy luận phức tạp, đa công cụ, nhiều bước bằng cách sử dụng các tác nhân ADK được triển khai trong Vertex AI Agent Engine.
2. Các mô hình AI để hiểu, tạo sinh và tóm tắt thông tin nâng cao bằng cách sử dụng các mô hình Gemini từ Vertex AI.

Mục tiêu

• Tìm hiểu về chức năng của giải pháp.
• Tìm hiểu cách triển khai giải pháp.
• Triển khai tác nhân Vertex AI.
• Thiết lập tập lệnh.
• Chạy tập lệnh.

Giới thiệu về giải pháp này

Hàm tuỳ chỉnh của Trang tính có tên là FACT_CHECK và hoạt động như một giải pháp toàn diện. Tính năng này phân tích một câu lệnh, đưa ra câu trả lời dựa trên thông tin mới nhất trên web và trả về kết quả theo định dạng bạn cần:

• Cách sử dụng:
  • =FACT_CHECK("Your statement here") để có đầu ra ngắn gọn và tóm tắt.
  • =FACT_CHECK("Your statement here", "Your output formatting instructions here") cho một định dạng đầu ra cụ thể.
• Lý do: LLM Auditor ADK AI Agent (Mẫu Python).
• Định dạng đầu ra: Mô hình Gemini.

Giải pháp này yêu cầu Vertex AI REST API bằng cách sử dụng UrlFetchApp.

Kiến trúc

Sơ đồ sau đây cho thấy cấu trúc của các tài nguyên Google Workspace và Google Cloud mà hàm tuỳ chỉnh sử dụng.

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

Để sử dụng mẫu này, bạn cần đáp ứng các điều kiện tiên quyết sau:

• Một Tài khoản Google (tài khoản Google Workspace có thể yêu cầu quản trị viên phê duyệt).

• Một trình duyệt web có quyền truy cập vào Internet.

• Điều kiện tiên quyết của tác nhân LLM Auditor ADK

  • Python 3.11 trở lên: Để cài đặt, hãy làm theo hướng dẫn trên trang web chính thức của Python.
  • Python Poetry: Để cài đặt, hãy làm theo hướng dẫn trên trang web chính thức của Poetry.
  • Google Cloud CLI: Để cài đặt, hãy làm theo hướng dẫn trên trang web chính thức của Google Cloud.

Chuẩn bị môi trường

Phần này hướng dẫn cách tạo và định cấu hình một dự án trên Google Cloud.

Tạo một dự án trên Google Cloud

Bảng điều khiển Google Cloud

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Tạo dự án.

   Chuyển đến phần Tạo dự án

2. Trong trường Tên dự án, hãy nhập tên mô tả cho dự án của bạn.

   Không bắt buộc: Để chỉnh sửa Mã dự án, hãy nhấp vào Chỉnh sửa. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã dự án đáp ứng nhu cầu của bạn trong suốt thời gian tồn tại của dự án.

3. Trong trường Vị trí, hãy nhấp vào Duyệt xem để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó, hãy nhấp vào Chọn.
   Thận trọng: Bạn không tìm thấy tổ chức của mình trên Google Workspace?
   Điều này có nghĩa là bạn chưa đăng nhập vào tài khoản Google Workspace. Một số tính năng được mô tả trong tài liệu dành cho nhà phát triển Google Workspace chỉ dành cho những dự án được liên kết với một tổ chức.
4. Nhấp vào Tạo. Bảng điều khiển Google Cloud sẽ chuyển đến trang Tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.

gcloud CLI

Trong một trong các môi trường phát triển sau đây, hãy truy cập vào Google Cloud CLI (gcloud):

• Cloud Shell: Để sử dụng một thiết bị đầu cuối trực tuyến đã thiết lập gcloud CLI, hãy kích hoạt Cloud Shell.
  Kích hoạt Cloud Shell
• Local Shell: Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi động CLI gcloud.
  Để tạo một dự án trên Cloud, hãy dùng lệnh gcloud projects create:

  gcloud projects create PROJECT_ID

  Thay thế PROJECT_ID bằng cách đặt mã nhận dạng cho dự án mà bạn muốn tạo.

Bật tính năng thanh toán cho dự án trên Google Cloud

Nếu không thể liên kết tài khoản thanh toán, tức là bạn không có quyền cần thiết để thực hiện thay đổi này. Để biết thêm thông tin, hãy xem phần Các quyền cần thiết để bật tính năng thanh toán.

Bảng điều khiển Google Cloud

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Thanh toán. Nhấp vào Trình đơn > Thanh toán > Dự án của tôi.

   Chuyển đến phần Thanh toán cho dự án của tôi

2. Trong phần Chọn một tổ chức, hãy chọn tổ chức được liên kết với dự án Google Cloud của bạn.
3. Trong hàng dự án, hãy mở trình đơn Hành động (), nhấp vào Thay đổi thông tin thanh toán rồi chọn tài khoản thanh toán trên đám mây.
4. Nhấp vào Thiết lập tài khoản.

gcloud CLI

1. Để liệt kê các tài khoản thanh toán hiện có, hãy chạy lệnh:

   gcloud billing accounts list

2. Liên kết tài khoản thanh toán với một dự án trên Google Cloud:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   Thay thế nội dung sau:

   • PROJECT_ID là Mã dự án cho dự án trên Đám mây mà bạn muốn bật tính năng thanh toán.
   • BILLING_ACCOUNT_ID là mã tài khoản thanh toán cần liên kết với dự án trên Google Cloud.

Bật Vertex AI API

Bảng điều khiển Google Cloud

1. Trong Google Cloud Console, hãy bật Vertex AI API.

   Bật các API

2. Xác nhận rằng bạn đang bật Vertex AI API trong dự án Cloud chính xác, rồi nhấp vào Tiếp theo.

3. Xác nhận rằng bạn đang bật đúng API, sau đó nhấp vào Bật.

gcloud CLI

1. Nếu cần, hãy đặt dự án hiện tại trên Cloud thành dự án mà bạn đã tạo bằng lệnh gcloud config set project:

   gcloud config set project PROJECT_ID

   Thay PROJECT_ID bằng Mã dự án của dự án trên Cloud mà bạn đã tạo.

2. Bật Vertex AI API bằng lệnh gcloud services enable:

   gcloud services enable aiplatform.googleapis.com

Tạo tài khoản dịch vụ trong bảng điều khiển Google Cloud

Tạo một tài khoản dịch vụ mới có vai trò Vertex AI User bằng cách làm theo các bước sau:

Bảng điều khiển Google Cloud

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Tài khoản dịch vụ.

   Chuyển đến phần Tài khoản dịch vụ

2. Nhấp vào Tạo tài khoản dịch vụ.
3. Điền thông tin tài khoản dịch vụ, rồi nhấp vào Tạo và tiếp tục.
   Lưu ý: Theo mặc định, Google sẽ tạo một mã nhận dạng tài khoản dịch vụ duy nhất. Nếu bạn muốn thay đổi mã nhận dạng, hãy sửa đổi mã nhận dạng trong trường mã nhận dạng tài khoản dịch vụ.
4. Không bắt buộc: Chỉ định vai trò cho tài khoản dịch vụ của bạn để cấp quyền truy cập vào các tài nguyên của dự án Google Cloud. Để biết thêm thông tin chi tiết, hãy tham khảo bài viết Cấp, thay đổi và thu hồi quyền truy cập vào tài nguyên.
5. Nhấp vào Tiếp tục.
6. Không bắt buộc: Nhập người dùng hoặc nhóm có thể quản lý và thực hiện các thao tác bằng tài khoản dịch vụ này. Để biết thêm thông tin, hãy tham khảo bài viết Quản lý hoạt động mạo danh tài khoản dịch vụ.
7. Nhấp vào Xong. Ghi lại địa chỉ email của tài khoản dịch vụ.

gcloud CLI

1. Tạo tài khoản dịch vụ:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Không bắt buộc: Chỉ định vai trò cho tài khoản dịch vụ của bạn để cấp quyền truy cập vào các tài nguyên của dự án Google Cloud. Để biết thêm thông tin chi tiết, hãy tham khảo bài viết Cấp, thay đổi và thu hồi quyền truy cập vào tài nguyên.

Tài khoản dịch vụ sẽ xuất hiện trên trang tài khoản dịch vụ. Tiếp theo, hãy tạo một khoá riêng tư cho tài khoản dịch vụ.

Tạo khoá riêng tư

Cảnh báo: Ví dụ này sử dụng khoá tài khoản dịch vụ đã xuất để đảm bảo tính đơn giản. Bạn không nên xuất khoá riêng tư trong quá trình phát hành vì khoá này không được lưu trữ ở một vị trí không an toàn, chẳng hạn như kiểm soát nguồn.

Để tìm hiểu thêm về các phương pháp hay nhất và cách triển khai tài khoản dịch vụ an toàn, hãy xem phần Chọn thời điểm sử dụng tài khoản dịch vụ.

Để tạo và tải khoá riêng tư xuống cho tài khoản dịch vụ, hãy làm theo các bước sau:

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Tài khoản dịch vụ.

   Chuyển đến phần Tài khoản dịch vụ

2. Chọn tài khoản dịch vụ của bạn.
3. Nhấp vào Khoá > Thêm khoá > Tạo khoá mới.
4. Chọn JSON, rồi nhấp vào Tạo.

   Cặp khoá công khai/riêng tư mới của bạn sẽ được tạo và tải xuống máy của bạn dưới dạng một tệp mới. Lưu tệp JSON đã tải xuống dưới dạng credentials.json trong thư mục đang hoạt động. Tệp này là bản sao duy nhất của khoá này. Để biết thông tin về cách lưu trữ khoá một cách an toàn, hãy xem phần Quản lý khoá tài khoản dịch vụ.

5. Nhấp vào Close (Đóng).

Để biết thêm thông tin về tài khoản dịch vụ, hãy xem phần tài khoản dịch vụ trong tài liệu IAM của Google Cloud.

Triển khai LLM Auditor ADK AI Agent

1. Nếu chưa thực hiện, hãy xác thực bằng tài khoản Google Cloud của bạn và định cấu hình Google Cloud CLI để sử dụng dự án Google Cloud của bạn.

   gcloud auth application-default login
   gcloud config set project PROJECT_ID
   gcloud auth application-default set-quota-project PROJECT_ID

   Thay PROJECT_ID bằng mã nhận dạng của dự án trên Cloud mà bạn đã tạo.

2. Tải kho lưu trữ này trên GitHub xuống

   Tải xuống

3. Trong môi trường phát triển cục bộ mà bạn muốn, hãy trích xuất tệp lưu trữ đã tải xuống rồi mở thư mục adk-samples/python/agents/llm-auditor.

   unzip adk-samples-main.zip
   cd adk-samples-main/python/agents/llm-auditor

4. Tạo một nhóm Cloud Storage mới dành riêng cho tác nhân ADK.

   gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATION

   Thay thế nội dung sau:

   1. CLOUD_STORAGE_BUCKET_NAME bằng một tên bộ chứa riêng biệt mà bạn muốn sử dụng.
   2. PROJECT_ID bằng mã nhận dạng của dự án trên Đám mây mà bạn đã tạo.
   3. PROJECT_LOCATION có vị trí của dự án trên Cloud mà bạn đã tạo.

5. Thiết lập các biến môi trường sau:

   export GOOGLE_GENAI_USE_VERTEXAI=true
   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   export GOOGLE_CLOUD_LOCATION=PROJECT_LOCATION
   export GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAME

   Thay thế nội dung sau:

   1. CLOUD_STORAGE_BUCKET_NAME bằng tên của nhóm mà bạn đã tạo.
   2. PROJECT_ID bằng mã nhận dạng của dự án trên Đám mây mà bạn đã tạo.
   3. PROJECT_LOCATION có vị trí của dự án trên Cloud mà bạn đã tạo.

6. Cài đặt và triển khai tác nhân ADK từ môi trường ảo.

   python3 -m venv myenv
   source myenv/bin/activate
   poetry install --with deployment
   python3 deployment/deploy.py --create

7. Truy xuất mã nhận dạng tác nhân, bạn sẽ cần mã này sau để định cấu hình hàm tuỳ chỉnh.

   python3 deployment/deploy.py --list

Xem lại mã mẫu

Nếu muốn, trước khi tạo bảng tính mới, hãy dành thời gian xem xét và làm quen với mã mẫu được lưu trữ trên GitHub.

Xem trên GitHub

Tạo và thiết lập trong bảng tính mới

1. Nhấp vào nút sau đây và sao chép hoàn toàn bảng tính mẫu trên Google Trang tính, bao gồm cả dự án Apps Script được liên kết với vùng chứa.

   Sao chép bảng tính Google Trang tính

2. Trong bảng tính mới tạo, hãy chuyển đến phần Tiện ích > Apps Script.

3. Trong dự án Apps Script, hãy chuyển đến Project Settings (Cài đặt dự án), nhấp vào Edit script properties (Chỉnh sửa thuộc tính tập lệnh), sau đó nhấp vào Add script property (Thêm thuộc tính tập lệnh) để thêm các thuộc tính tập lệnh sau:

   1. LOCATION có vị trí của dự án Google Cloud được tạo ở các bước trước, chẳng hạn như us-central1.
   2. GEMINI_MODEL_ID bằng mô hình Gemini mà bạn muốn sử dụng, chẳng hạn như gemini-2.5-flash-lite.
   3. REASONING_ENGINE_ID bằng mã của LLM Auditor ADK Agent đã triển khai trong các bước trước đó, chẳng hạn như 1234567890.
   4. SERVICE_ACCOUNT_KEY bằng khoá JSON từ tài khoản dịch vụ đã tải xuống ở các bước trước, chẳng hạn như { ... }.

4. Nhấp vào Lưu thuộc tính của tập lệnh

Kiểm thử hàm tuỳ chỉnh

1. Chuyển đến bảng tính mới tạo.
2. Thay đổi nội dung trong cột A.
3. Các công thức trong cột B sẽ thực thi rồi hiển thị kết quả xác minh tính xác thực.

Dọn dẹp

Để tránh phát sinh phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được dùng trong hướng dẫn này, bạn nên xoá dự án trên Cloud.

Thận trọng: Thao tác xoá dự án sẽ gây ra những tác động sau:

• Mọi nội dung trong dự án sẽ bị xoá. Nếu đã dùng một dự án hiện có cho hướng dẫn này, thì khi xoá dự án đó, bạn cũng sẽ xoá mọi công việc khác mà bạn đã thực hiện trong dự án.
• Mã dự án tuỳ chỉnh sẽ bị mất. Khi tạo dự án này, có thể bạn đã tạo một mã dự án tuỳ chỉnh mà bạn muốn sử dụng trong tương lai. Để giữ lại những URL sử dụng mã dự án (chẳng hạn như URL trên appspot.com), hãy xoá các tài nguyên đã chọn trong dự án thay vì xoá toàn bộ dự án.

Nếu dự định khám phá nhiều hướng dẫn và hướng dẫn bắt đầu nhanh, thì việc sử dụng lại các dự án có thể giúp bạn tránh vượt quá hạn mức dự án.

1. Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào Trình đơn > IAM và Quản trị viên > Quản lý tài nguyên.

   Chuyển đến Resource Manager

2. Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào biểu tượng Xoá .
3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.

Các bước tiếp theo

• Hàm tuỳ chỉnh trong Google Trang tính
• Mở rộng Google Trang tính