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

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

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

1. Tác nhân AI có khả năng suy luận phức tạp, đa công cụ và 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. Mô hình AI có khả năng hiểu, tạo và tóm tắt nâng cao bằng cách sử dụng các mô hình Gemini từ Vertex AI.

Mục tiêu

• Hiểu rõ chức năng của giải pháp.
• Hiểu rõ 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 Trang tính có tên là FACT_CHECK và hoạt động như một giải pháp toàn diện. Hàm này phân tích một câu lệnh, liên kết phản hồi bằng thông tin mới nhất trên web và trả về kết quả ở định dạng bạn cần:

• Cách sử dụng:
  • =FACT_CHECK("Your statement here") để có kết quả ngắn gọn và được tóm tắt.
  • =FACT_CHECK("Your statement here", "Your output formatting instructions here") để có định dạng đầu ra cụ thể.
• Suy luận: Tác nhân AI LLM Auditor ADK (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 UrlFetchApp.

Kiến trúc

Sơ đồ sau đây cho thấy kiến 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:

• Tài khoản Google (tài khoản Google Workspace có thể cần được quản trị viên phê duyệ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 đám mây của Google.

Tạo dự án trên Google Cloud

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

1. Trong bảng điều khiển Cloud, hãy chuyển đến trình đơ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 Project Name (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 Edit. 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ã đá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 Location (Vị trí), hãy nhấp vào Browse (Duyệt xem) để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó, nhấp vào Select (Chọn).
   Thận trọng: Không tìm thấy tổ chức Google Workspace của bạn?
   Đ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 các 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 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 sẵn, hãy kích hoạt Cloud Shell.
  Kích hoạt Cloud Shell
• Local Shell (Shell cục bộ): Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi động gcloud CLI.
  Để tạo một dự án trên đám mây, hãy sử 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 bạn muốn tạo.

Bật tính năng thanh toán cho dự án trên đám mây

Nếu không thể liên kết tài khoản thanh toán, thì bạn không có cá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 bài viết 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 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 Select an organization (Chọn một tổ chức), hãy chọn tổ chức được liên kết với dự án trên đám mây của bạn.
3. Trong hàng dự án, hãy mở trình đơn Actions (), nhấp vào Change billing rồi chọn tài khoản thanh toán Cloud.
4. Nhấp vào Set account (Đặt tài khoản).

gcloud CLI

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

   gcloud billing accounts list

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

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

   Thay thế nội dung sau:

   • PROJECT_ID là Project ID (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à billing account ID (mã tài khoản thanh toán) để liên kết với dự án trên đám mây của Google Cloud.

Bật Vertex AI API

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

1. Trong bảng điều khiển Google Cloud, hãy bật Vertex AI và Cloud Resource Manager API.

   Bật API

2. Xác nhận rằng bạn đang bật Vertex AI API trong đúng dự án trên đám mây, sau đó nhấp vào Next (Tiếp theo).

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

gcloud CLI

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

   gcloud config set project PROJECT_ID

   Thay thế PROJECT_ID bằng Project ID (Mã dự án) của dự án trên đám mây 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 Cloud

Tạo một tài khoản dịch vụ mới có vai trò Vertex AI User (Người dùng Vertex AI) 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 trình đơ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 chi tiết về tài khoản dịch vụ, sau đó nhấp vào Tạo và tiếp tục.
   Lưu ý: Theo mặc định, Google sẽ tạo một mã 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ã 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ấp quyền truy cập vào tài nguyên của dự án trên Google Cloud. Để biết thêm thông tin, 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 hành động 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ý việc mạo danh tài khoản dịch vụ.
7. Nhấp vào Xong. Ghi lại địa chỉ email cho 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ấp quyền truy cập vào tài nguyên của dự án trên Google Cloud. Để biết thêm thông tin, 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 để đơn giản hoá. Bạn không nên xuất khoá riêng tư trong quá trình sản xuất 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 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 trình đơ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ụ.
3. Nhấp vào Khoá > Thêm khoá > Tạo khoá mới.
4. Chọn JSON, sau đó 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 làm việc của bạn. 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á an toàn, hãy xem bài viết 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 tài khoản dịch vụ trong tài liệu về Google Cloud IAM.

Triển khai tác nhân AI LLM Auditor ADK

1. Nếu chưa thực hiện, hãy xác thực bằng tài khoản Google Cloud và định cấu hình Google Cloud CLI để sử dụng dự án trên đám mây 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 thế PROJECT_ID bằng mã nhận dạng của dự án trên đám mây 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 ưu tiên, hãy trích xuất tệp lưu trữ đã tải xuống và 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 vùng chứa Cloud Storage 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 tên vùng chứa duy nhấ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 bằng vị trí của dự án trên đám mây 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 vùng chứa 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 bằng vị trí của dự án trên đám mây 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. Lấy mã 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

Không bắt buộc: Trước khi tạo bảng tính mới, hãy dành chút thời gian để xem lại và làm quen với mã mẫu được lưu trữ trên GitHub.

Xem trên GitHub

Tạo và định cấu hình trong bảng tính mới

1. Để tạo bản sao hoàn chỉnh của bảng tính Trang tính mẫu, bao gồm cả dự án Apps Script liên kết với vùng chứa, hãy nhấp vào nút sau:

   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 phầ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 bằng vị trí của dự án trên đám mây của Google được tạo trong 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ã nhận dạng của tác nhân LLM Auditor ADK được 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ụ được tải xuống trong các bước trước, chẳng hạn như { ... }.

4. Nhấp vào Lưu thuộc tính 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 câu lệnh 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ả kiểm tra thông tin thực tế.

Dọn dẹp

Để tránh bị tính phí cho tài khoản Google Cloud đối với các tài nguyên được sử dụng trong hướng dẫn này, bạn nên xoá dự án trên đám mây.

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

• Mọi thứ trong dự án đều bị xoá. Nếu bạn đã sử 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, bạn có thể đã 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 các 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 bên trong dự án thay vì xoá toàn bộ dự án.

Nếu bạn 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 bảng điều khiển Cloud, 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ị > 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 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

• Lên kế hoạch cho chuyến đi bằng một tác nhân AI có thể truy cập trên Google Workspace
• Tạo các tác nhân Gemini Enterprise được tích hợp chặt chẽ với các kho lưu trữ dữ liệu, API và tiện ích bổ sung của Workspace
• Tạo các tác nhân Vertex AI được tích hợp chặt chẽ với các kho lưu trữ dữ liệu, API và tiện ích bổ sung của Workspace
• Hàm tuỳ chỉnh trong Trang tính
• Mở rộng Trang tính