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

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

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

ตัวอย่าง LLM Auditor แบบหลายเอเจนต์เป็นแอป Chat

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

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

ในแผนภาพก่อนหน้า ผู้ใช้ที่โต้ตอบกับ แอป Chat ที่ใช้เอเจนต์ AI ของ ADK จะมี ขั้นตอนการไหลของข้อมูลดังนี้

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

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

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

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

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

เปิดใช้ Google Cloud APIs

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

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

    เปิดใช้ API

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

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

  1. ในคอนโซล Google Cloud ให้ไปที่เมนู > Google Auth platform > การสร้างแบรนด์

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

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

  1. ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > บัญชีบริการ

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

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

gcloud CLI

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

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

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

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

  1. ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > บัญชีบริการ

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

  2. เลือกบัญชีบริการ
  3. คลิกคีย์ > เพิ่มคีย์ > สร้างคีย์ใหม่
  4. เลือก JSON แล้วคลิกสร้าง

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

  5. คลิกปิด

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

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

  1. เปิดตัวอย่างโปรแกรมตรวจสอบ LLM ใน Agent Garden ของ Vertex AI โดยทำดังนี้

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

  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 ของการเริ่มต้นใช้งาน ADK AI Agent อย่างรวดเร็ว

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

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

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

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

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

  5. ใน Google Cloud Console ให้ไปที่เมนู > 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. ในคอนโซล ให้ค้นหา 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. ในช่องรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของ 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

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

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

แก้ปัญหา

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

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

ล้างข้อมูล

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

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

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

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