สร้าง Agent แรก

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

• หากลงทะเบียนบัญชีพาร์ทเนอร์ก่อนวันที่ 7 มีนาคม 2022 คุณต้องเปิดใช้ Business Messages API โปรดดูหัวข้อเปิดใช้ Business Communications API และ Business Messages API

สร้างตัวแทน

คู่มือนี้จะอธิบายวิธีสร้างตัวแทนโดยใช้แอปพลิเคชันตัวอย่าง ตัวอย่างนี้ช่วยให้คุณสำรวจฟังก์ชันการทำงานของตัวแทนได้อย่างรวดเร็ว และยังใช้เป็นจุดเริ่มต้นในการพัฒนาตัวแทนได้ด้วย หากคุณต้องการแก้ไขแอปพลิเคชันที่มีอยู่ให้รวม Agent ตัวอย่างจะเป็นโมเดลที่ดีสำหรับตรรกะแอปพลิเคชันของคุณ

ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะได้ทำสิ่งต่อไปนี้

• ลงทะเบียนเป็นพาร์ทเนอร์
• สร้างแบรนด์และตัวแทน
• ลองสำรวจฟีเจอร์ในการสนทนากับ Business Messages (ไม่บังคับ) บ็อตผู้ช่วย
• ตั้งค่าตัวแทนเพื่อส่งและรับข้อความ

หากต้องการสร้างตัวแทนโดยไม่ใช้ตัวอย่าง โปรดดูสร้างตัวแทน

ลงทะเบียนเป็นพาร์ทเนอร์

1. เปิด Business Communications Developer Console
2. ในส่วน Business Messages ให้คลิกสร้างบัญชีพาร์ทเนอร์

3. ป้อนข้อมูลพาร์ทเนอร์ดังนี้

   ช่อง	ค่า
   ชื่อของคุณ	ชื่อและนามสกุลของคุณ
   ชื่อพาร์ทเนอร์	ชื่อองค์กร
   เว็บไซต์พาร์ทเนอร์	เว็บไซต์องค์กร
   ภูมิภาค	ภูมิภาคที่ต้องการโฮสต์บริการ Business Messages

4. อ่านและยอมรับ ข้อกำหนดในการให้บริการของ Business Messages

5. คลิกสร้าง

คุณได้ลงทะเบียนเป็นพาร์ทเนอร์ Business Messages แล้ว มีการสร้างโปรเจ็กต์ Google Cloud ใหม่ให้คุณพร้อมเปิดใช้ Business Messages และ Business Communications API คุณไม่มีสิทธิ์เข้าถึงโปรเจ็กต์นี้และจะไม่แทรกแซงโปรเจ็กต์ Google Cloud ที่มีอยู่

ตอนนี้คุณมีสิทธิ์เข้าถึง Business Messages และ Business Communications API แล้ว

สร้างบัญชีบริการ

1. คลิกการตั้งค่าบัญชีพาร์ทเนอร์ในหน้าแรกของ Business Communications Developer Console
2. ในการนำทางด้านซ้าย ให้คลิก บัญชีบริการ

3. คลิกสร้างคีย์ แล้วคลิกสร้าง

   เบราว์เซอร์จะดาวน์โหลดคีย์บัญชีบริการ เก็บไว้ในที่ปลอดภัย ตำแหน่งนั้น คุณจะต้องใช้คีย์นี้ในภายหลังเพื่อทำให้เว็บแอปพลิเคชันใช้งานได้และ เข้าถึง Business Messages และ Business Communications API ได้ในอนาคต

สร้างแบรนด์และตัวแทน

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

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

หากเปิดใช้บ็อตผู้ช่วย Business Messages คุณจะเริ่มการสนทนาได้ทันที หรือไม่เช่นนั้น ดำเนินการต่อเพื่อตั้งค่า Agent ของคุณสำหรับการจัดการข้อความ

สำรวจฟีเจอร์ต่างๆ ด้วยบ็อตผู้ช่วย Business Messages

บ็อตผู้ช่วย Business Messages ช่วยให้คุณเริ่มการสนทนากับ โดยตรง เพื่อให้คุณได้สัมผัสสิ่งที่แพลตฟอร์มนำเสนอ การเปิดใช้ตัวช่วย บ็อตเป็นตัวเลือกที่ไม่บังคับ แต่ขอแนะนำอย่างยิ่งให้ใช้ในการสร้างตัวแทนรายแรก

บ็อตผู้ช่วยช่วยให้คุณ

• สำรวจฟีเจอร์มากมาย
• ดูวิธีใช้ฟีเจอร์
• ค้นหาแหล่งข้อมูลสำหรับการตั้งค่าตัวแทน

เมื่อเปิดใช้บ็อตผู้ช่วย บ็อตจะรับส่งข้อความให้กับตัวแทนของคุณ ก็ไม่ต้องใช้เว็บฮุค คุณต้องปิดใช้บ็อตผู้ช่วย ก่อนจะสามารถตั้งค่าเว็บฮุคหรือเปิดใช้ Dialogflow ในการจัดการข้อความสำหรับผู้ใช้

เริ่มการสนทนากับบ็อตผู้ช่วย

เมื่อเปิดใช้บ็อตผู้ช่วย Business Messages แล้ว คุณจะเริ่มการสนทนาได้ กล่องโต้ตอบจะเปิดขึ้นทันทีหลังจากการสร้าง Agent เพื่อช่วยให้คุณเริ่มต้นใช้งานได้

หากต้องการโต้ตอบกับบ็อตผู้ช่วย ให้ทำตามขั้นตอนต่อไปนี้จากกล่องโต้ตอบนี้

1. เข้าถึง URL ทดสอบของตัวแทน คุณใช้เว็บไซต์แยกกันได้ด้วยวิธีต่างๆ ดังนี้

   • คลิกปุ่ม Android หรือปุ่ม iOS จากนั้นสแกนคิวอาร์โค้ด ด้วยอุปกรณ์เคลื่อนที่ที่เกี่ยวข้อง แล้วคลิกเปิด หรือคลิกคัดลอก URL ของ Android หรือคัดลอก URL ของ iOS เพื่อคัดลอก URL ทดสอบของ Agent
   • คลิกส่งเพื่อส่ง URL ไปยังอีเมลของคุณ

2. เปิด URL ในอุปกรณ์เคลื่อนที่ (อุปกรณ์ iOS กำหนดให้ใช้ Google Maps app.)

ปิดใช้บ็อตผู้ช่วย

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

วิธีปิดใช้บ็อตผู้ช่วย

1. เปิดนักพัฒนาการสื่อสารทางธุรกิจ Google Play
2. เลือกตัวแทนของคุณ
3. คลิกการผสานที่การนำทางด้านซ้าย
4. สำหรับบ็อตผู้ช่วย ให้คลิกปิดใช้

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

ตั้งค่า Agent สำหรับการจัดการข้อความ

ในคู่มือนี้ คุณจะทำให้บ็อต Echo ใช้งานได้กับ Google Cloud Platform (GCP) โดยใช้ เว็บฮุคที่ออกแบบมาเพื่อประมวลผลข้อความของผู้ใช้

บ็อต Echo คือแอปพลิเคชันตัวอย่างที่ส่งข้อความตอบกลับไปยังผู้ใช้ ทั้งนี้ ทำให้คุณสามารถทดลองใช้ฟีเจอร์ที่หลากหลาย เช่น การดำเนินการที่แนะนำ และ การ์ดริชมีเดีย ในการสนทนากับตัวแทน คุณยังใช้บ็อต Echo เป็นจุดเริ่มต้นได้ด้วย สำหรับการพัฒนา Agent ของคุณ

คุณต้องดำเนินการขั้นตอนต่อไปนี้

• ทำให้ตัวอย่างบ็อต Echo ใช้งานได้ใน GCP
• กำหนดค่า URL ของเว็บฮุคสำหรับบัญชีพาร์ทเนอร์ Business Messages
• ระบุข้อมูลพื้นฐานเกี่ยวกับตัวแทน

เมื่อจบคู่มือนี้ ตัวแทนของคุณจะพร้อมรับและส่งข้อความ

หมายเหตุ: หากเปิดใช้บ็อตผู้ช่วย Business Messages คุณต้อง เพื่อปิดใช้ก่อนที่จะปรับแต่งตัวแทน และ รับข้อความที่เว็บฮุค

ทำให้เว็บแอปพลิเคชันใช้งานได้ใน GCP

Business Messages จะส่งต่อข้อความจากผู้ใช้ไปยังเว็บฮุค ในโครงสร้างพื้นฐาน ในคู่มือนี้ คุณจะได้ใช้งานตัวอย่างบ็อต Echo ไปยังเว็บฮุคที่กำหนดค่าไว้ล่วงหน้า หากคุณมีโครงสร้างพื้นฐานของเว็บเพื่อ ใช้ประโยชน์จากการรับข้อความ คุณสามารถสร้างเว็บฮุคใหม่บนเว็บนั้นได้ แต่คุณจะต้องกำหนดค่าตรรกะด้วยตนเอง โปรดดู ตั้งค่าเว็บฮุคระดับพาร์ทเนอร์ เพื่อดูรายละเอียด

หมายเหตุ: เมื่อสร้างแอปพลิเคชันของคุณเอง คุณสามารถใช้ตรรกะที่กำหนดค่าไว้ล่วงหน้าใน Echo Bot เป็นโมเดลได้ อย่าลืมใส่ตรรกะสำหรับ clientToken เพื่อยืนยันว่าข้อความที่คุณได้รับนั้นมาจาก Google

สร้างสภาพแวดล้อมระบบคลาวด์

คุณต้องมีสภาพแวดล้อมระบบคลาวด์เพื่อทำให้ตัวอย่าง Echo Bot ใช้งานได้

หมายเหตุ: คุณต้องเพิ่มบัญชีสำหรับการเรียกเก็บเงินใน Cloud ลงในโปรเจ็กต์เมื่อสร้างสภาพแวดล้อมระบบคลาวด์ คุณสามารถเลือกบัญชีฟรีหรือแบบชำระเงินก็ได้ นอกจากนี้ คุณยังเลือกทำให้บ็อต Echo ใช้งานได้ในเซิร์ฟเวอร์ของคุณเองก็ได้

หากต้องการสร้างโปรเจ็กต์ GCP เป็นสภาพแวดล้อมระบบคลาวด์ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด ตัวเลือกโปรเจ็กต์คอนโซล Google Cloud

   หากไม่เคยสร้างโปรเจ็กต์ Google Cloud คุณจะต้องยอมรับข้อกำหนดในการให้บริการ

2. คลิกสร้างโปรเจ็กต์

3. ป้อนชื่อและตําแหน่งสําหรับโปรเจ็กต์ใหม่

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

4. คลิกสร้าง

5. คลิก เมนู

6. คลิกการเรียกเก็บเงิน

7. คลิกลิงก์บัญชีสำหรับการเรียกเก็บเงิน

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

ทำให้ตัวอย่างบ็อต Echo ใช้งานได้

1. ติดตั้ง gcloud CLI คุณจะนำโค้ดตัวอย่างไปใช้งานกับ Google Cloud

2. ดาวน์โหลดและแตกตัวอย่าง Echo Bot (Node.js, Java Python)

3. คัดลอกไฟล์ข้อมูลเข้าสู่ระบบ JSON ที่คุณดาวน์โหลดมา สร้างบัญชีบริการลงในโฟลเดอร์ทรัพยากรของตัวอย่าง และเปลี่ยนชื่อข้อมูลเข้าสู่ระบบเป็น "bm-agent-service-account-credentials.json" เส้นทางไปยังไฟล์ข้อมูลเข้าสู่ระบบนี้ขึ้นอยู่กับตัวอย่างที่คุณดาวน์โหลด

   Node.js

   ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

   Java

   ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json
   

   Python

   ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json
   

4. ในเทอร์มินัล ให้ไปที่ไดเรกทอรี Full_sample ของตัวอย่าง

5. เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัลเพื่อทำให้ตัวอย่างใช้งานได้

   Node.js

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID คือรหัสโปรเจ็กต์ที่คุณสร้าง สร้างสภาพแวดล้อมระบบคลาวด์ รหัสโปรเจ็กต์จะแสดงอยู่ในแดชบอร์ดโปรเจ็กต์ใน Google Cloud

   Java

   gcloud config set project PROJECT_ID
   gcloud app create
   mvn appengine:deploy
   

   PROJECT_ID คือรหัสโปรเจ็กต์ที่คุณสร้าง สร้างสภาพแวดล้อมระบบคลาวด์ รหัสโปรเจ็กต์จะแสดงอยู่ในแดชบอร์ดโปรเจ็กต์ใน Google Cloud

   Python

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy
   

   PROJECT_ID คือรหัสโปรเจ็กต์ที่คุณสร้าง สร้างสภาพแวดล้อมระบบคลาวด์ รหัสโปรเจ็กต์จะแสดงอยู่ในแดชบอร์ดโปรเจ็กต์ใน Google Cloud

6. จด URL ของแอปพลิเคชันที่ทำให้ใช้งานได้ในเอาต์พุตของคำสั่งล่าสุด ตำแหน่ง URL ของเว็บฮุคมีดังนี้

   Deployed service [default] to [https://PROJECT_ID.appspot.com]

ตั้งค่าเว็บฮุค

เมื่อทำให้บ็อต Echo ใช้งานได้แล้ว คุณจะต้องระบุ URL ของเว็บฮุค (ที่คุณ ทำงาน) เพื่อเริ่ม การรับข้อความ

1. เปิด การตั้งค่าบัญชี ใน Business Communications Developer Console
2. ตรวจสอบว่าได้เลือกบัญชีพาร์ทเนอร์ที่ถูกต้องแล้ว
3. สำหรับ URL ของเว็บฮุคของ Business Messages ให้คลิกกำหนดค่า

4. สำหรับ URL ปลายทางของเว็บฮุค ให้ป้อน URL ของแอปพลิเคชัน + "/callback"

   โดยปลายทางจะมีรูปแบบดังนี้ "https://PROJECT_ID.appspot.com/callback".

   ปลายทางนี้ได้รับการกำหนดไว้ล่วงหน้าในตรรกะแอปพลิเคชันของตัวอย่างที่คุณ ทำให้ใช้งานได้กับ GCP แล้ว

5. ใน Developer Console ให้คลิกยืนยัน

   เมื่อ Business Messages ยืนยันเว็บฮุค กล่องโต้ตอบจะปิดลง

หากต้องการกำหนดค่าเว็บฮุคด้วย Business Communications API โปรดดู ตัวอย่าง: อัปเดต URL ของเว็บฮุค

คุณใช้กรอบการทดสอบ Business Messages ได้ เพื่อทดสอบว่าเว็บฮุคตอบสนองต่อเพย์โหลด Business Messages ได้สำเร็จหรือไม่

ป้อนข้อมูลตัวแทน

ระบุข้อมูลพื้นฐานบางอย่างเพื่อตั้งค่าตัวแทนให้เสร็จสมบูรณ์

1. เปิดนักพัฒนาการสื่อสารทางธุรกิจ Google Play
2. คลิกข้อมูลตัวแทนที่การนำทางด้านซ้าย

3. อัปเดตค่าตามที่ต้องการ หรือใช้คำแนะนำต่อไปนี้

   ช่อง	ค่า
   ข้อความต้อนรับ	ยินดีต้อนรับสู่การสนทนาของ Echo Bot
   นโยบายความเป็นส่วนตัว	https://policies.google.com/privacy

4. คลิกบันทึก

เริ่มการสนทนา

หากต้องการโต้ตอบกับบ็อต Echo ให้ทําตามขั้นตอนต่อไปนี้

1. เปิดนักพัฒนาการสื่อสารทางธุรกิจ Google Play
2. คลิกข้อมูลตัวแทนที่การนำทางด้านซ้าย
3. ในส่วน URL ทดสอบของตัวแทน ให้คลิกปุ่ม Android หรือปุ่ม iOS

4. สแกนคิวอาร์โค้ดด้วยอุปกรณ์เคลื่อนที่ที่เกี่ยวข้อง หรือคลิกคัดลอก URL ของ Android หรือคัดลอก URL ของ iOS เพื่อคัดลอก URL ทดสอบของตัวแทน

   นอกจากนี้คุณยังสามารถคลิกส่ง เพื่อส่ง URL ไปยังที่อยู่อีเมลของคุณ

5. เปิด URL ในอุปกรณ์เคลื่อนที่ (อุปกรณ์ iOS กำหนดให้ใช้ Google Maps)

ข้อความต้อนรับของตัวแทนจะทักทายคุณ ในจุดนี้ คุณสามารถโต้ตอบกับ บ็อต Echo ซึ่งจะสะท้อนข้อความที่คุณส่งกลับไปให้คุณ นอกจากนี้ คุณยังสามารถ เรียกใช้คุณลักษณะที่สมบูรณ์โดยการส่งสตริงเฉพาะ: "ภาพหมุน" "การ์ด" "ชิป"

ขั้นตอนถัดไป

ตอนนี้คุณสร้างตัวแทนคนแรกเรียบร้อยแล้ว โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับ Business Messages และทำอะไรได้อีก บนแพลตฟอร์ม

• ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของ Business Messages

• อ่านข้อกำหนดและหลักเกณฑ์ของ Business Messages

• แก้ไขบ็อต Echo และตอบกลับด้วยตรรกะทางธุรกิจโดยอ่านวิธีรับข้อความ

• ตรวจสอบโครงสร้างพื้นฐาน

• เปิดตัว agent เพิ่มเติม และสถานที่