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

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

Tổng quan

Một hàm tùy chỉnh kiểm tra thực tế cho Google Trang tính được sử dụng làm dự án Apps Script ràng buộc được hỗ trợ bởi tác nhân Vertex AI và mô hình Gemini.

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

1. Các tác nhân AI cho 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. Mô hình AI cho khả năng hiểu biết, tạo ra và tóm tắt nâng cao bằng cách sử dụng mô hình Gemini từ Vertex AI.

Mục tiêu

• Hiểu giải pháp này có tác dụng gì.
• 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 tùy chỉnh của Sheets có tên là FACT_CHECK và hoạt động như một giải pháp toàn diện. Công cụ này phân tích một câu lệnh, đưa ra phản hồi dựa trên thông tin web mới nhất 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ó kết quả đầ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ý luận: 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:

• Tài khoản Google (tài khoản Google Workspace có thể cần được quản trị viên chấp thuận).

• 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 Poetry chính thức.
  • 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à cấu hình dự án Google Cloud.

Tạo một dự á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.

   Tùy chọn: Để chỉnh sửa ID dự án, hãy nhấp vào Chỉnh sửa. ID dự án không thể thay đổi sau khi dự án được tạo, vì vậy hãy chọn ID đá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 để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó, nhấp vào 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 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, hãy truy cập Google Cloud CLI (gcloud):

• Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến với gcloud CLI đã được thiết lập, hãy kích hoạt Cloud Shell.
  Kích hoạt Cloud 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 tạo gcloud CLI.
  Để tạo dự án Cloud, hãy sử dụng lệnh gcloud projects create:

  gcloud projects create PROJECT_ID

  Thay thế PROJECT_ID bằng cách đặt ID cho dự án 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 mục Thanh toán. Nhấp vào Menu > Thanh toán > Dự án của tôi.

   Đi tới mục 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 trên Google Cloud của bạn.
3. Trong hàng dự án, hãy mở menu Hành động (), nhấp vào Thay đổi thanh toán và 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 khả dụng, 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 Google Cloud:

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

   Thay thế nội dung sau:

   • PROJECT_ID là ID dự án cho dự án Cloud mà bạn muốn bật tính năng thanh toán.
   • BILLING_ACCOUNT_ID là ID tài khoản thanh toán để liên kết với dự án Google Cloud.

Kích hoạt API Vertex AI

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

1. Trong bảng điều khiển Google Cloud, 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 đúng dự án Cloud, sau đó 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 Cloud 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 ID dự án của dự án Cloud mà bạn đã tạo.

2. Bật API Vertex AI 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 tài khoản dịch vụ mới với 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ụ, 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ã 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 chi tiết, hãy tham khảo 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 chi tiết, hãy tham khảo Quản lý hành vi 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ủ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, tạo khóa riêng cho tài khoản dịch vụ.

Tạo khóa 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 Khóa > Thêm khóa > Tạo khóa 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 đang hoạt động. Tệp này là bản sao duy nhất của khóa 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 tài khoản dịch vụ trong tài liệu Google Cloud IAM.

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à 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 thế PROJECT_ID bằng ID của dự án Cloud mà bạn đã tạo.

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

   Tải xuống

3. Trong môi trường phát triển cục bộ mà bạn muốn, hãy giải nén 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 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 tên bộ chứa riêng biệt mà bạn muốn sử dụng.
   2. PROJECT_ID với ID của dự án Cloud 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. Lấy ID tác nhân, bạn sẽ cần nó sau này để cấu hình chức năng tùy chỉnh.

   python3 deployment/deploy.py --list

Xem lại mã mẫu

Ngoài ra, 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à thiết lập trong bảng tính mới

1. Nhấp vào nút sau và tạo một bản sao hoàn chỉnh của bảng tính Google Trang tính mẫu bao gồm cả dự án Apps Script có chứa trong đó.

   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 Tiện ích mở rộng > Apps Script.

3. Trong dự án Apps Script, hãy đi tới Cài đặt dự án, nhấp vào Chỉnh sửa thuộc tính tập lệnh, sau đó nhấp vào 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 với ID của LLM Auditor ADK Agent được triển khai ở các bước trước đó như 1234567890.
   4. SERVICE_ACCOUNT_KEY với khóa JSON từ tài khoản dịch vụ đã tải xuống ở các bước trước đó như { ... }.

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

Kiểm tra chức năng tùy 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 và sau đó hiển thị kết quả kiểm tra thực tế.

Dọn dẹp

Để tránh phát sinh chi phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được sử dụng trong hướng dẫn này, chúng tôi khuyên bạn nên xóa dự án Cloud.

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

• Mọi thứ trong dự án đều bị xóa. Nếu bạn sử dụng một dự án hiện có cho hướng dẫn này, khi xóa dự án đó, bạn cũng xóa mọi công việc khác mà bạn đã thực hiện trong dự án đó.
• ID dự án tùy chỉnh bị mất. Khi bạn tạo dự án này, bạn có thể đã tạo một ID dự án tùy 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 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 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.

   Đi tới Trình quản lý tài nguyên

2. Trong danh sách dự án, hãy chọn dự án bạn muốn xóa, sau đó nhấp vào Xóa .
3. Trong hộp thoại, nhập ID dự án rồi nhấp vào Tắt máy để xóa dự án.

Các bước tiếp theo

• Lên kế hoạch cho chuyến đi với một đặc vụ AI có thể truy cập trên Google Workspace
• Hàm tuỳ chỉnh trong Google Trang tính
• Mở rộng Google Trang tính