Blog CNTT Hà Nam

Cách tích hợp AI Gemini cho Google Sheets với hàm AskGPT tùy chỉnh

—

bởi

admin
trong

Bạn có bao giờ muốn “hỏi” trí tuệ nhân tạo trực tiếp từ bảng tính Google Sheets của mình chưa? Với một chút Google Apps Script và API của Gemini, bạn hoàn toàn có thể! Bài viết này sẽ hướng dẫn bạn cách tạo một hàm tùy chỉnh có tên ASKGPT trong Google Sheets để gửi câu hỏi đến mô hình Gemini 2.0 Flash và nhận câu trả lời ngay lập tức.

Tại Sao Nên Tích Hợp Gemini Với Google Sheets?

Việc tích hợp này mở ra nhiều khả năng thú vị:

  • Nghiên cứu & Phân tích Dữ liệu: Nhanh chóng tóm tắt văn bản, dịch thuật, hoặc phân tích dữ liệu trong các ô.
  • Tạo Nội dung: Lên ý tưởng, viết nháp văn bản quảng cáo, tiêu đề, hoặc mô tả sản phẩm dựa trên dữ liệu có sẵn.
  • Hỗ trợ Cá nhân: Tự động hóa các tác vụ lặp lại yêu cầu xử lý ngôn ngữ.
  • Truy cập Trực tiếp: Không cần chuyển đổi giữa các ứng dụng, mọi thứ đều nằm trong bảng tính của bạn.

Chúng ta sẽ sử dụng mô hình Gemini 2.0 Flash – một mô hình nhanh và hiệu quả, lý tưởng cho các ứng dụng đòi hỏi tốc độ phản hồi.

Các Bước Thực Hiện

Bước 1: Lấy Khóa API Gemini của Bạn

Để kết nối với API của Gemini, bạn cần một khóa API.

  1. Truy cập https://aistudio.google.com/app/apikey.
  2. Đăng nhập bằng tài khoản Google của bạn.
  3. Tạo một khóa API mới (nếu bạn chưa có). Hãy lưu trữ khóa này ở nơi an toàn.

Bước 2: Mở Trình Soạn Thảo Google Apps Script

Google Apps Script là một nền tảng dựa trên JavaScript cho phép bạn mở rộng chức năng của Google Workspace.

  1. Mở Google Sheet mà bạn muốn thêm hàm ASKGPT.
  2. Trên thanh menu, điều hướng đến Extensions (Tiện ích mở rộng) > Apps Script. Thao tác này sẽ mở một tab hoặc cửa sổ trình soạn thảo mới.

Bước 3: Viết Mã Apps Script cho Hàm ASKGPT

Trong trình soạn thảo Apps Script, bạn sẽ thấy một tệp Code.gs mặc định. Xóa mọi nội dung hiện có và dán đoạn mã sau:

JavaScript

const GEMINI_API_KEY = "YOUR_API_KEY"; // THAY THẾ BẰNG KHÓA API CỦA BẠN TẠI ĐÂY!

/**
 * Gửi truy vấn đến API Gemini (sử dụng Gemini 2.0 Flash) và trả về câu trả lời.
 * @param {string} prompt Câu hỏi hoặc yêu cầu gửi đến Gemini.
 * @return {string} Câu trả lời từ Gemini.
 * @customfunction
 */
function ASKGPT(prompt) {
  if (!prompt) {
    throw new Error("Vui lòng cung cấp một câu hỏi hoặc yêu cầu.");
  }

  // Kiểm tra nếu khóa API chưa được thay thế
  if (GEMINI_API_KEY === "YOUR_API_KEY" || !GEMINI_API_KEY) {
    throw new Error("Vui lòng thay thế YOUR_API_KEY bằng khóa API Gemini thực của bạn.");
  }

  // Định nghĩa URL API cho Gemini 2.0 Flash
  const url = `https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${GEMINI_API_KEY}`;
  
  const headers = {
    'Content-Type': 'application/json'
  };
  const payload = JSON.stringify({
    contents: [{
      parts: [{
        text: prompt
      }]
    }]
  });

  const options = {
    method: 'post',
    headers: headers,
    payload: payload,
    muteHttpExceptions: true // Giúp bắt lỗi từ phản hồi API tốt hơn
  };

  try {
    const response = UrlFetchApp.fetch(url, options);
    const jsonResponse = JSON.parse(response.getContentText());

    // Xử lý phản hồi từ Gemini
    if (jsonResponse.candidates && jsonResponse.candidates.length > 0) {
      const firstCandidate = jsonResponse.candidates[0];
      if (firstCandidate.content && firstCandidate.content.parts && firstCandidate.content.parts.length > 0) {
        return firstCandidate.content.parts[0].text;
      }
    } else if (jsonResponse.error) {
      return `Lỗi API: ${jsonResponse.error.message}`;
    }
    return "Không thể nhận được câu trả lời từ Gemini. Vui lòng thử lại.";

  } catch (e) {
    return `Có lỗi xảy ra: ${e.message}`;
  }
}

Quan trọng: Thay thế "YOUR_API_KEY" bằng khóa API Gemini mà bạn đã lấy ở Bước 1.

Bước 4: Lưu và Cấp Quyền cho Dự án Apps Script

  1. Trong trình soạn thảo Apps Script, nhấp vào biểu tượng Save project (biểu tượng đĩa mềm) trên thanh công cụ.
  2. Lần đầu tiên bạn sử dụng hàm ASKGPT trong Google Sheet, bạn sẽ được yêu cầu cấp quyền.
    • Một hộp thoại ủy quyền sẽ bật lên. Nhấp vào Review permissions (Xem lại quyền).
    • Chọn tài khoản Google của bạn.
    • Nhấp vào Allow (Cho phép) để cấp cho dự án quyền cần thiết (chủ yếu là quyền kết nối với dịch vụ bên ngoài).

Bước 5: Sử dụng Hàm ASKGPT trong Google Sheets

Bây giờ, hàm ASKGPT đã sẵn sàng để sử dụng như bất kỳ hàm nào khác trong Google Sheet của bạn.

  • Để hỏi một câu trực tiếp:Excel=ASKGPT("Hãy viết một câu khẩu hiệu ngắn gọn cho một quán cà phê mới.")
  • Để tham chiếu đến một ô chứa câu hỏi: Nếu ô A1 chứa câu hỏi “Thủ đô của Việt Nam là gì?”, bạn có thể sử dụng:Excel=ASKGPT(A1)
  • Để kết hợp với các hàm khác hoặc dữ liệu từ các ô:Excel=ASKGPT("Tóm tắt nội dung sau đây: " & B2 & " " & C2)

Một Vài Lưu Ý Cuối Cùng

  • Chi phí API: Gemini API có một tầng miễn phí, nhưng hãy luôn kiểm tra https://ai.google.dev/pricing để hiểu rõ về các giới hạn và chi phí nếu bạn có ý định sử dụng nhiều.
  • Giới hạn truy vấn: API có thể có giới hạn về số lượng yêu cầu hoặc độ dài của văn bản gửi đi/nhận về.
  • Bảo mật: Đừng chia sẻ bảng tính chứa khóa API của bạn cho những người bạn không tin tưởng, vì họ có thể truy cập khóa API thông qua Apps Script.

Với hàm ASKGPT tùy chỉnh này, Google Sheets của bạn giờ đây không chỉ là một công cụ tính toán mà còn là một trợ lý AI mạnh mẽ, giúp bạn làm việc hiệu quả và sáng tạo hơn. Hãy thử nghiệm và khám phá những khả năng mà nó mang lại nhé!