สร้าง Agent แรก

สิ่งที่ต้องดำเนินการก่อน

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

สร้างตัวแทน

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

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

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

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

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

1. เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications
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. เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ Business Communications และลงชื่อเข้าใช้ด้วยบัญชี 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 ทดสอบของตัวแทน ซึ่งคุณดำเนินการได้ด้วย 2-3 วิธี ดังนี้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4. คลิกสร้าง

5. คลิก menuเมนู

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. เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ การสื่อสารทางธุรกิจ
2. คลิกข้อมูลตัวแทนที่การนำทางด้านซ้าย

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

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

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

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

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

1. เปิดคอนโซลของนักพัฒนาซอฟต์แวร์ การสื่อสารทางธุรกิจ
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 และสถานที่ตั้งเพิ่มเติม