สร้างแอป Google Chat ด้วย Agent AI ของ ADK

หน้านี้อธิบายวิธีสร้างส่วนเสริมของ Google Workspace ที่ทำงานใน Google Chat และเชื่อมต่อกับ AI Agent ของ Agent Development Kit (ADK) ที่โฮสต์ ใน Vertex AI Agent Engine

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

ตัวอย่าง Multi-Agent ของ LLM Auditor เป็นแอป Chat

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

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

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

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

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

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

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

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

เปิดใช้ Google Cloud APIs

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

  • ในคอนโซล Google Cloud ให้เปิดใช้ Google Chat, Vertex AI และ Cloud Resource Manager APIs

    เปิดใช้ 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

สร้างบัญชีบริการใหม่ที่มีบทบาท Vertex AI 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

ติดตั้งใช้งาน AI Agent ของ ADK

  1. เปิดตัวอย่าง LLM Auditor ใน Vertex AI Agent Garden โดยทำดังนี้

    เปิดตัวอย่าง

  2. คลิกทำให้ใช้งานได้

  3. หากระบบขอ ให้เลือกโปรเจ็กต์ Google Cloud

  4. คลิกทำให้ใช้งานได้ใน Cloud Shell

  5. หากระบบขอ ให้คลิกให้สิทธิ์ แล้วทำตามขั้นตอน OAuth สำหรับ Cloud Shell

  6. เมื่อ Cloud Shell โหลดเสร็จสมบูรณ์ ให้กด Enter เพื่อเรียกใช้บรรทัดคำสั่งที่โหลดไว้ล่วงหน้าและเริ่มการติดตั้งใช้งาน

  7. หากระบบขอให้ป้อนภูมิภาค ให้กด Enter เพื่อใช้ค่าเริ่มต้น

  8. เมื่อเสร็จแล้ว ให้ไปที่ Vertex AI Agent Engine โดยทำดังนี้

    เปิด Vertex AI Agent Engine

  9. คลิก ไอคอนสำหรับการทำสำเนา เพื่อคัดลอกชื่อทรัพยากรของ Agent ที่ติดตั้งใช้งานใหม่จากตาราง

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

  1. คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ Apps Script ของการเริ่มต้นใช้งานอย่างรวดเร็วของ AI Agent ของ ADK

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

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

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

    1. REASONING_ENGINE_RESOURCE_NAME พร้อมชื่อทรัพยากรของ Vertex AI Agent ที่คัดลอกไว้ในขั้นตอนก่อนหน้า
    2. SERVICE_ACCOUNT_KEY พร้อมคีย์ JSON จากบัญชีบริการที่ดาวน์โหลดไว้ในขั้นตอนก่อนหน้า เช่น { ... }

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

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

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

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

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

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

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

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

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

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

ทดสอบแอป Chat

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

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

    ไปที่ Google Chat

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

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

  5. ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์ The Eiffel Tower was completed in 1900 แล้วกด enter

    แอป Chat จะตอบกลับด้วยการตอบกลับของ Agent ย่อย Critic และ Reviser

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

แก้ปัญหา

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

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

ล้างข้อมูล

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

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

    ไปที่ Resource Manager

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