หน้านี้อธิบายวิธีสร้างแอป HTTP Chat ซึ่งสถาปัตยกรรมนี้ทำได้หลายวิธี ใน Google Cloud คุณจะใช้ Cloud Functions, Cloud Run และ App Engine ได้ ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะเขียนและทำให้ Cloud Function ที่แอป Chat ใช้ตอบข้อความของผู้ใช้ได้
สถาปัตยกรรมนี้จะช่วยให้คุณกำหนดค่า Chat ให้ผสานรวมกับ Google Cloud หรือเซิร์ฟเวอร์ภายในองค์กรโดยใช้ HTTP ดังที่แสดงในแผนภาพต่อไปนี้
ในแผนภาพก่อนหน้านี้ ผู้ใช้ที่โต้ตอบกับแอป Chat แบบ HTTP มีโฟลว์ข้อมูลดังต่อไปนี้
- ผู้ใช้ส่งข้อความใน Chat ไปยังแอป Chat ไม่ว่าจะเป็นข้อความส่วนตัวหรือในพื้นที่ใน Chat
- ระบบจะส่งคำขอ HTTP ไปยังเว็บเซิร์ฟเวอร์ที่เป็นระบบคลาวด์หรือภายในองค์กรที่มีตรรกะของแอป Chat
- ตรรกะของแอป Chat อาจผสานรวมกับ บริการของ Google Workspace (เช่น ปฏิทินและชีต), บริการอื่นๆ ของ Google (เช่น Maps, YouTube และ Vertex AI) หรือบริการบนเว็บอื่นๆ (เช่น ระบบการจัดการโปรเจ็กต์หรือเครื่องมือจำหน่ายตั๋ว) ได้
- เว็บเซิร์ฟเวอร์จะส่งการตอบกลับ HTTP กลับไปยังบริการแอป Chat ใน Chat
- ระบบจะส่งคำตอบให้กับผู้ใช้
- นอกจากนี้ แอป Chat ยังเรียกใช้ Chat API เพื่อโพสต์ข้อความแบบไม่พร้อมกันหรือดำเนินการอื่นๆ ได้อีกด้วย
สถาปัตยกรรมนี้ให้ความยืดหยุ่นในการใช้ไลบรารีและคอมโพเนนต์ที่มีอยู่แล้วในระบบของคุณ เนื่องจากแอป Chat เหล่านี้สามารถออกแบบโดยใช้ภาษาโปรแกรมที่แตกต่างกันได้
วัตถุประสงค์
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างและทำให้ Cloud Function ใช้งานได้
- เผยแพร่แอปไปยัง Chat
- ทดสอบแอป
สิ่งที่ต้องดำเนินการก่อน
- บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat และ Google Cloud Functions
- โปรเจ็กต์ Google Cloud
- ตรวจสอบว่าคุณเปิดการเรียกเก็บเงินสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์แล้ว ดูวิธียืนยันสถานะการเรียกเก็บเงินของโปรเจ็กต์
ตั้งค่าสภาพแวดล้อม
ก่อนใช้ Google APIs คุณต้องเปิดใช้ API เหล่านี้ในโปรเจ็กต์ Google Cloud คุณสามารถเปิด API ได้ตั้งแต่ 1 รายการขึ้นไปในโปรเจ็กต์ Google Cloud เดียวในคอนโซล Google Cloud ให้เปิดใช้ Google Chat API, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API และ Cloud Run API
สร้างและทำให้ Cloud Function ใช้งานได้
สร้าง Cloud Function แล้วทำให้ใช้งานได้ ซึ่งสร้างการ์ด Chat ด้วยชื่อที่แสดงและรูปโปรไฟล์ของผู้ส่ง เมื่อแอป Chat ได้รับข้อความ แอปจะเรียกใช้ฟังก์ชันดังกล่าวและตอบกลับด้วยการ์ด
หากต้องการสร้างและทำให้ฟังก์ชันใช้งานได้สำหรับแอป Chat โปรดทำตามขั้นตอนต่อไปนี้
Node.js
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าได้เลือกโปรเจ็กต์สำหรับแอป Chat ของคุณแล้ว
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ใน Runtime ให้เลือก Node.js เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
helloChat
แทนที่เนื้อหาของ
index.js
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
Python
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าได้เลือกโปรเจ็กต์สำหรับแอป Chat ของคุณแล้ว
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ในรันไทม์ ให้เลือก Python เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
hello_chat
แทนที่เนื้อหาของ
main.py
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
Java
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้
ตรวจสอบว่าได้เลือกโปรเจ็กต์สำหรับแอป Chat ของคุณแล้ว
คลิก
สร้างฟังก์ชันในหน้าสร้างฟังก์ชัน ให้ตั้งค่าฟังก์ชันต่อไปนี้
- ในสภาพแวดล้อม ให้เลือกรุ่นที่ 2
- ป้อน
QuickStartChatApp
ในชื่อฟังก์ชัน - ในภูมิภาค ให้เลือกภูมิภาค
- เลือกต้องมีการตรวจสอบสิทธิ์ในส่วนการตรวจสอบสิทธิ์
- คลิกถัดไป
ใน Runtime ให้เลือก Java เวอร์ชันล่าสุด
ในซอร์สโค้ด ให้เลือกตัวแก้ไขในบรรทัด
ใน Entry Point ให้ลบข้อความเริ่มต้นและป้อน
HelloChat
เปลี่ยนชื่อ
src/main/java/com/example/Example.java
เป็นsrc/main/java/HelloChat.java
แทนที่เนื้อหาของ
HelloChat.java
ด้วยรหัสต่อไปนี้แทนที่เนื้อหาของ
pom.xml
ด้วยรหัสต่อไปนี้คลิกทำให้ใช้งานได้
หน้ารายละเอียด Cloud Functions จะเปิดขึ้น และฟังก์ชันจะปรากฏขึ้นพร้อมตัวบ่งชี้ความคืบหน้า 2 รายการ โดยตัวหนึ่งสำหรับบิลด์และอีกตัวหนึ่งสำหรับบริการ เมื่อตัวบ่งชี้ความคืบหน้าทั้ง 2 รายการหายไปและแทนที่ด้วยเครื่องหมายถูก แสดงว่าฟังก์ชันใช้งานได้และพร้อมใช้งาน
ให้สิทธิ์ Google Chat เพื่อเรียกใช้ฟังก์ชัน
หากต้องการให้สิทธิ์ Google Chat เพื่อเรียกใช้ฟังก์ชัน ให้เพิ่มบัญชีบริการ Google Chat ที่มีบทบาทผู้เรียกใช้ Cloud Run
ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Run แล้วดำเนินการดังนี้
ในรายการบริการ Cloud Run ให้เลือกช่องทำเครื่องหมายข้างฟังก์ชันการรับ (อย่าคลิกที่ฟังก์ชัน)
คลิกสิทธิ์ แผงสิทธิ์จะเปิดขึ้น
คลิกเพิ่มผู้ใช้หลัก
ในผู้ใช้หลักใหม่ ให้ป้อน
chat@system.gserviceaccount.com
ในส่วนเลือกบทบาท ให้เลือก Cloud Run > ผู้เรียกใช้ Cloud Run
คลิกบันทึก
เผยแพร่แอปไปยัง Google Chat
หลังจากทำให้ Cloud Function ใช้งานได้แล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อเปลี่ยนให้เป็นแอป Google Chat
ในคอนโซล Google Cloud ให้คลิกเมนู > Cloud Functions
ตรวจสอบว่าได้เลือกโปรเจ็กต์ที่คุณเปิดใช้ Cloud Functions ไว้
ในรายการฟังก์ชัน ให้คลิก QuickStartChatApp
คลิกแท็บทริกเกอร์
คัดลอก URL ในส่วน HTTPS
ค้นหา "Google Chat API" แล้วคลิก Google Chat API จากนั้นคลิกจัดการ
คลิกการกำหนดค่าและตั้งค่าแอป Google Chat ดังนี้
- ป้อน
Quickstart App
ในชื่อแอป - ใน URL รูปโปรไฟล์ ให้ป้อน
https://developers.google.com/chat/images/quickstart-app-avatar.png
- ในคำอธิบาย ให้ป้อน
Quickstart app
- ในส่วนฟังก์ชัน ให้เลือกรับข้อความแบบ 1:1 และเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
- ในส่วนการตั้งค่าการเชื่อมต่อ ให้เลือก URL ของแอป แล้ววาง URL สำหรับทริกเกอร์ Cloud Function ลงในช่อง
- เลือก URL ของแอปในกลุ่มเป้าหมายการตรวจสอบสิทธิ์
- ในส่วนระดับการเข้าถึง ให้เลือกทำให้แอป Google Chat นี้พร้อมใช้งานสำหรับบางคนและบางกลุ่มในโดเมน แล้วป้อนอีเมลของคุณ
- เลือกบันทึกข้อผิดพลาดในการบันทึกในส่วนบันทึก
- ป้อน
คลิกบันทึก
แอป Chat พร้อมที่จะรับและตอบกลับข้อความบน Chat แล้ว
ทดสอบแอปใน Chat
หากต้องการทดสอบแอป Chat ให้เปิดพื้นที่ทำงานในข้อความส่วนตัวด้วยแอป Chat แล้วส่งข้อความโดยทำดังนี้
เปิด Google Chat โดยใช้บัญชี Google Workspace ที่คุณให้ไว้เมื่อเพิ่มตัวคุณเองเป็นผู้ทดสอบที่เชื่อถือได้
- คลิก แชทใหม่
- ในช่องเพิ่มผู้คนอย่างน้อย 1 คน ให้พิมพ์ชื่อแอป ของคุณ
เลือกแอปใน Chat จากผลการค้นหา ข้อความส่วนตัวจะเปิดขึ้น
- ในข้อความส่วนตัวใหม่ที่มีแอป ให้พิมพ์
Hello
แล้วกดenter
การตอบกลับของแอป Chat จะมีข้อความในการ์ดที่แสดงชื่อและรูปโปรไฟล์ของผู้ส่ง ดังที่แสดงในรูปภาพต่อไปนี้
หากต้องการเพิ่มผู้ทดสอบที่เชื่อถือได้และดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟ โปรดดูที่หัวข้อทดสอบฟีเจอร์แบบอินเทอร์แอกทีฟสำหรับแอป Google Chat
แก้ปัญหา
เมื่อแอปหรือการ์ด Google Chat แสดงข้อผิดพลาด อินเทอร์เฟซ Chat จะแสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณ" บางครั้ง UI ของ Chat ไม่แสดงข้อความแสดงข้อผิดพลาด แต่แอปหรือการ์ด Chat ให้ผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจไม่ปรากฏขึ้น
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของ Chat แต่ก็ยังมีข้อความแสดงข้อผิดพลาดและข้อมูลบันทึกที่สื่อความหมายเพื่อช่วยให้คุณแก้ไขข้อผิดพลาดเมื่อมีการเปิดใช้การบันทึกข้อผิดพลาดสำหรับแอป Chat ได้ หากต้องการความช่วยเหลือในการดู แก้ไขข้อบกพร่อง และแก้ไขข้อผิดพลาด โปรดดูหัวข้อแก้ปัญหาและแก้ไขข้อผิดพลาดของ Google Chat
ล้างข้อมูล
เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินกับบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้
- ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิกลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเครื่องเพื่อลบโปรเจ็กต์
หัวข้อที่เกี่ยวข้อง
หากต้องการเพิ่มฟีเจอร์เพิ่มเติมในแอป Chat โปรดดูข้อมูลต่อไปนี้