สร้างแอป Google Chat ด้วยเอเจนต์ AI ของ Gemini Enterprise

หน้านี้อธิบายวิธีสร้างส่วนเสริมของ Google Workspace ที่ทำงานใน Google Chat และเชื่อมต่อกับ AI Agent ของ Gemini Enterprise

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

เอเจนต์สร้างไอเดียเป็นแอป Chat

แผนภาพต่อไปนี้แสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ

สถาปัตยกรรมของแอปแชทที่ใช้งานด้วย AI Agent ของ Gemini Enterprise

ในแผนภาพก่อนหน้า ผู้ใช้ที่โต้ตอบกับแอป Chat ซึ่งใช้ AI Agent ของ Gemini Enterprise จะมีขั้นตอนการรับส่งข้อมูลดังนี้

  1. ผู้ใช้ส่งข้อความไปยังแอป Chat ไม่ว่าจะเป็นในข้อความส่วนตัวหรือในพื้นที่ทำงานใน Chat
  2. ตรรกะของแอป Chat ที่ใช้ใน Apps Script หรือเป็นเว็บเซิร์ฟเวอร์ที่มีปลายทาง HTTP จะรับและประมวลผลข้อความ
  3. AI Agent ของ Gemini Enterprise จะรับและประมวลผลการโต้ตอบ
  4. แอป Chat หรือ AI Agent สามารถผสานรวมกับบริการของ Google Workspace เช่น ปฏิทินหรือชีต หรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube ได้โดยไม่บังคับ
  5. แอป Chat จะส่งคำตอบแบบไม่พร้อมกันโดยใช้ Google Chat API เพื่อสื่อสารความคืบหน้าของ AI Agent
  6. ระบบจะส่งคำตอบไปยังผู้ใช้

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

  • ตั้งค่าสภาพแวดล้อม
  • ติดตั้งใช้งานแอป Chat
  • กำหนดค่าแอป Chat
  • ทดสอบแอป Chat

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

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

เปิด Chat API

ก่อนใช้ Google API คุณต้องเปิด API เหล่านั้นในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้

เปิดใช้ Google Chat API ในคอนโซล Google Cloud

เปิดใช้ API

กำหนดค่าหน้าจอขอคำยินยอม OAuth

แอปทั้งหมดที่ใช้ OAuth 2.0 ต้องมีการกำหนดค่าหน้าจอขอคำยินยอม การกำหนดค่าหน้าจอขอคำยินยอม OAuth ของแอปจะกำหนดสิ่งที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป รวมถึงลงทะเบียนแอปเพื่อให้คุณเผยแพร่ได้ในภายหลัง

  1. ในคอนโซล Google API ให้ไปที่เมนู > แพลตฟอร์มการตรวจสอบสิทธิ์ของ Google > การสร้างแบรนด์

    ไปที่การสร้างแบรนด์

  2. หากกำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google ไว้แล้ว คุณสามารถกำหนดค่าการตั้งค่าหน้าจอขอคำยินยอม OAuth ต่อไปนี้ใน การสร้างแบรนด์, กลุ่มเป้าหมาย และ การเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่า Google Auth platform not configured yet ให้คลิก Get Started ดังนี้
    1. ในส่วนข้อมูลแอป ให้ป้อนชื่อแอปในชื่อแอป
    2. ในส่วนอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลสนับสนุนที่ผู้ใช้สามารถติดต่อคุณได้หากมีคำถามเกี่ยวกับความยินยอม
    3. คลิกถัดไป
    4. ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน
    5. คลิกถัดไป
    6. ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมล ที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
    7. คลิกถัดไป
    8. ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้สำหรับบริการ Google API และหากยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
    9. คลิกต่อไป
    10. คลิกสร้าง
  3. ตอนนี้คุณสามารถข้ามการเพิ่มขอบเขตได้ ในอนาคต เมื่อสร้างแอปเพื่อใช้ภายนอกองค์กร Google Workspace คุณต้องเปลี่ยนประเภทผู้ใช้ เป็นภายนอก จากนั้น เพิ่มขอบเขตการให้สิทธิ์ที่แอปต้องใช้ ดูข้อมูลเพิ่มเติมได้ในคู่มือฉบับเต็มเกี่ยวกับ การกำหนดค่าหน้าจอขอคำยินยอม OAuth

สร้างบัญชีบริการในคอนโซล Google Cloud

สร้างบัญชีบริการใหม่ที่มีบทบาท Discovery Engine User โดยทำตามขั้นตอนต่อไปนี้

Google Cloud Console

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ

    ไปที่บัญชีบริการ

    ขั้นตอนที่เหลือจะปรากฏในคอนโซล Google Cloud

  2. เลือกโปรเจ็กต์ Google Cloud
  3. คลิกสร้างบัญชีบริการ
  4. ป้อนชื่อบัญชีบริการที่จะแสดงในคอนโซล Google Cloud
  5. หากไม่ต้องการตั้งค่าการควบคุมการเข้าถึงในตอนนี้ ให้คลิกเสร็จสิ้น เพื่อสร้างบัญชีบริการให้เสร็จสมบูรณ์ หากต้องการตั้งค่าการควบคุมการเข้าถึงในตอนนี้ ให้คลิกสร้างและดำเนินการต่อ แล้วไปที่ขั้นตอนถัดไป
  6. ไม่บังคับ: กำหนดบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud นอกเหนือจากทรัพยากร Google Workspace ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อจัดการการเข้าถึงโปรเจ็กต์ โฟลเดอร์ และองค์กร
  7. คลิกต่อไป
  8. ไม่บังคับ: ป้อนผู้ใช้หรือกลุ่มที่สามารถจัดการและดำเนินการกับบัญชีบริการนี้ได้ ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อการจำลองตัวตนของบัญชีบริการ
  9. คลิกเสร็จสิ้น เพื่อสร้างบัญชีบริการให้เสร็จสมบูรณ์

    จดอีเมลของบัญชีบริการไว้

gcloud CLI

  1. สร้างบัญชีบริการโดยใช้คำสั่งต่อไปนี้ 
    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --display-name="SERVICE_ACCOUNT_NAME"
  2. ไม่บังคับ: กำหนดบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud นอกเหนือจากทรัพยากร Google Workspace ดูรายละเอียดเพิ่มเติมได้ที่หัวข้อจัดการการเข้าถึงโปรเจ็กต์ โฟลเดอร์ และองค์กร

บัญชีบริการจะปรากฏในหน้าบัญชีบริการ

สร้างคีย์ส่วนตัว

หากต้องการสร้างและดาวน์โหลดคีย์ส่วนตัวสำหรับบัญชีบริการ ให้ทำตามขั้นตอนต่อไปนี้

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ

    ไปที่บัญชีบริการ

    ขั้นตอนที่เหลือจะปรากฏในคอนโซล Google Cloud

  2. เลือกโปรเจ็กต์ Google Cloud
  3. คลิกอีเมลของบัญชีบริการที่ต้องการสร้างคีย์
  4. คลิกแท็บคีย์
  5. คลิกเมนูแบบเลื่อนลงเพิ่มคีย์ แล้วเลือกสร้างคีย์ใหม่
  6. เลือก JSON เป็นประเภทคีย์ แล้วคลิกสร้าง

    ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงใน เครื่องของคุณเป็นไฟล์คีย์บัญชีบริการ บันทึกไฟล์ JSON ที่ดาวน์โหลดเป็น credentials.json ในไดเรกทอรีงาน ไฟล์นี้เป็นสำเนาเพียงรายการเดียวของคีย์นี้ หลังจากดาวน์โหลดไฟล์คีย์แล้ว คุณจะดาวน์โหลดอีกครั้งไม่ได้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บ คีย์อย่างปลอดภัยได้ที่ แนวทางปฏิบัติแนะนำสำหรับการจัดการคีย์บัญชีบริการ

ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีบริการได้ที่ หัวข้อบัญชีบริการในเอกสารประกอบของ Google Cloud IAM

สร้างและกำหนดค่าโปรเจ็กต์แอป Chat

  1. ในคอนโซล Google API ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > การตั้งค่า

    ไปที่การตั้งค่า IAM และผู้ดูแลระบบ

  2. จดค่าในช่องหมายเลขโปรเจ็กต์ และรหัสโปรเจ็กต์

  3. ไปที่ Gemini Enterprise โดยทำดังนี้

    เปิด Gemini Enterprise

  4. จดตำแหน่ง และรหัส ของแอปพลิเคชัน

  5. คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ Apps Script GE AI Agent Quickstart

    เปิดโปรเจ็กต์

  6. คลิก ภาพรวม > ไอคอนสำหรับการทำสำเนา ทำสำเนา

  7. ในโปรเจ็กต์ Apps Script คลิก ไอคอนสำหรับการตั้งค่าโปรเจ็กต์ การตั้งค่าโปรเจ็กต์ > แก้ไขพร็อพเพอร์ตี้ของสคริปต์ > เพิ่มพร็อพเพอร์ตี้ของสคริปต์ เพื่อเพิ่มพร็อพเพอร์ตี้ของสคริปต์ต่อไปนี้

    1. REASONING_ENGINE_RESOURCE_NAME ที่มีทรัพยากรแอป Gemini Enterprise ซึ่งประกอบด้วยข้อมูลที่จดไว้ในขั้นตอนก่อนหน้า

      projects/PROJECT_ID/locations/APP_LOCATION/collections/default_collection/engines/APP_ID

    2. SERVICE_ACCOUNT_KEY ที่มีคีย์ JSON จากบัญชีบริการที่ดาวน์โหลดในขั้นตอนก่อนหน้า เช่น { ... }

  8. คลิกบันทึกพร็อพเพอร์ตี้ของสคริปต์

  9. ในโปรเจ็กต์ Apps Script คลิก ไอคอนสำหรับการตั้งค่าโปรเจ็กต์ การตั้งค่าโปรเจ็กต์

  10. ในส่วนโปรเจ็กต์ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโปรเจ็กต์

  11. ในส่วนหมายเลขโปรเจ็กต์ GCP ให้วางหมายเลขโปรเจ็กต์ Google Cloud ที่จดไว้ใน ขั้นตอนก่อนหน้า

  12. คลิกตั้งค่าโปรเจ็กต์ ตอนนี้โปรเจ็กต์ระบบคลาวด์และโปรเจ็กต์ Apps Script เชื่อมต่อกันแล้ว

สร้างการทำให้ใช้งานได้สำหรับการทดสอบ

คุณต้องมีรหัสการทำให้ใช้งานได้สำหรับโปรเจ็กต์ Apps Script นี้ เพื่อให้ใช้รหัสดังกล่าวในขั้นตอนถัดไปได้

หากต้องการรับรหัสการทำให้ใช้งานได้หลัก ให้ทำดังนี้

  1. ในโปรเจ็กต์ Apps Script ของแอป Chat คลิก ทำให้ใช้งานได้ > การทำให้ใช้งานได้สำหรับการทดสอบ
  2. ในส่วนรหัสการทำให้ใช้งานได้หลัก ให้คลิก ไอคอนสำหรับการทำสำเนา คัดลอก
  3. คลิกเสร็จสิ้น

กำหนดค่าแอป Chat

ใช้การทำให้ใช้งานได้ของ Apps Script แล้วทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งใช้งานแอป Google Chat สำหรับการทดสอบ

  1. ใน คอนโซล API ให้ค้นหา Google Chat API แล้วคลิก Google Chat API
  2. คลิกจัดการ

  3. คลิกการกำหนดค่า แล้วตั้งค่าแอป Chat ดังนี้

    1. ป้อน GE Quickstart ในช่องชื่อแอป
    2. ป้อน https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png ในช่องURL รูปโปรไฟล์
    3. ป้อน GE Quickstart ในช่องคำอธิบาย
    4. ในส่วนฟังก์ชันการทำงาน ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
    5. ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโปรเจ็กต์ Apps Script
    6. วางรหัสการทำให้ใช้งานได้หลักที่คัดลอกไว้ก่อนหน้านี้ในช่องรหัสการทำให้ใช้งานได้
    7. ในส่วนการมองเห็น ให้เลือกบุคคลและกลุ่มเฉพาะใน โดเมน แล้วป้อนอีเมลของคุณ

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

แอป Chat พร้อมตอบกลับข้อความแล้ว

ทดสอบแอป Chat

หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ทำงานสำหรับข้อความส่วนตัวกับแอป Chat แล้วส่งข้อความโดยทำดังนี้

  1. เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณ ระบุไว้เมื่อเพิ่มตัวเองเป็นผู้ทดสอบที่เชื่อถือได้

    ไปที่ Google Chat

  2. คลิก แชทใหม่.
  3. พิมพ์ชื่อแอป Chat ในช่องเพิ่มบุคคลอย่างน้อย 1 คน

  4. เลือกแอป Chat จากผลการค้นหา ข้อความส่วนตัว จะเปิดขึ้น

  5. ในข้อความส่วนตัวใหม่กับแอป ให้พิมพ์ I need to find ideas! แล้วกดenter

    แอป Chat จะตอบกลับด้วยคำตอบของ Agent การสร้างไอเดียเริ่มต้น

หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบโต้ตอบ โปรดดู ทดสอบฟีเจอร์แบบโต้ตอบสำหรับ แอป Google Chat

แก้ปัญหา

เมื่อแอปหรือ การ์ด Google Chat แสดงข้อผิดพลาด อินเทอร์เฟซของ Chat จะแสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ดำเนินการตามคำขอของคุณไม่ได้" บางครั้ง UI ของ Chat จะไม่แสดงข้อความแสดงข้อผิดพลาด แต่แอปหรือ การ์ด Chat จะแสดงผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความการ์ดอาจไม่ ปรากฏขึ้น

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

ล้างข้อมูล

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

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

    ไปที่ Resource Manager

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