Hướng dẫn nhanh: Tạo văn bản bằng Vertex AI

Trang này giải thích cách sử dụng dịch vụ nâng cao Vertex AI của Apps Script để nhắc mô hình Gemini 2.5 Flash tạo văn bản.

Để tìm hiểu thêm về dịch vụ nâng cao của Vertex AI, hãy xem tài liệu tham khảo.

Văn bản do AI tạo từ dịch vụ nâng cao Vertex AI của Apps Script.
Hình 1. Phản hồi của dịch vụ Vertex AI trong nhật ký thực thi Apps Script.

Mục tiêu

  • Thiết lập môi trường.
  • Tạo một dự án Apps Script sử dụng dịch vụ nâng cao Vertex AI.
  • Chạy tập lệnh để tạo văn bản.

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

Thiết lập môi trường

Phần này giải thích cách định cấu hình và thiết lập môi trường của bạn trong Google Cloud Console và Apps Script.

Bật Vertex AI API trong dự án trên Cloud

  1. Trong Google Cloud Console, hãy mở dự án Google Cloud của bạn rồi bật Vertex AI API:

    Bật API

  2. Xác nhận rằng bạn đang bật API trong dự án Cloud chính xác, 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.

Tạo và thiết lập dự án Apps Script

Để tạo và thiết lập dự án Apps Script, hãy hoàn tất các bước sau:

  1. Truy cập vào script.google.com.
  2. Nhấp vào Dự án mới để tạo một dự án Apps Script.
  3. Ở trên cùng bên trái, hãy nhấp vào Dự án không có tiêu đề.
  4. Đặt tên cho tập lệnh là Vertex AI quickstart rồi nhấp vào Rename (Đổi tên).

Thiết lập dịch vụ nâng cao Vertex AI

Để bật dịch vụ nâng cao của Vertex AI và thiết lập mã, hãy làm như sau:

  1. Trong trình chỉnh sửa tập lệnh, hãy chuyển đến Dịch vụ rồi nhấp vào Thêm dịch vụ Biểu tượng để thêm dịch vụ.
  2. Trong trình đơn thả xuống, hãy chọn Vertex AI API rồi nhấp vào Thêm.

  3. Mở tệp Code.gs rồi thay thế nội dung của tệp bằng đoạn mã sau:

    /**
 * Main entry point to test the Vertex AI integration.
 */
function main() {
  const prompt = 'What is Apps Script in one sentence?';

  try {
    const response = callVertexAI(prompt);
    console.log(`Response: ${response}`);
  } catch (error) {
    console.error(`Failed to call Vertex AI: ${error.message}`);
  }
}

/**
 * Calls the Vertex AI Gemini model.
 *
 * @param {string} prompt - The user's input prompt.
 * @return {string} The text generated by the model.
 */
function callVertexAI(prompt) {
  // Configuration
  const projectId = 'GOOGLE_CLOUD_PROJECT_ID';
  const region = 'us-central1';
  const modelName = 'gemini-2.5-flash';

  const model = `projects/${projectId}/locations/${region}/publishers/google/models/${modelName}`;

  const payload = {
    contents: [{
      role: 'user',
      parts: [{
        text: prompt
      }]
    }],
    generationConfig: {
      temperature: 0.1,
      maxOutputTokens: 2048
    }
  };

  // Execute the request using the Vertex AI Advanced Service
  const response = VertexAI.Endpoints.generateContent(payload, model);

  // Use optional chaining for safe property access
  return response?.candidates?.[0]?.content?.parts?.[0]?.text || 'No response generated.';
}

    Thay GOOGLE_CLOUD_PROJECT_ID bằng mã dự án của dự án trên Đám mây.

  4. Nhấp vào Lưu Biểu tượng Lưu.

Kiểm thử tập lệnh

  1. Trong trình chỉnh sửa tập lệnh, hãy nhấp vào Chạy để chạy hàm main.
  2. Nếu được nhắc, hãy cho phép tập lệnh chạy.
  3. Nhấp vào Execution log (Nhật ký thực thi) để xem phản hồi từ Vertex AI.

Vertex AI trả lời câu hỏi, What is Apps Script in one sentence?. Ví dụ: nhật ký thực thi trả về một phản hồi như sau:

Response: Google Apps Script is a cloud-based, JavaScript platform that lets you
automate, integrate, and extend Google Workspace applications like Sheets, Docs,
and Gmail.

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.

  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.

Để tránh bị tính 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 bắt đầu nhanh này, bạn nên xoá dự án trên Cloud.