หน้านี้อธิบายวิธีการสร้างส่วนเสริม Google Workspace ที่ใช้งานได้ใน Google Chat และเชื่อมต่อกับเอเจนต์ AI ที่ใช้โปรโตคอล Agent2Agent (A2A) คุณพัฒนาเอเจนต์โดยใช้ Agent Development Kit (ADK) และโฮสต์เอเจนต์นั้นใน Vertex AI Agent Engine
ตัวแทน AI สามารถรับรู้สภาพแวดล้อม คิดวิเคราะห์ และดำเนินการตามขั้นตอนที่ซับซ้อนได้อย่างอิสระ เพื่อบรรลุเป้าหมายที่กำหนดไว้ ในบทช่วยสอนนี้ คุณจะใช้งานตัวอย่างเอเจนต์หลายตัว LLM Auditor ที่วิเคราะห์และแก้ไขข้อเท็จจริงโดยใช้ Gemini และ Google Search เป็นพื้นฐาน

แผนภาพต่อไปนี้แสดงสถาปัตยกรรมและรูปแบบการส่งข้อความ:
ในแผนภาพ ผู้ใช้ที่โต้ตอบกับแอปแชทซึ่งทำงานร่วมกับเอเจนต์ A2A จะมีการไหลของข้อมูลดังต่อไปนี้:
- ผู้ใช้ส่งข้อความไปยังแอปแชท ไม่ว่าจะเป็นข้อความส่วนตัวหรือในพื้นที่แชท
- ตรรกะของแอปแชท ซึ่งเขียนด้วย Apps Script หรือเป็นเว็บเซิร์ฟเวอร์ที่มีเอนด์พอยต์ HTTP จะรับและประมวลผลข้อความ
- เอเจนต์ A2A ที่โฮสต์อยู่บน Vertex AI Agent Engine จะรับและประมวลผลการโต้ตอบ
- นอกจากนี้ แอปแชทหรือตัวแทน AI สามารถผสานรวมกับบริการ Google Workspace เช่น ปฏิทินหรือสเปรดชีต หรือบริการ Google อื่นๆ เช่น Google Maps หรือ YouTube ได้อีกด้วย
- แอปแชทจะส่งการตอบกลับแบบอะซิงโครนัส โดยใช้ Google Chat API ในการสื่อสารความคืบหน้าของตัวแทน AI
- ระบบจะส่งคำตอบไปยังผู้ใช้
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อม
- ติดตั้งเอเจนต์ A2A
- ติดตั้งแอปพลิเคชันแชท
- ตั้งค่าแอปแชท
- ทดสอบแอปแชท
ข้อกำหนดเบื้องต้น
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
- โปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน หากต้องการตรวจสอบว่าโครงการที่มีอยู่เปิดใช้งานการเรียกเก็บเงินหรือไม่ โปรดดูที่ ตรวจสอบสถานะการเรียกเก็บเงินของโครงการของคุณ ในการสร้างโปรเจ็กต์และตั้งค่าการเรียกเก็บเงิน โปรดดูที่ สร้างโปรเจ็กต์ Google Cloud
- ข้อกำหนดเบื้องต้นของตัวแทน LLM Auditor ADK
- Python 3.11 ขึ้นไป: สำหรับการติดตั้ง ให้ทำตามคำแนะนำบนเว็บไซต์อย่างเป็นทางการของ Python Python
- Python Poetry: สำหรับการติดตั้ง โปรดทำตามคำแนะนำบนเว็บไซต์อย่างเป็นทางการของ Poetry
- Google Cloud CLI: สำหรับการติดตั้ง โปรดทำตามคำแนะนำบนเว็บไซต์อย่างเป็นทางการของ Google Cloud
ตั้งค่าสภาพแวดล้อม
เปิดใช้งาน Google Cloud API
ก่อนใช้งาน Google API คุณต้องเปิดใช้งานในโปรเจ็กต์ Google Cloud ก่อน คุณสามารถเปิดใช้งาน API อย่างน้อยหนึ่งรายการในโปรเจ็กต์ Google Cloud เดียวได้ในคอนโซล Google Cloud ให้เปิดใช้งาน API ของ Google Chat, Vertex AI และ Cloud Resource Manager
กำหนดค่าหน้าจอขอความยินยอม OAuth
แอปพลิเคชันทั้งหมดที่ใช้ OAuth 2.0 จำเป็นต้องกำหนดค่าหน้าจอขอความยินยอม การกำหนดค่าหน้าจอขอความยินยอม OAuth ของแอปของคุณจะกำหนดสิ่งที่จะแสดงให้ผู้ใช้และผู้ตรวจสอบแอปเห็น และลงทะเบียนแอปของคุณเพื่อให้คุณสามารถเผยแพร่ได้ในภายหลัง
- ในคอนโซล Google Cloud ให้ไปที่เมนู > Google Auth platform > การสร้างแบรนด์.
- หากคุณได้กำหนดค่า Google Auth platformไว้แล้ว คุณสามารถกำหนดค่าการตั้งค่าหน้าจอยินยอม OAuth ต่อไปนี้ได้ใน การสร้างแบรนด์, กลุ่มเป้าหมาย และ การเข้าถึงข้อมูล หากคุณเห็นข้อความที่ระบุว่า Google Auth platform ยังไม่ได้กำหนดค่า ให้คลิก เริ่มต้นใช้งาน:
- ภายใต้ ข้อมูลแอป ในช่อง ชื่อแอป ให้ป้อนชื่อสำหรับแอป
- ในอีเมลสนับสนุนสำหรับผู้ใช้ ให้เลือกอีเมลสนับสนุนที่ผู้ใช้สามารถติดต่อคุณได้หากมีข้อสงสัยเกี่ยวกับการยินยอม
- คลิกถัดไป
- ในส่วนผู้ชม ให้เลือกภายใน
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่านนโยบายข้อมูลผู้ใช้ของบริการ Google API และหากยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- ในตอนนี้ คุณข้ามการเพิ่มขอบเขตได้ ในอนาคต เมื่อสร้างแอปเพื่อใช้ภายนอกองค์กร Google Workspace คุณจะต้องเปลี่ยนประเภทผู้ใช้เป็นภายนอก จากนั้น เพิ่มขอบเขตการให้สิทธิ์ที่แอปของคุณต้องการ ดูข้อมูลเพิ่มเติมได้ที่คู่มือกำหนดค่าความยินยอม OAuth ฉบับเต็ม
สร้างบัญชีบริการในคอนโซล Google Cloud
สร้างบัญชีบริการใหม่ที่มีบทบาท Vertex AI User โดยทำตาม
ขั้นตอนต่อไปนี้
คอนโซล Google Cloud
- ใน Google Cloud Console ให้ไปที่เมนู > IAM & Admin > บัญชีบริการ
- คลิกสร้างบัญชีบริการ
- กรอกรายละเอียดบัญชีบริการ แล้วคลิกสร้างและดำเนินการต่อ
- ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ 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
ติดตั้งใช้งานเอเจนต์ A2A
หากยังไม่ได้ดำเนินการ ให้ตรวจสอบสิทธิ์ด้วยบัญชี 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
ดาวน์โหลดที่เก็บ GitHub ของตัวอย่าง ADK โดยใช้ปุ่มนี้
ในสภาพแวดล้อมการพัฒนาในเครื่องที่ต้องการ ให้แตกไฟล์ที่ดาวน์โหลดมา และเปิดไดเรกทอรี
adk-samples/python/agents/llm-auditorunzip adk-samples-main.zipcd adk-samples-main/python/agents/llm-auditorอัปเดตการติดตั้งใช้งานเพื่อติดตั้งใช้งานเอเจนต์ ADK เป็นเอเจนต์ระยะไกล A2A โดยทำดังนี้
pyproject.toml: เพิ่มทรัพยากร Dependency ของ ADK และ A2A SDK ในกลุ่มการติดตั้งใช้งาน
deployment/deploy.py: แทนที่การปรับใช้แอป ADK ด้วยเอเจนต์และการ์ด A2A
สร้างบัคเก็ต Cloud Storage ใหม่สำหรับเอเจนต์ ADK โดยเฉพาะ
gcloud storage buckets create gs://CLOUD_STORAGE_BUCKET_NAME --project=PROJECT_ID --location=PROJECT_LOCATIONแทนที่ค่าต่อไปนี้
- CLOUD_STORAGE_BUCKET_NAME พร้อมชื่อถังที่ไม่ซ้ำกันที่คุณต้องการใช้
- PROJECT_ID พร้อมด้วย ID ของโปรเจ็กต์ Cloud ของคุณ
- PROJECT_LOCATION พร้อมตำแหน่งที่ตั้งของโปรเจ็กต์ Cloud ของคุณ
ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้
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 พร้อมด้วย ID ของโปรเจ็กต์ Cloud ของคุณ
- PROJECT_LOCATION พร้อมตำแหน่งที่ตั้งของโปรเจ็กต์ Cloud ของคุณ
ติดตั้งและใช้งานเอเจนต์ ADK จากสภาพแวดล้อมเสมือน
python3 -m venv myenvsource myenv/bin/activatepoetry install --with deploymentpython3 deployment/deploy.py --createดึงข้อมูลรหัสตัวแทน (Agent ID) คุณจะต้องใช้มันในภายหลัง เมื่อคุณตั้งค่าแอปแชท
python3 deployment/deploy.py --list
สร้างและกำหนดค่าโปรเจ็กต์แอปแชท
คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ Apps Script ของ A2A AI Agent Quickstart
คลิก ภาพรวม >
ทำสำเนา.
ในโปรเจ็กต์ 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 ดังนี้
- ป้อน
A2A Quickstartในช่องชื่อแอป - ในช่อง URL อวตาร ให้ป้อน
https://developers.google.com/workspace/add-ons/images/quickstart-app-avatar.png - ในช่องคำอธิบาย ให้ป้อน
A2A Quickstart - ในส่วนฟังก์ชันการทำงาน ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
- ภายใต้การตั้งค่าการเชื่อมต่อ ให้เลือก Apps Script project
- ในช่อง Deployment ID ให้วาง Head deployment ID ที่คุณคัดลอกไว้ก่อนหน้านี้
- ภายใต้หัวข้อการมองเห็น ให้เลือก บุคคลและกลุ่มเฉพาะในโดเมนของคุณ แล้วป้อนอีเมลของคุณ
- ป้อน
คลิกบันทึก
แอปแชทพร้อมตอบข้อความแล้ว
ทดสอบแอปแชท
เพื่อทดสอบแอปแชทของคุณ ให้เปิดพื้นที่ข้อความส่วนตัวด้วยแอปแชทแล้วส่งข้อความ:
เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณระบุไว้เมื่อเพิ่มตัวเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- ในช่อง เพิ่มบุคคล 1 คนขึ้นไป ให้พิมพ์ชื่อแอปแชทของคุณ
เลือกแอปแชทของคุณจากผลลัพธ์ ระบบจะเปิดข้อความส่วนตัวขึ้นมา
ในการส่งข้อความโดยตรงครั้งใหม่ผ่านแอป ให้พิมพ์
The Eiffel Tower was completed in 1900แล้วกดenterแอปแชทจะตอบกลับด้วยข้อความตอบกลับย่อยของ Critic และ Reviser
หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และเรียนรู้เพิ่มเติมเกี่ยวกับการทดสอบคุณสมบัติแบบโต้ตอบ โปรดดูที่ ทดสอบคุณสมบัติแบบโต้ตอบสำหรับแอป Google Chat
แก้ปัญหา
เมื่อแอป Google Chat หรือ card ส่งคืนข้อผิดพลาด อินเทอร์เฟซแชทจะแสดงข้อความว่า "เกิดข้อผิดพลาดบางอย่าง" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณได้" บางครั้ง UI ของแอปแชทอาจไม่แสดงข้อความแสดงข้อผิดพลาดใดๆ แต่แอปแชทหรือการ์ดอาจแสดงผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจไม่ปรากฏขึ้น
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่ปรากฏในส่วนติดต่อผู้ใช้แชท แต่จะมีข้อความแสดงข้อผิดพลาดโดยละเอียดและข้อมูลบันทึกเพื่อช่วยคุณแก้ไขข้อผิดพลาดเมื่อเปิดใช้งานการบันทึกข้อผิดพลาดสำหรับแอปแชท หากต้องการความช่วยเหลือในการดู แก้ไขข้อบกพร่อง และแก้ไขข้อผิดพลาด โปรดดูที่ แก้ไขปัญหาและแก้ไขข้อผิดพลาดของ Google Chat
ล้างข้อมูล
เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินจากบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้
- ใน Google Cloud Console ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์ แล้วคลิกปิดเพื่อลบ โปรเจ็กต์
หัวข้อที่เกี่ยวข้อง
- สร้างแอป Google Chat ด้วยเอเจนต์ AI ของ ADK
- สร้างแอป Google Chat ด้วยเอเจนต์ Agent2UI
- ตรวจสอบข้อเท็จจริงด้วยเอเจนต์ ADK AI และโมเดล Gemini
- วางแผนการเดินทางด้วยเอเจนต์ AI ที่เข้าถึงได้ใน Google Workspace
- บูรณาการแนวคิด AI พื้นฐานในแอปแชท
- ตอบคำถามจากบทสนทนาในแอปแชท Gemini AI
- ตอบสนองต่อเหตุการณ์ต่างๆ ด้วย Google Chat, Vertex AI, Apps Script และการตรวจสอบสิทธิ์ผู้ใช้
- จัดการโปรเจ็กต์ด้วย Google Chat, Vertex AI และ Firestore