สร้าง Agent แรก

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

สร้างตัวแทน

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

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

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

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

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

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

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

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

บ็อตผู้ช่วยช่วยให้คุณทําสิ่งต่อไปนี้ได้

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

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

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

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

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

  1. เข้าถึง URL ทดสอบของตัวแทน สิ่งที่คุณทําได้มีดังนี้

    • คลิกปุ่ม Android หรือปุ่ม iOS จากนั้นสแกนคิวอาร์โค้ด ด้วยอุปกรณ์เคลื่อนที่ที่เกี่ยวข้อง แล้วคลิกเปิด หรือคลิกคัดลอก URL ของ Android หรือคัดลอก URL ของ iOS เพื่อคัดลอก URL ทดสอบของตัวแทน
    • คลิกส่งเพื่อส่ง URL ไปยังอีเมลของคุณ
  2. เปิด URL ในอุปกรณ์เคลื่อนที่ (อุปกรณ์ iOS ต้องใช้แอป Google Maps)

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

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

หากต้องการปิดใช้บ็อตผู้ช่วย

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

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

ตั้งค่าตัวแทนสําหรับการจัดการข้อความ

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

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

โดยทําตามขั้นตอนต่อไปนี้

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

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

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

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

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

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

วิธีสร้างโปรเจ็กต์ GCP เป็นสภาพแวดล้อมระบบคลาวด์

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

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

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

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

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

  5. คลิกเมนู

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

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

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

ทําให้ตัวอย่าง Echo Bot ใช้งานได้

  1. ติดตั้ง gcloud CLI คุณจะใช้โค้ดนี้เพื่อทําให้โค้ดตัวอย่างใช้งานได้ใน Google Cloud
  2. ดาวน์โหลดและแยกตัวอย่างบ็อต Echo (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. คลิกยืนยันใน Developers 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)

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

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

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