บทแนะนำนี้จะแสดงวิธีสร้างแอป Google Chat ที่ ตอบสนองต่อเหตุการณ์แบบเรียลไทม์ เมื่อตอบสนองต่อเหตุการณ์ แอปจะสร้างและป้อนข้อมูลในพื้นที่ทำงานของ Chat, ช่วยให้การแก้ไขเหตุการณ์เป็นไปได้ด้วยข้อความ, คำสั่ง Slash และกล่องโต้ตอบ รวมถึงใช้ AI เพื่อสรุปการตอบสนองต่อเหตุการณ์ในเอกสาร Google เอกสาร
บทแนะนำนี้ใช้ขอบเขตการให้สิทธิ์ที่ขึ้นต้นด้วย
https://www.googleapis.com/auth/chat.app.*
ซึ่งพร้อมใช้งานเป็นส่วนหนึ่งของ
Developer Preview แอป Chat ของคุณต้องได้รับการอนุมัติจากผู้ดูแลระบบแบบครั้งเดียว
เหตุการณ์คือเหตุการณ์ที่ต้องให้ความสนใจโดยด่วนจากทีม บุคคลเพื่อแก้ไข ตัวอย่างเหตุการณ์มีดังนี้
- มีการสร้างเคสที่ต้องดำเนินการอย่างเร่งด่วนในแพลตฟอร์มการจัดการลูกค้าสัมพันธ์ (CRM) ซึ่งกำหนดให้ทีมบริการต้องทำงานร่วมกันเพื่อแก้ไข
- ระบบออฟไลน์ ทำให้มีการแจ้งเตือนกลุ่มวิศวกรความเสถียรสำหรับเว็บไซต์ (SRE) เพื่อให้วิศวกรทำงานร่วมกันเพื่อนำระบบกลับมาออนไลน์
- เกิดแผ่นดินไหวรุนแรง และเจ้าหน้าที่กู้ภัยต้อง ประสานงานการตอบสนอง
สำหรับวัตถุประสงค์ของบทแนะนำนี้ การแจ้งเตือนเหตุการณ์จะเริ่มเมื่อมีผู้รายงานเหตุการณ์ด้วยการคลิกปุ่มจากหน้าเว็บ หน้าเว็บจะจำลอง เหตุการณ์โดยขอให้ผู้ใช้ป้อนข้อมูลเหตุการณ์พื้นฐาน ได้แก่ ชื่อ คำอธิบาย และอีเมลของผู้ตอบ
ดูการทำงานของแอป Chat สำหรับการจัดการเหตุการณ์
-
รูปที่ 1 เว็บไซต์ที่ผู้ใช้รายงานเหตุการณ์ได้ -
รูปที่ 2 การแจ้งเตือนว่ามีการสร้างพื้นที่ใน Chat สำหรับเหตุการณ์ -
รูปที่ 3 พื้นที่ใน Chat สำหรับการตอบสนองต่อเหตุการณ์ -
รูปที่ 4 การแก้ไขเหตุการณ์ด้วยคำสั่งเครื่องหมายทับ -
รูปที่ 5 กล่องโต้ตอบการแก้ไขเหตุการณ์ -
รูปที่ 6 เอกสาร Google เอกสารเกี่ยวกับการแก้ไขเหตุการณ์ที่แชร์ในพื้นที่ทำงาน -
รูปที่ 7 เอกสาร Google เอกสารเกี่ยวกับวิธีแก้ไขเหตุการณ์ที่เกี่ยวข้องกับข้อมูลสรุปโดย AI
ข้อกำหนดเบื้องต้น
หากต้องการเปิดใช้ข้อกำหนดเบื้องต้นเหล่านี้สำหรับองค์กร โปรดขอให้ ผู้ดูแลระบบ Google Workspace เปิดใช้
- บัญชี Google Workspace สำหรับธุรกิจหรือองค์กร ที่มีสิทธิ์เข้าถึง Google Chat
- เปิดใช้ไดเรกทอรี (การแชร์รายชื่อติดต่อ) สำหรับ Google Workspace แอปเหตุการณ์จะใช้ ไดเรกทอรีเพื่อค้นหาข้อมูลติดต่อของผู้ตอบเหตุการณ์ เช่น ชื่อ และอีเมล ผู้ตอบสนองต่อเหตุการณ์ต้องเป็นผู้ใช้ที่มีบัญชี Google Chat ในองค์กร Google Workspace
วัตถุประสงค์
- สร้างแอป Chat ที่ตอบสนองต่อเหตุการณ์
- ช่วยให้ผู้ใช้ตอบสนองต่อเหตุการณ์ได้โดยทำดังนี้
- การสร้างพื้นที่ตอบสนองต่อเหตุการณ์
- โพสต์ข้อความที่สรุปเหตุการณ์และการตอบกลับ
- รองรับการทำงานร่วมกันด้วยฟีเจอร์แอป Chat แบบอินเทอร์แอกทีฟ
- สรุปการสนทนาและการแก้ไขด้วย Vertex AI
สถาปัตยกรรม
แผนภาพต่อไปนี้แสดงสถาปัตยกรรมของ Google Workspace และ ทรัพยากร Google Cloud ที่แอป Google Chat สำหรับการตอบสนองต่อเหตุการณ์ใช้
สถาปัตยกรรมแสดงให้เห็นว่าแอป Google Chat สำหรับการตอบสนองต่อเหตุการณ์ ประมวลผลเหตุการณ์และการแก้ไขอย่างไร
ผู้ใช้เริ่มเหตุการณ์จากเว็บไซต์ภายนอกที่โฮสต์ใน Apps Script
เว็บไซต์จะส่งคำขอ HTTP แบบไม่พร้อมกันไปยังแอป Google Chat ซึ่งโฮสต์อยู่ใน Apps Script ด้วย
แอป Google Chat สำหรับการตอบสนองต่อเหตุการณ์จะประมวลผลคำขอโดยทำดังนี้
บริการ Admin SDK ของ Apps Script จะรับข้อมูลสมาชิกในทีม เช่น รหัสผู้ใช้และอีเมล
เมื่อใช้ชุดคำขอ HTTP ไปยัง Chat API โดยใช้ บริการ Chat ขั้นสูงของ Apps Script แอป Google Chat สำหรับการตอบสนองต่อเหตุการณ์ จะสร้างพื้นที่ทำงานใน Chat สำหรับเหตุการณ์ เพิ่มสมาชิกในทีมลงในพื้นที่ทำงาน และส่งข้อความไปยังพื้นที่ทำงาน
สมาชิกในทีมพูดคุยเกี่ยวกับเหตุการณ์ในพื้นที่ใน Chat
สมาชิกในทีมเรียกใช้คำสั่ง Slash เพื่อส่งสัญญาณการแก้ไขปัญหา
การเรียก HTTP ไปยัง Chat API โดยใช้บริการ Chat ขั้นสูงของ Apps Script จะแสดงข้อความทั้งหมดในพื้นที่ทำงานของ Chat
Vertex AI จะรับข้อความที่แสดงและสร้างข้อมูลสรุป
บริการ
DocumentApp
ของ Apps Script จะสร้างเอกสารใน Docs และเพิ่มข้อมูลสรุปของ Vertex AI ลงในเอกสารแอป Google Chat สำหรับการตอบสนองต่อเหตุการณ์จะเรียกใช้ Chat API เพื่อส่งข้อความที่แชร์ลิงก์ไปยังเอกสารสรุป ในเอกสาร
เตรียมสภาพแวดล้อม
ส่วนนี้แสดงวิธีสร้างและกำหนดค่าโปรเจ็กต์ Google Cloud สำหรับ แอป Chat
สร้างโปรเจ็กต์ Google Cloud
คอนโซล Google Cloud
- ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > สร้างโปรเจ็กต์
-
ในช่องชื่อโปรเจ็กต์ ให้ป้อนชื่อที่สื่อความหมายสำหรับโปรเจ็กต์
ไม่บังคับ: หากต้องการแก้ไขรหัสโปรเจ็กต์ ให้คลิกแก้ไข คุณจะเปลี่ยนรหัสโปรเจ็กต์ไม่ได้ หลังจากสร้างโปรเจ็กต์แล้ว ดังนั้นให้เลือกรหัสที่ตรงกับความต้องการตลอดอายุการใช้งานของ โปรเจ็กต์
- ในช่องสถานที่ ให้คลิกเรียกดูเพื่อแสดงสถานที่ที่อาจเป็นไปได้สำหรับ โปรเจ็กต์ จากนั้นคลิกเลือก
- คลิกสร้าง Google Cloud Console จะนำคุณไปยังหน้าแดชบอร์ดและสร้างโปรเจ็กต์ภายในไม่กี่นาที
gcloud CLI
ในสภาพแวดล้อมการพัฒนาอย่างใดอย่างหนึ่งต่อไปนี้ ให้เข้าถึง Google Cloud
CLI (gcloud
)
-
Cloud Shell: หากต้องการใช้เทอร์มินัลออนไลน์ที่มีการตั้งค่า gcloud CLI ไว้แล้ว ให้เปิดใช้งาน Cloud Shell
เปิดใช้งาน Cloud Shell -
เชลล์ในเครื่อง: หากต้องการใช้สภาพแวดล้อมการพัฒนาในเครื่อง ให้
ติดตั้งและ
เริ่มต้น
gcloud CLI
หากต้องการสร้างโปรเจ็กต์ Cloud ให้ใช้คำสั่งgcloud projects create
แทนที่ PROJECT_ID โดยตั้งรหัสสำหรับโปรเจ็กต์ที่ต้องการสร้างgcloud projects create PROJECT_ID
เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ Cloud
คอนโซล Google Cloud
- ในคอนโซล Google Cloud ให้ไปที่การเรียกเก็บเงิน คลิก เมนู > การเรียกเก็บเงิน > โปรเจ็กต์ของฉัน
- ในเลือกองค์กร ให้เลือกองค์กรที่เชื่อมโยงกับ โปรเจ็กต์ Google Cloud
- ในแถวของโปรเจ็กต์ ให้เปิดเมนูการดำเนินการ ( ) คลิกเปลี่ยนการเรียกเก็บเงิน แล้วเลือก บัญชี Cloud Billing
- คลิกตั้งค่าบัญชี
gcloud CLI
- หากต้องการแสดงรายการบัญชีสำหรับการเรียกเก็บเงินที่ใช้ได้ ให้เรียกใช้คำสั่งต่อไปนี้
gcloud billing accounts list
- ลิงก์บัญชีสำหรับการเรียกเก็บเงินกับโปรเจ็กต์ Google Cloud โดยทำดังนี้
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
แทนที่ค่าต่อไปนี้
PROJECT_ID
คือรหัสโปรเจ็กต์ของ โปรเจ็กต์ Cloud ที่คุณต้องการเปิดใช้การเรียกเก็บเงินBILLING_ACCOUNT_ID
คือรหัสบัญชีสำหรับการเรียกเก็บเงินที่จะลิงก์กับ โปรเจ็กต์ Google Cloud
เปิดใช้ API
คอนโซล Google Cloud
ในคอนโซล Google Cloud ให้เปิดใช้ Google Chat API, Google Docs API, Admin SDK API, Google Workspace Marketplace SDK และ Vertex AI API
ยืนยันว่าคุณกำลังเปิดใช้ API ในโปรเจ็กต์ Cloud ที่ถูกต้อง จากนั้นคลิกถัดไป
ยืนยันว่าคุณเปิดใช้ API ที่ถูกต้อง แล้วคลิกเปิดใช้
gcloud CLI
หากจำเป็น ให้ตั้งค่าโปรเจ็กต์ Cloud ปัจจุบันเป็นโปรเจ็กต์ที่คุณสร้างด้วยคำสั่ง
gcloud config set project
gcloud config set project PROJECT_ID
แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ของ โปรเจ็กต์ Cloud ที่คุณสร้าง
เปิดใช้ Google Chat API, Google Docs API, Admin SDK API, Google Workspace Marketplace SDK และ Vertex AI API ด้วยคำสั่ง
gcloud services enable
gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com appsmarket-component.googleapis.com
ตั้งค่าการตรวจสอบสิทธิ์และการให้สิทธิ์
แอปใน Chat จะเข้าถึง Google Chat API โดยใช้ข้อมูลเข้าสู่ระบบของแอปใน Chat แอปจะเข้าถึง Admin SDK API และ Google Docs API ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้
ตั้งค่าการตรวจสอบสิทธิ์และการให้สิทธิ์ของผู้ใช้
การตรวจสอบสิทธิ์และการให้สิทธิ์ช่วยให้แอป Chat เข้าถึงทรัพยากรใน Google Workspace และ Google Cloud เพื่อประมวลผลการตอบสนองต่อเหตุการณ์ได้ โดยเฉพาะอย่างยิ่ง การตรวจสอบสิทธิ์ผู้ใช้จะใช้เพื่อเรียก Google Docs API และ Admin SDK API
ในบทแนะนำนี้ คุณจะเผยแพร่แอปภายในโดเมน Workspace ของคุณ ดังนั้น จึงใช้ข้อมูลตัวยึดตำแหน่งได้ ก่อนเผยแพร่แอปภายนอก ให้แทนที่ข้อมูลตัวยึดตำแหน่งด้วยข้อมูลจริงในหน้าจอขอความยินยอม
ใน Google Cloud Console ให้ไปที่เมนู > > การสร้างแบรนด์
หากกำหนดค่า แล้ว คุณจะกำหนดค่าการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ได้ในการสร้างแบรนด์ กลุ่มเป้าหมาย และการเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่า ยังไม่ได้กำหนดค่า ให้คลิกเริ่มต้นใช้งาน
- ในส่วนข้อมูลแอป ในชื่อแอป ให้พิมพ์
Incident Management
- ในอีเมลสำหรับการสนับสนุนผู้ใช้ ให้เลือกอีเมลหรือ กลุ่ม Google ที่เหมาะสม
- คลิกถัดไป
- เลือกภายในในส่วนผู้ชม หากเลือกภายในไม่ได้ ให้เลือกภายนอก
- คลิกถัดไป
- ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมลที่คุณต้องการ รับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
- คลิกถัดไป
- ในส่วนเสร็จสิ้น ให้อ่าน นโยบายข้อมูลผู้ใช้ของบริการ Google API และหากยอมรับ ให้เลือก ฉันยอมรับบริการ Google API: นโยบายข้อมูลผู้ใช้
- คลิกต่อไป
- คลิกสร้าง
- หากเลือกภายนอกสำหรับประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
- คลิกกลุ่มเป้าหมาย
- ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
- ป้อนอีเมลและผู้ใช้ทดสอบที่ได้รับอนุญาตอื่นๆ แล้วคลิกบันทึก
- ในส่วนข้อมูลแอป ในชื่อแอป ให้พิมพ์
คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับ API แต่ละรายการที่คุณ เปิดใช้ในโปรเจ็กต์ Google Cloud
ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตต่อไปนี้
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
คลิกเพิ่มลงในตาราง
คลิกอัปเดต
หลังจากเลือกขอบเขตที่แอปของคุณต้องการแล้ว ให้คลิกบันทึกในหน้าการเข้าถึงข้อมูล
ตั้งค่าการตรวจสอบสิทธิ์และการให้สิทธิ์แอป
การตรวจสอบสิทธิ์แอปใช้เพื่อเรียก Google Chat API
สร้างบัญชีบริการในคอนโซล Google Cloud
หากต้องการสร้างบัญชีบริการ ให้ทำตามขั้นตอนต่อไปนี้
คอนโซล Google Cloud
- ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ
- คลิกสร้างบัญชีบริการ
- กรอกรายละเอียดบัญชีบริการ แล้วคลิกสร้างและต่อไป
- ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ดูรายละเอียดเพิ่มเติมได้ที่การให้ เปลี่ยน และเพิกถอนสิทธิ์เข้าถึงทรัพยากร
- คลิกต่อไป
- ไม่บังคับ: ป้อนผู้ใช้หรือกลุ่มที่จัดการและดำเนินการกับบัญชีบริการนี้ได้ โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อการจัดการการแอบอ้างเป็นบัญชีบริการ
- คลิกเสร็จสิ้น จดอีเมลของบัญชีบริการไว้
gcloud CLI
- สร้างบัญชีบริการโดยทำดังนี้
gcloud iam service-accounts create
SERVICE_ACCOUNT_NAME
\ --display-name="SERVICE_ACCOUNT_NAME
" - ไม่บังคับ: มอบหมายบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud ดูรายละเอียดเพิ่มเติมได้ที่การให้ เปลี่ยน และเพิกถอนสิทธิ์เข้าถึงทรัพยากร
บัญชีบริการจะปรากฏในหน้าบัญชีบริการ จากนั้นสร้างคีย์ส่วนตัว สำหรับบัญชีบริการ
สร้างคีย์ส่วนตัว
หากต้องการสร้างและดาวน์โหลดคีย์ส่วนตัวสำหรับบัญชีบริการ ให้ทำตามขั้นตอนต่อไปนี้
- ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ
- เลือกบัญชีบริการ
- คลิกคีย์ > เพิ่มคีย์ > สร้างคีย์ใหม่
- เลือก JSON แล้วคลิกสร้าง
ระบบจะสร้างคู่คีย์สาธารณะ/ส่วนตัวใหม่และดาวน์โหลดลงในเครื่องของคุณเป็นไฟล์ใหม่ บันทึกไฟล์ JSON ที่ดาวน์โหลดเป็น
credentials.json
ใน ไดเรกทอรีการทำงาน ไฟล์นี้เป็นสำเนาเดียวของคีย์นี้ ดูข้อมูลเกี่ยวกับวิธีจัดเก็บคีย์อย่างปลอดภัยได้ที่การจัดการคีย์ของบัญชีบริการ - คลิกปิด
ดูข้อมูลเพิ่มเติมเกี่ยวกับบัญชีบริการได้ที่ บัญชีบริการ ในเอกสารประกอบของ Google Cloud IAM
สร้างไคลเอ็นต์ OAuth ที่เข้ากันได้กับ Google Workspace Marketplace
หากต้องการสร้างไคลเอ็นต์ OAuth ที่เข้ากันได้กับ Google Workspace Marketplace ให้ทำตามขั้นตอนต่อไปนี้
ใน Google Cloud Console ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ
คลิกบัญชีบริการที่คุณสร้างไว้สำหรับ แอป Chat
คลิกการตั้งค่าขั้นสูง
คลิกสร้างไคลเอ็นต์ OAuth ที่เข้ากันได้กับ Google Workspace Marketplace
คลิกต่อไป
ข้อความยืนยันจะปรากฏขึ้นเพื่อแจ้งว่าระบบได้สร้างไคลเอ็นต์ OAuth ที่เข้ากันได้กับ Google Workspace Marketplace แล้ว
สร้างและติดตั้งใช้งานแอปใน Chat
ในส่วนต่อไปนี้ คุณจะคัดลอกและอัปเดตทั้งโปรเจ็กต์ Apps Script ที่มีโค้ดแอปพลิเคชันที่จำเป็นทั้งหมดสำหรับแอป Chat จึงไม่จำเป็นต้องคัดลอกและวางแต่ละไฟล์
ฟังก์ชันบางอย่างมีขีดล่างที่ท้ายชื่อ เช่น
processSlashCommand_()
จาก ChatApp.gs
ขีดล่างจะซ่อนฟังก์ชัน
จากหน้าเว็บการเริ่มต้นเหตุการณ์เมื่อเปิดในเบราว์เซอร์ ดูข้อมูลเพิ่มเติมได้ที่
ฟังก์ชันส่วนตัว
Apps Script รองรับไฟล์ 2 ประเภท ได้แก่ .gs
สคริปต์และ.html
ไฟล์ หากต้องการปฏิบัติตามการรองรับนี้ ระบบจะรวม JavaScript ฝั่งไคลเอ็นต์ของแอปไว้
ในแท็ก <script />
และรวม CSS ไว้ในแท็ก <style />
ภายใน
ไฟล์ HTML
คุณดูทั้งโปรเจ็กต์ได้ใน GitHub (ไม่บังคับ)
ต่อไปนี้คือภาพรวมของแต่ละไฟล์
Consts.gs
กำหนดค่าคงที่ที่ไฟล์โค้ดอื่นๆ อ้างอิง รวมถึงรหัสโปรเจ็กต์ Cloud, รหัสตำแหน่ง Vertex AI, ข้อมูลเข้าสู่ระบบแอปสำหรับบัญชีบริการ และรหัสคำสั่ง Slash สำหรับปิดเหตุการณ์
ดูรหัส
Consts.gs
ChatApp.gs
จัดการเหตุการณ์การโต้ตอบในแชท ซึ่งรวมถึง ข้อความ การคลิกการ์ด คำสั่ง Slash และกล่องโต้ตอบ ตอบกลับคำสั่งเครื่องหมายทับ
/closeIncident
โดยเปิดกล่องโต้ตอบเพื่อรวบรวมรายละเอียดการแก้ไข เหตุการณ์ อ่านข้อความในพื้นที่โดยเรียกใช้เมธอดspaces.messages.list
ใน Chat API รับรหัสผู้ใช้โดยใช้บริการไดเรกทอรี Admin SDK ใน Apps Scriptดูรหัส
ChatApp.gs
ChatSpaceCreator.gs
รับข้อมูลแบบฟอร์มที่ผู้ใช้ป้อนในหน้าเว็บการเริ่มต้นเหตุการณ์ และใช้ข้อมูลดังกล่าวเพื่อตั้งค่าพื้นที่ Chat โดยการสร้างและป้อนข้อมูล จากนั้นโพสต์ข้อความเกี่ยวกับ เหตุการณ์
ดูรหัส
ChatSpaceCreator.gs
DocsApi.gs
เรียกใช้ Google เอกสาร API เพื่อสร้างเอกสาร Google เอกสารใน Google ไดรฟ์ของผู้ใช้ และเขียนสรุปข้อมูลเหตุการณ์ที่สร้างใน
VertexAiApi.gs
ลงในเอกสารดูรหัส
DocsApi.gs
VertexAiApi.gs
สรุปการสนทนาในพื้นที่ทำงานของ Chat โดยใช้ Vertex AI API ระบบจะโพสต์ข้อมูลสรุปนี้ในเอกสารที่สร้างขึ้นเป็นพิเศษใน
DocsAPI.gs
ดูรหัส
VertexAiApi.gs
WebController.gs
แสดงเว็บไซต์การเริ่มต้นเหตุการณ์
ดูรหัส
WebController.gs
Index.html
HTML ที่ประกอบเป็นเว็บไซต์การเริ่มต้นเหตุการณ์
ดูรหัส
Index.html
JavaScript.html
จัดการลักษณะการทำงานของแบบฟอร์ม รวมถึงการส่ง ข้อผิดพลาด และการล้างข้อมูล สำหรับเว็บไซต์การเริ่มต้นเหตุการณ์ โดยจะรวมไว้ ใน
Index.html
โดยฟังก์ชันinclude
ที่กำหนดเองในWebController.gs
ดูรหัส
JavaScript.html
Stylesheet.html
CSS สำหรับเว็บไซต์การเริ่มต้นเหตุการณ์ โดยจะรวมไว้ใน
Index.html
ด้วยฟังก์ชันinclude
ที่กำหนดเองในWebController.gs
ดูรหัส
Stylesheet.html
ค้นหาหมายเลขและรหัสโปรเจ็กต์ Cloud
ไปที่โปรเจ็กต์ Cloud ใน Google Cloud Console
คลิกการตั้งค่าและยูทิลิตี > การตั้งค่าโปรเจ็กต์
จดค่าในช่องหมายเลขโปรเจ็กต์และรหัสโปรเจ็กต์ คุณ ใช้ได้ในส่วนต่อไปนี้
สร้างโปรเจ็กต์ Apps Script
วิธีสร้างโปรเจ็กต์ Apps Script และเชื่อมต่อกับโปรเจ็กต์ Cloud
- คลิกปุ่มต่อไปนี้เพื่อเปิดโปรเจ็กต์ Apps Script ตอบกลับเหตุการณ์ด้วย Google Chat
เปิดโปรเจ็กต์ - คลิก ภาพรวม
- ในหน้าภาพรวม ให้คลิก
ทำสำเนา
ตั้งชื่อสำเนาโปรเจ็กต์ Apps Script โดยทำดังนี้
คลิกสำเนาของตอบสนองต่อเหตุการณ์ด้วย Google Chat
ในชื่อโปรเจ็กต์ ให้พิมพ์
Incident Management Chat app
คลิกเปลี่ยนชื่อ
ในสำเนาโปรเจ็กต์ Apps Script ให้ไปที่
Consts.gs
ไฟล์ แล้วแทนที่YOUR_PROJECT_ID
ด้วยรหัสของโปรเจ็กต์ Cloud
ตั้งค่าโปรเจ็กต์ Cloud ของโปรเจ็กต์ Apps Script
- ในโปรเจ็กต์ Apps Script ให้
คลิก
การตั้งค่าโปรเจ็กต์
- ในส่วนโปรเจ็กต์ Google Cloud Platform (GCP) ให้คลิกเปลี่ยนโปรเจ็กต์
- ในหมายเลขโปรเจ็กต์ GCP ให้วางหมายเลขโปรเจ็กต์ของโปรเจ็กต์ Cloud
- คลิกตั้งค่าโปรเจ็กต์ ตอนนี้โปรเจ็กต์ระบบคลาวด์และโปรเจ็กต์ Apps Script เชื่อมต่อกันแล้ว
สร้างการทำให้ใช้งานได้ของ Apps Script
เมื่อโค้ดทั้งหมดพร้อมแล้ว ให้ทำให้โปรเจ็กต์ Apps Script ใช้งานได้ คุณใช้รหัสการติดตั้งใช้งานเมื่อกำหนดค่า แอป Chat ใน Google Cloud
เปิดโปรเจ็กต์ของแอปการตอบสนองต่อเหตุการณ์ใน Apps Script
คลิกทำให้ใช้งานได้ > การทำให้ใช้งานได้ใหม่
หากยังไม่ได้เลือกส่วนเสริมและเว็บแอป ให้คลิกประเภทการติดตั้งใช้งาน
ข้างเลือกประเภท แล้วเลือกส่วนเสริมและเว็บแอป
ในคำอธิบาย ให้ป้อนคำอธิบายสำหรับเวอร์ชันนี้ เช่น
Complete version of incident management app
ในส่วนดำเนินการในฐานะ ให้เลือกผู้ใช้ที่เข้าถึงเว็บแอป
ในส่วนใครมีสิทธิ์เข้าถึง ให้เลือกทุกคนภายในองค์กร Workspace ของคุณ โดยที่ "องค์กร Workspace ของคุณ" คือชื่อของ องค์กร Google Workspace ของคุณ
คลิกทำให้ใช้งานได้ Apps Script จะรายงานการติดตั้งใช้งานที่สำเร็จ และระบุรหัสการติดตั้งใช้งานและ URL สำหรับหน้าเว็บเริ่มต้นของเหตุการณ์
จด URL ของเว็บแอปไว้เพื่อเข้าชมในภายหลังเมื่อคุณเริ่มเหตุการณ์ คัดลอกรหัสการติดตั้งใช้งาน คุณใช้รหัสนี้ขณะกําหนดค่าแอป Chat ในคอนโซล Google Cloud
คลิกเสร็จสิ้น
กำหนดค่าแอป Chat ใน Google Cloud Console
ส่วนนี้จะแสดงวิธีกำหนดค่า Google Chat API ในคอนโซล Google Cloud พร้อมข้อมูลเกี่ยวกับแอป Chat รวมถึง รหัสของการติดตั้งใช้งานที่คุณเพิ่งสร้างจากโปรเจ็กต์ Apps Script
ในคอนโซล Google Cloud ให้คลิกเมนู > ผลิตภัณฑ์เพิ่มเติม > Google Workspace > คลังผลิตภัณฑ์ > Google Chat API > จัดการ > การกำหนดค่า
ในส่วนชื่อแอป ให้พิมพ์
Incident Management
ใน URL ของอวตาร ให้พิมพ์
https://developers.google.com/chat/images/quickstart-app-avatar.png
ในคำอธิบาย ให้พิมพ์
Responds to incidents.
คลิกปุ่มเปิด/ปิดเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟไปที่ตำแหน่งเปิด
ในส่วนฟังก์ชันการทำงาน ให้เลือกเข้าร่วมพื้นที่ทำงานและการสนทนากลุ่ม
เลือก Apps Script ในส่วนการตั้งค่าการเชื่อมต่อ
ในรหัสการทำให้ใช้งานได้ ให้วางรหัสการทำให้ใช้งานได้ของ Apps Script ที่คัดลอกไว้ก่อนหน้านี้จากการทำให้ใช้งานได้ของโปรเจ็กต์ Apps Script
ลงทะเบียนคำสั่งเครื่องหมายทับที่แอป Chat ที่ใช้งานได้อย่างเต็มรูปแบบใช้โดยทำดังนี้
ในส่วนคำสั่ง ให้คลิกเพิ่มคำสั่ง
ในรหัสคำสั่ง ให้พิมพ์
1
ในคำอธิบาย ให้พิมพ์
Closes the incident being discussed in the space.
ในส่วนประเภทคำสั่ง ให้เลือกคำสั่ง Slash
ในชื่อคำสั่งเครื่องหมายทับ ให้พิมพ์
/closeIncident
เลือกเปิดกล่องโต้ตอบ
คลิกเสร็จสิ้น ระบบจะลงทะเบียนและแสดงคำสั่งเครื่องหมายทับ
ในส่วนระดับการเข้าถึง ให้เลือก ทำให้แอป Chat นี้พร้อมใช้งานสำหรับบุคคลและกลุ่มที่เฉพาะเจาะจงในโดเมน Workspace ของคุณ แล้วป้อนอีเมล
ในส่วนบันทึก ให้เลือกบันทึกข้อผิดพลาดไปยังการบันทึก
คลิกบันทึก ข้อความว่าบันทึกการกำหนดค่าแล้วจะปรากฏขึ้น ซึ่งหมายความว่าแอป พร้อมทดสอบแล้ว
รับการอนุมัติจากผู้ดูแลระบบ
หากต้องการได้รับการอนุมัติจากผู้ดูแลระบบ คุณต้องกำหนดค่า แอป Chat ใน SDK ของ Google Workspace Marketplace
กำหนดค่าแอป Chat ใน SDK ของ Google Workspace Marketplace
หากต้องการกำหนดค่าแอป Chat ใน SDK ของ Google Workspace Marketplace ให้ทำตามขั้นตอนต่อไปนี้
ในคอนโซล Google Cloud ให้ไปที่ เมนู > API และบริการ > API และบริการที่เปิดใช้ > Google Workspace Marketplace SDK > การกำหนดค่าแอป
กรอกข้อมูลในหน้าการกำหนดค่าแอปให้ครบถ้วน วิธีกำหนดค่าแอปแชท ขึ้นอยู่กับกลุ่มเป้าหมายที่คุณต้องการ และปัจจัยอื่นๆ หากต้องการความช่วยเหลือในการกรอกข้อมูลในหน้าการกำหนดค่าแอป โปรดดูกำหนดค่าแอปใน SDK ของ Google Workspace Marketplace สำหรับวัตถุประสงค์ของคู่มือนี้ ให้ป้อนข้อมูลต่อไปนี้
- เลือกส่วนตัวในส่วนระดับการมองเห็นแอป
- ในส่วนการตั้งค่าการติดตั้ง ให้เลือกการติดตั้งของผู้ดูแลระบบ
- เลือกแอปใน Chat ในส่วนการผสานรวมแอป
- ในส่วนขอบเขต OAuth ให้ป้อนขอบเขตต่อไปนี้
https://www.googleapis.com/auth/chat.app.spaces
https://www.googleapis.com/auth/chat.app.memberships
- ในส่วนข้อมูลนักพัฒนาแอป ให้ป้อนชื่อนักพัฒนาแอป URL เว็บไซต์ของนักพัฒนาแอป และอีเมลของนักพัฒนาแอป
- คลิกบันทึกฉบับร่าง
หลังจากกำหนดค่าแอปแล้ว ให้อัปเดตข้อมูลผลิตภัณฑ์ใน Store ดังนี้
- ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > API และบริการที่เปิดใช้ > Google Workspace Marketplace SDK > ข้อมูลใน Store
- ในรายละเอียดแอป ให้เลือกการพัฒนาเว็บเป็นหมวดหมู่
- ในเนื้อหากราฟิก ให้อัปโหลดไอคอนแอปพลิเคชันในรูปแบบที่ขอ
- ในภาพหน้าจอ ให้อัปโหลดภาพหน้าจอของแอปพลิเคชัน
- ในลิงก์สนับสนุน ให้ป้อน URL ของข้อกำหนดในการให้บริการ, URL ของนโยบายความเป็นส่วนตัว และ URL ของการสนับสนุน
- ในการจัดจำหน่าย ให้เลือกภูมิภาคที่จะให้บริการแอปพลิเคชันนี้
- คลิกเผยแพร่
ขอการอนุมัติจากผู้ดูแลระบบ
ตอนนี้บัญชีบริการได้รับการกำหนดค่าให้รับการอนุมัติจากผู้ดูแลระบบแล้ว โปรดขอรับการอนุมัติจากผู้ดูแลระบบ Google Workspace ที่ให้สิทธิ์อนุมัติได้โดย ทำตามขั้นตอนในตั้งค่าการให้สิทธิ์สำหรับแอป Chat
ทดสอบแอป Chat
หากต้องการทดสอบแอป Chat สำหรับการจัดการเหตุการณ์ ให้เริ่มเหตุการณ์จากหน้าเว็บและตรวจสอบว่าแอป Chat ทำงานตามที่คาดไว้ ดังนี้
ไปที่ URL ของเว็บแอปที่นำ Apps Script ไปใช้งาน
เมื่อ Apps Script ขอสิทธิ์เข้าถึงข้อมูล ให้คลิกตรวจสอบสิทธิ์ ลงชื่อเข้าใช้ด้วยบัญชี Google ที่เหมาะสม ในโดเมน Google Workspace แล้วคลิกอนุญาต
หน้าเว็บการเริ่มต้นเหตุการณ์จะเปิดขึ้น ป้อนข้อมูลการทดสอบ
- ในชื่อเหตุการณ์ ให้พิมพ์
The First Incident
- ไม่บังคับ: ในผู้ตอบสนองต่อเหตุการณ์ ให้ป้อนอีเมลของ ผู้ตอบสนองต่อเหตุการณ์คนอื่นๆ โดยบุคคลดังกล่าวต้องเป็นผู้ใช้ที่มี บัญชี Google Chat ในองค์กร Google Workspace หรือ การสร้างพื้นที่ทำงานจะล้มเหลว โปรดอย่าป้อนอีเมลของคุณเองเนื่องจากระบบจะ รวมอีเมลของคุณโดยอัตโนมัติ
- ในข้อความเริ่มต้น ให้พิมพ์
Testing the incident management Chat app.
- ในชื่อเหตุการณ์ ให้พิมพ์
คลิกสร้างพื้นที่ทำงานใน Chat ข้อความ
creating space
จะปรากฏขึ้นหลังจากสร้างพื้นที่ทำงานแล้ว
Space created!
ข้อความจะปรากฏขึ้น คลิกเปิดพื้นที่ทำงาน ซึ่งจะเปิดพื้นที่ทำงานใน Chat ในแท็บใหม่คุณและผู้ตอบสนองต่อเหตุการณ์คนอื่นๆ สามารถส่งข้อความในพื้นที่ทำงานได้ (ไม่บังคับ) แอปจะสรุปข้อความเหล่านี้โดยใช้ Vertex AI และแชร์เอกสารสรุป
หากต้องการสิ้นสุดการตอบสนองต่อเหตุการณ์และเริ่มกระบวนการแก้ไข ให้พิมพ์
/closeIncident
ในพื้นที่แชท กล่องโต้ตอบการจัดการเหตุการณ์จะเปิดขึ้นในปิดเหตุการณ์ ให้ป้อนคำอธิบายสำหรับการแก้ไขเหตุการณ์ เช่น
Test complete
คลิกปิดเหตุการณ์
แอปการจัดการเหตุการณ์จะแสดงข้อความในพื้นที่ สรุปข้อความเหล่านั้นด้วย Vertex AI วางสรุปในเอกสาร Google เอกสาร และแชร์เอกสารในพื้นที่
ล้างข้อมูล
เราขอแนะนำให้คุณลบโปรเจ็กต์ Cloud เพื่อหลีกเลี่ยงการเรียกเก็บเงินจากบัญชี Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้
- ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร
- ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิก ลบ
- ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์ แล้วคลิกปิดเพื่อลบ โปรเจ็กต์
หัวข้อที่เกี่ยวข้อง
- ตอบคำถามตามการสนทนาในแชทด้วยแอป Gemini AI Chat
- จัดการโปรเจ็กต์ด้วย Google Chat, Vertex AI และ Firestore
- ตอบสนองต่อเหตุการณ์ด้วย Google Chat, Vertex AI และ Apps Script (การตรวจสอบสิทธิ์ผู้ใช้)
- แอปการตอบสนองต่อเหตุการณ์จะตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้เพื่อเรียกใช้ API
และเรียกใช้บริการของ Google Cloud เช่น Chat API และ Vertex
AI API ซึ่งหมายความว่าผู้ใช้ที่เริ่มต้นเหตุการณ์ต้องมีสิทธิ์เข้าถึงบริการเหล่านี้
หากต้องการทำให้แอปมีประสิทธิภาพมากขึ้น ให้พิจารณาเรียกใช้ Vertex AI API ด้วยบัญชีบริการแทนข้อมูลเข้าสู่ระบบของผู้ใช้ที่เรียกใช้
/closeIncident
คำสั่ง Slash หากต้องการความช่วยเหลือในการกำหนดค่า บัญชีบริการสำหรับ Vertex AI API โปรดดู ใช้บัญชีบริการที่กำหนดเอง