การเริ่มต้นอย่างรวดเร็ว: สร้างข้อความโดยใช้ Vertex AI

หน้านี้อธิบายวิธีใช้บริการขั้นสูงของ Vertex AI ใน Apps Script เพื่อแจ้งโมเดล Gemini 2.5 Flash ให้สร้างข้อความ

ดูข้อมูลเพิ่มเติมเกี่ยวกับบริการขั้นสูงของ Vertex AI ได้ที่เอกสารอ้างอิง

ข้อความที่ AI สร้างขึ้นจากบริการขั้นสูงของ Vertex AI ใน Apps Script
รูปที่ 1 การตอบกลับของบริการ Vertex AI ใน บันทึกการดำเนินการของ Apps Script

วัตถุประสงค์

  • ตั้งค่าสภาพแวดล้อม
  • สร้างโปรเจ็กต์ Apps Script ที่ใช้บริการขั้นสูงของ Vertex AI
  • เรียกใช้สคริปต์เพื่อสร้างข้อความ

ข้อกำหนดเบื้องต้น

ตั้งค่าสภาพแวดล้อม

ส่วนนี้อธิบายวิธีกำหนดค่าและตั้งค่าสภาพแวดล้อมใน Google Cloud Console และ Apps Script

เปิดใช้ Vertex AI API ในโปรเจ็กต์ Cloud

  1. ใน Google Cloud Console ให้เปิดโปรเจ็กต์ Google Cloud แล้วเปิดใช้ Vertex AI API โดยทำดังนี้

    เปิดใช้ API

  2. ยืนยันว่าคุณเปิดใช้ API ในโปรเจ็กต์ Cloud ที่ถูกต้อง แล้วคลิกถัดไป

  3. ยืนยันว่าคุณเปิดใช้ API ที่ถูกต้อง แล้วคลิกเปิดใช้

สร้างและตั้งค่าโปรเจ็กต์ Apps Script

หากต้องการสร้างและตั้งค่าโปรเจ็กต์ Apps Script ให้ทำตาม ขั้นตอนต่อไปนี้

  1. ไปที่ script.google.com
  2. คลิกโปรเจ็กต์ใหม่เพื่อสร้างโปรเจ็กต์ Apps Script
  3. คลิกโปรเจ็กต์ที่ไม่มีชื่อที่ด้านซ้ายบน
  4. ตั้งชื่อสคริปต์ว่า Vertex AI quickstart แล้วคลิกเปลี่ยนชื่อ

ตั้งค่าบริการขั้นสูงของ Vertex AI

หากต้องการเปิดใช้บริการขั้นสูงของ Vertex AI และตั้งค่าโค้ด ให้ทำดังนี้

  1. ในโปรแกรมแก้ไขสคริปต์ ให้ไปที่บริการ แล้วคลิกเพิ่มบริการ ไอคอนสำหรับเพิ่มบริการ
  2. ในเมนูแบบเลื่อนลง ให้เลือก Vertex AI API แล้วคลิกเพิ่ม

  3. เปิดไฟล์ Code.gs แล้วแทนที่เนื้อหาด้วยโค้ดต่อไปนี้ 

    /**
 * 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.';
}

    แทนที่ GOOGLE_CLOUD_PROJECT_ID ด้วย รหัสโปรเจ็กต์ ของโปรเจ็กต์ Cloud

  4. คลิกบันทึก ไอคอนบันทึก

ทดสอบสคริปต์

  1. ในเครื่องมือแก้ไขสคริปต์ ให้คลิกเรียกใช้เพื่อเรียกใช้ฟังก์ชัน main
  2. ให้สิทธิ์สคริปต์เมื่อได้รับข้อความแจ้ง
  3. คลิกบันทึกการดำเนินการเพื่อดูคำตอบจาก Vertex AI

Vertex AI จะแสดงคำตอบสำหรับคำถาม What is Apps Script in one sentence? ตัวอย่างเช่น บันทึกการดำเนินการจะแสดงผล การตอบกลับดังต่อไปนี้

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.

ล้างข้อมูล

เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินจากบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้

  1. ใน Google Cloud Console ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร

    ไปที่เครื่องมือจัดการทรัพยากร

  2. ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
  3. ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์ แล้วคลิกปิดเพื่อลบ โปรเจ็กต์

เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อเลี่ยงไม่ให้เกิดการเรียกเก็บเงินกับบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในการเริ่มต้นอย่างรวดเร็วนี้