สร้าง Agent แรก

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

สร้างเอเจนต์

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

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

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

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

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

  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 API และ Business Communications API แล้ว

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

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

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

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

สร้างแบรนด์และเอเจนต์

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

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

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

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

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

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

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

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

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

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

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

  1. เข้าถึง URL ทดสอบของตัวแทน ซึ่งทำได้หลายวิธีดังนี้

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

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

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

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

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

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

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

ตั้งค่า Agent เพื่อจัดการข้อความ

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

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

คุณจะต้องทำตามขั้นตอนต่อไปนี้

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

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

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

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

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

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

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

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

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

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

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

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

  4. คลิกสร้าง

  5. คลิกเมนู

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

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

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

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

  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 Bot แล้ว คุณต้องระบุ URL ของเว็บฮุค (ที่คุณ ดำเนินการ) เพื่อเริ่มรับข้อความ

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

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

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

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

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

    เมื่อ Business Messages ยืนยัน Webhook แล้ว กล่องโต้ตอบจะปิด

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

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

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

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

  1. เปิดคอนโซลนักพัฒนา Business Communications
  2. คลิกข้อมูลตัวแทนในการนำทางด้านซ้าย

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

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

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

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

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

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

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

    นอกจากนี้ คุณยังคลิกส่งเพื่อส่ง URL ไปยังอีเมลได้ด้วย

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

ข้อความต้อนรับของตัวแทนจะทักทายคุณ ตอนนี้คุณสามารถโต้ตอบกับ Echo Bot ได้แล้ว โดยจะส่งต่อข้อความที่คุณส่งกลับมาให้คุณ นอกจากนี้ คุณยังเรียกใช้ฟีเจอร์ริชได้โดยส่งสตริงที่เฉพาะเจาะจง ได้แก่ "carousel" "card" "chips"

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

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