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

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

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

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

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

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

ในแผนภาพก่อนหน้า ผู้ใช้ที่โต้ตอบกับแอป Chat ที่ติดตั้งใช้งานด้วยเอเจนต์ AI ของ 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 API คุณต้องเปิดใช้ API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google คุณเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้

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

    เปิดใช้ API

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

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

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

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

  2. หากกำหนดค่าแพลตฟอร์มการตรวจสอบสิทธิ์ของ Google แล้ว คุณจะกำหนดค่าการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่ายังไม่ได้กำหนดค่าแพลตฟอร์ม Google Auth ให้คลิกเริ่มต้นใช้งาน
    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. คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ ADK AI Agent Quickstart Apps Script

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

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

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

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

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

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

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

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

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

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

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

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

    แอปแชทจะตอบกลับด้วยคำตอบของ Agent ย่อย Critic และ Reviser

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

แก้ปัญหา

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

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

ล้างข้อมูล

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

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

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

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