หน้านี้อธิบายวิธีการสร้างส่วนเสริม Google Workspace ที่ใช้งานได้ใน Google Chat และเชื่อมต่อกับเอเจนต์ AI ที่ใช้โปรโตคอล Agent2UI (A2UI) คุณพัฒนาเอเจนต์โดยใช้ Agent Development Kit (ADK) และโฮสต์เอเจนต์นั้นใน Vertex AI Agent Engine
ตัวแทน AI สามารถรับรู้สภาพแวดล้อม คิดวิเคราะห์ และดำเนินการตามขั้นตอนที่ซับซ้อนได้อย่างอิสระ เพื่อบรรลุเป้าหมายที่กำหนดไว้ ในบทช่วยสอนนี้ คุณจะทำการติดตั้งใช้งานเอเจนต์ AI พื้นฐานที่ส่งคืนข้อมูลโปรไฟล์แบบคงที่ซึ่งดึงมาจากเครื่องมือ
A2UI ช่วยให้เอเจนต์ AI สามารถสร้าง UI ที่ปรับเปลี่ยนได้ มีฟังก์ชันการทำงานที่หลากหลาย และโต้ตอบได้ ซึ่งแสดงผลได้อย่างเป็นธรรมชาติ จากนั้นคุณก็สามารถมุ่งเน้นไปที่ตรรกะการทำงานของเอージェนต์ AI แทนที่จะเป็นส่วนติดต่อผู้ใช้
-
รูปที่ 1. เอเจนต์ A2UI ตอบกลับผู้ใช้ด้วยข้อความและการ์ดที่มีชื่อ รูปภาพ และปุ่ม LinkedIn -
รูปที่ 2. เอเจนต์ A2UI ได้รับการอัปเดตให้ส่งคืนชื่อโปรไฟล์ด้วยเช่นกัน -
รูปที่ 3 เอเจนต์ A2UI จะตอบกลับผู้ใช้ด้วยข้อความที่แสดงชื่อโปรไฟล์ในการ์ด
แผนภาพต่อไปนี้แสดงสถาปัตยกรรมและรูปแบบการรับส่งข้อความ

ในแผนภาพ ผู้ใช้ที่โต้ตอบกับแอปแชทที่ติดตั้งใช้งานด้วยเอเจนต์ A2UI จะมีโฟลว์ข้อมูลดังนี้
- ผู้ใช้ส่งข้อความไปยังแอป Chat ไม่ว่าจะใน ข้อความส่วนตัวหรือในพื้นที่ใน Chat
- ตรรกะของแอป Chat ที่ใช้งานใน Apps Script หรือเป็นเว็บเซิร์ฟเวอร์ที่มีปลายทาง HTTP จะรับและประมวลผลข้อความ
- เอเจนต์ A2UI ที่โฮสต์ด้วย Vertex AI Agent Engine จะรับและประมวลผล การโต้ตอบ
- ไม่บังคับ: แอป Chat หรือเอเจนต์ AI สามารถผสานรวมกับบริการของ Google Workspace เช่น ปฏิทินหรือชีต หรือบริการอื่นๆ ของ Google เช่น Google Maps หรือ YouTube
- แอป Chat จะสร้างและส่งการตอบกลับแบบปรับเปลี่ยนได้ แบบไม่พร้อมกัน โดยใช้ Google Chat API เพื่อสื่อสารความคืบหน้าของเอเจนต์ AI
- ระบบจะส่งคำตอบให้ผู้ใช้
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อม
- ติดตั้งใช้งานเอเจนต์ A2UI
- ติดตั้งใช้งานแอป Chat
- กำหนดค่าแอป Chat
- ทดสอบแอป Chat
ข้อกำหนดเบื้องต้น
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
- โปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน หากต้องการตรวจสอบว่าโปรเจ็กต์ที่มีอยู่เปิดใช้การเรียกเก็บเงินแล้วหรือไม่ โปรดดูยืนยันสถานะการเรียกเก็บเงินของโปรเจ็กต์ หากต้องการสร้างโปรเจ็กต์และตั้งค่าการเรียกเก็บเงิน โปรดดูสร้างโปรเจ็กต์ Google Cloud
- Python 3.11 ขึ้นไป: โปรดทำตามวิธีการติดตั้งในเว็บไซต์ทางการของ Python
- Python Poetry: หากต้องการติดตั้ง ให้ทำตามวิธีการในเว็บไซต์ Poetry อย่างเป็นทางการ
- Google Cloud CLI: หากต้องการติดตั้ง ให้ทำตามวิธีการในเว็บไซต์ Google Cloud อย่างเป็นทางการ
ตั้งค่าสภาพแวดล้อม
เปิดใช้ Google Cloud APIs
ก่อนใช้ Google API คุณต้องเปิดใช้ API ในโปรเจ็กต์ Google Cloud คุณเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้ใน Google Cloud Console ให้เปิดใช้ Google Chat, Vertex AI และ Cloud Resource Manager API
กำหนดค่าหน้าจอขอความยินยอม OAuth
แอปทั้งหมดที่ใช้ OAuth 2.0 ต้องมีการกำหนดค่าหน้าจอขอความยินยอม การกำหนดค่าหน้าจอขอความยินยอม OAuth ของแอปจะกำหนดสิ่งที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป รวมถึงลงทะเบียนแอปเพื่อให้คุณเผยแพร่ได้ในภายหลัง
- ในคอนโซล Google Cloud ให้ไปที่เมนู > Google Auth platform > การสร้างแบรนด์
- หากกำหนดค่า Google Auth platformแล้ว คุณจะกำหนดค่าการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่าGoogle Auth platform ยังไม่ได้กำหนดค่า ให้คลิกเริ่มต้นใช้งาน
- ในส่วนข้อมูลแอป ให้ป้อนชื่อแอปในชื่อแอป
- ในอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลสนับสนุนที่ผู้ใช้สามารถติดต่อคุณได้หากมีข้อสงสัยเกี่ยวกับการยินยอม
- คลิกถัดไป
- ในส่วนผู้ชม ให้เลือกภายใน
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้ของบริการ Google API และหากยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- ในตอนนี้ คุณสามารถข้ามขั้นตอนการเพิ่มขอบเขตไปก่อนได้ ในอนาคต เมื่อคุณสร้างแอปเพื่อใช้งานภายนอกองค์กร Google Workspace ของคุณ คุณจะต้องเปลี่ยนประเภทผู้ใช้ User type เป็น External จากนั้นเพิ่มขอบเขตการอนุญาตที่แอปของคุณต้องการ หากต้องการเรียนรู้เพิ่มเติม โปรดดูคู่มือฉบับเต็ม กำหนดค่าการยินยอม OAuth
สร้างบัญชีบริการใน Google Cloud Console
สร้างบัญชีบริการใหม่ที่มีบทบาท Vertex AI User โดยทำตามขั้นตอนต่อไปนี้:
คอนโซล Google Cloud
- ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ.
- คลิกสร้างบัญชีบริการ
- กรอกรายละเอียดบัญชีบริการ จากนั้นคลิก สร้างและดำเนินการต่อ
- (ไม่บังคับ): กำหนดบทบาทให้กับบัญชีบริการของคุณเพื่ออนุญาตการเข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ของคุณ สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ การให้สิทธิ์ การเปลี่ยนแปลง และการเพิกถอนสิทธิ์การเข้าถึงทรัพยากร
- คลิกต่อไป
- ไม่บังคับ: ป้อนผู้ใช้หรือกลุ่มที่จัดการและดำเนินการกับบัญชีบริการนี้ได้ โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อการจัดการการแอบอ้างเป็นบัญชีบริการ
- คลิกเสร็จสิ้น จดอีเมลของบัญชีบริการไว้
gcloud CLI
- สร้างบัญชีบริการโดยทำดังนี้
gcloud iam service-accounts createSERVICE_ACCOUNT_NAME\ --display-name="SERVICE_ACCOUNT_NAME" - ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ดูรายละเอียดเพิ่มเติมได้ที่การให้ เปลี่ยน และเพิกถอนสิทธิ์เข้าถึงทรัพยากร
บัญชีบริการจะปรากฏในหน้าบัญชีบริการ
สร้างคีย์ส่วนตัว
หากต้องการสร้างและดาวน์โหลดคีย์ส่วนตัวสำหรับบัญชีบริการ ให้ทำตามขั้นตอนต่อไปนี้
- ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > บัญชีบริการ
- เลือกบัญชีบริการ
- คลิกคีย์ > เพิ่มคีย์ > สร้างคีย์ใหม่
- เลือก JSON แล้วคลิกสร้าง
ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงในเครื่องของคุณเป็นไฟล์ใหม่ บันทึกไฟล์ JSON ที่ดาวน์โหลดเป็น
credentials.jsonใน ไดเรกทอรีการทำงาน ไฟล์นี้เป็นสำเนาเดียวของคีย์นี้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บคีย์อย่างปลอดภัยได้ที่การจัดการคีย์ของบัญชีบริการ - คลิกปิด
ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีบริการได้ที่บัญชีบริการในเอกสารประกอบของ Google Cloud IAM
ติดตั้งใช้งานเอเจนต์ A2UI
หากยังไม่ได้ดำเนินการ ให้ตรวจสอบสิทธิ์ด้วยบัญชี Google Cloud และ กำหนดค่า Google Cloud CLI ให้ใช้โปรเจ็กต์ Google Cloud
gcloud auth application-default logingcloud config set project PROJECT_IDgcloud auth application-default set-quota-project PROJECT_IDแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Cloud
ดาวน์โหลด
googleworkspace/add-ons-samplesที่เก็บ GitHub โดยใช้ปุ่มนี้ในสภาพแวดล้อมการพัฒนาในเครื่องที่ต้องการ ให้แตกไฟล์เก็บถาวรที่ดาวน์โหลดมาแล้วเปิดไดเรกทอรี
add-ons-samples/apps-script/chat/a2ui-ai-agent/a2uiunzip add-ons-samples-main.zipcd add-ons-samples/apps-script/chat/a2ui-ai-agent/a2uiสร้างที่เก็บข้อมูล Cloud Storage ใหม่สำหรับตัวแทน ADK โดยเฉพาะ
gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATIONแทนที่ค่าต่อไปนี้
- CLOUD_STORAGE_BUCKET_NAME โดยใช้ชื่อที่เก็บข้อมูลที่ไม่ซ้ำกันที่คุณต้องการใช้
- PROJECT_ID ด้วยรหัสโปรเจ็กต์ Cloud
- PROJECT_LOCATION ที่มีตำแหน่งของโปรเจ็กต์ในระบบคลาวด์
ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
export GOOGLE_GENAI_USE_VERTEXAI=trueexport GOOGLE_CLOUD_PROJECT=PROJECT_IDexport GOOGLE_CLOUD_LOCATION=PROJECT_LOCATIONexport GOOGLE_CLOUD_STORAGE_BUCKET=CLOUD_STORAGE_BUCKET_NAMEแทนที่ค่าต่อไปนี้
- CLOUD_STORAGE_BUCKET_NAME โดยใช้ชื่อที่เก็บข้อมูลที่คุณ สร้างขึ้น
- PROJECT_ID ด้วยรหัสโปรเจ็กต์ Cloud
- PROJECT_LOCATION ที่มีตำแหน่งของโปรเจ็กต์ Cloud
ติดตั้งและติดตั้งใช้งาน Agent ของ ADK จากสภาพแวดล้อมเสมือน
python3 -m venv myenvsource myenv/bin/activatepoetry install --with deploymentpython3 deployment/deploy.py --createดึงข้อมูลรหัสตัวแทน คุณจะต้องใช้รหัสนี้ในภายหลังเมื่อกำหนดค่า แอป Chat
python3 deployment/deploy.py --list
สร้างและกำหนดค่าโปรเจ็กต์แอป Chat
คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ Apps Script ของการเริ่มต้นใช้งานอย่างรวดเร็วของเอเจนต์ AI ใน A2UI
คลิก ภาพรวม >
ทำสำเนา
ในโปรเจ็กต์ Apps Script ให้คลิก
การตั้งค่าโปรเจ็กต์ > แก้ไขพร็อพเพอร์ตี้สคริปต์ > เพิ่มพร็อพเพอร์ตี้สคริปต์ เพื่อเพิ่มพร็อพเพอร์ตี้สคริปต์ต่อไปนี้
REASONING_ENGINE_RESOURCE_NAMEโดยใช้ชื่อทรัพยากรของเอเจนต์ Vertex AI ที่คัดลอกไว้ในขั้นตอนก่อนหน้าSERVICE_ACCOUNT_KEYโดยใช้คีย์ JSON จากบัญชีบริการ ที่ดาวน์โหลดในขั้นตอนก่อนหน้า เช่น{ ... }
คลิกบันทึกพร็อพเพอร์ตี้ของสคริปต์
ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > การตั้งค่า
คัดลอกค่าในช่องหมายเลขโปรเจ็กต์
ในโปรเจ็กต์ Apps Script ให้ คลิก
การตั้งค่าโปรเจ็กต์
ในส่วนโปรเจ็กต์ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโปรเจ็กต์
ในหมายเลขโปรเจ็กต์ GCP ให้วางหมายเลขโปรเจ็กต์ Google Cloud ที่คัดลอกไว้ใน ขั้นตอนก่อนหน้า
คลิกตั้งค่าโปรเจ็กต์ ตอนนี้โปรเจ็กต์ระบบคลาวด์และโปรเจ็กต์ Apps Script เชื่อมต่อกันแล้ว
สร้างการทำให้ใช้งานได้สำหรับการทดสอบ
คุณต้องมีรหัสการทําให้ใช้งานได้สําหรับโปรเจ็กต์ Apps Script นี้ เพื่อให้คุณใช้รหัสดังกล่าวในขั้นตอนถัดไปได้
หากต้องการรับรหัสการทำให้ใช้งานได้ล่าสุด ให้ทำดังนี้
- ในโปรเจ็กต์ Apps Script ของแอป Chat ให้ คลิกทําให้ใช้งานได้ > ทดสอบการทําให้ใช้งานได้
- ในส่วนรหัสการทำให้ใช้งานได้ของเวอร์ชันล่าสุด ให้คลิก
คัดลอก
- คลิกเสร็จสิ้น
กำหนดค่าแอป Chat
ใช้การติดตั้งใช้งาน Apps Script แล้วทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งใช้งาน แอป Google Chat สำหรับการทดสอบ
- ในคอนโซล
ให้ค้นหา
Google Chat APIแล้วคลิก Google Chat API - คลิกจัดการ
คลิกการกำหนดค่า แล้วตั้งค่าแอป Chat ดังนี้
- ป้อน
A2UI Quickstartในช่องชื่อแอป - ในช่อง URL อวตาร ให้ป้อน
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png - ในช่องคำอธิบาย ให้ป้อน
A2UI Quickstart - ในส่วนฟังก์ชันการทำงาน ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
- ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือกโปรเจ็กต์ Apps Script
- ในช่องรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของ Head ที่คุณ คัดลอกไว้ก่อนหน้านี้
- ในส่วนระดับการแชร์ ให้เลือกบุคคลและกลุ่มที่เฉพาะเจาะจงในโดเมน แล้วป้อนอีเมล
- ป้อน
คลิกบันทึก
แอป Chat พร้อมตอบกลับข้อความแล้ว
ทดสอบแอป Chat
หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ข้อความส่วนตัวด้วย แอป Chat แล้วส่งข้อความโดยทำดังนี้
เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณ ระบุเมื่อเพิ่มตัวเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- ในช่องเพิ่มบุคคลอย่างน้อย 1 คน ให้พิมพ์ชื่อแอป Chat
เลือกแอป Chat จากผลการค้นหา ข้อความส่วนตัวจะเปิดขึ้น
ในข้อความส่วนตัวใหม่กับแอป ให้พิมพ์
Hello!แล้วกดenterแอปแชทจะตอบกลับข้อความพร้อมข้อความทักทาย และการ์ดที่มีชื่อโปรไฟล์ รูปภาพ และปุ่ม LinkedIn
อัปเดตการติดตั้งใช้งานเอเจนต์ A2UI เพื่อเริ่มแสดงชื่อโปรไฟล์ด้วย
ในสภาพแวดล้อมการพัฒนาในเครื่อง ให้เปิดไฟล์
a2ui/agent.pyและยกเลิกการแสดงความคิดเห็นในบรรทัดในเครื่องมือที่เพิ่มชื่อไปยังข้อมูลที่ส่งคืนอัปเดต ADK ที่ติดตั้งใช้งานก่อนหน้านี้ด้วยการติดตั้งใช้งานเวอร์ชันใหม่
python3 deployment/deploy.py --update --resource_id=RESOURCE_IDแทนที่ RESOURCE_ID ด้วยชื่อทรัพยากรของเอเจนต์ Vertex AI ที่คัดลอกไว้ในขั้นตอนก่อนหน้า
พิมพ์
Hello again!ในข้อความส่วนตัวที่มีแอป แล้วกดenterแอป Chat จะตอบกลับข้อความด้วยข้อความบางส่วนและ การ์ดที่มีชื่อโปรไฟล์
หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดูทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับ แอป Google Chat
แก้ปัญหา
เมื่อแอป Google Chat หรือการ์ดแสดงข้อผิดพลาด อินเทอร์เฟซของ Chat จะแสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ดำเนินการตามคำขอของคุณไม่ได้" บางครั้ง UI ของ Chat จะไม่แสดงข้อความแสดงข้อผิดพลาดใดๆ แต่แอปหรือการ์ด Chat จะแสดงผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจไม่ปรากฏ
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของ Chat แต่ข้อความแสดงข้อผิดพลาดและข้อมูลบันทึกที่อธิบายไว้จะช่วยคุณแก้ไขข้อผิดพลาดได้เมื่อเปิดการบันทึกข้อผิดพลาดสำหรับแอป Chat หากต้องการความช่วยเหลือในการดู การแก้ไขข้อบกพร่อง และการแก้ไขข้อผิดพลาด โปรดดู แก้ปัญหาและแก้ไขข้อผิดพลาดของ Google Chat
ล้างข้อมูล
เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินจากบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้
- ใน Google Cloud Console ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์ แล้วคลิกปิดเพื่อลบ โปรเจ็กต์
หัวข้อที่เกี่ยวข้อง
- สร้างแอป Google Chat ด้วยเอเจนต์ AI ของ ADK
- สร้างแอป Google Chat ด้วย Agent แบบ A2A
- ตรวจสอบข้อเท็จจริงของคำกล่าวด้วยเอเจนต์ AI ของ ADK และโมเดล Gemini
- วางแผนการเดินทางด้วยเอเจนต์ AI ที่เข้าถึงได้ใน Google Workspace
- ผสานรวมแนวคิดพื้นฐานของ AI ในแอปใน Chat
- ตอบคำถามตามการสนทนาในแชทด้วยแอป Gemini AI Chat
- ตอบสนองต่อเหตุการณ์ด้วย Google Chat, Vertex AI, Apps Script และการตรวจสอบสิทธิ์ผู้ใช้
- จัดการโปรเจ็กต์ด้วย Google Chat, Vertex AI และ Firestore