Tạo một ứng dụng Google Chat cho dự án Dialogflow CX có khả năng hiểu và phản hồi bằng ngôn ngữ tự nhiên

Trang này giải thích cách tạo một ứng dụng Google Chat có thể vừa hiểu vừa phản hồi bằng ngôn ngữ tự nhiên thông qua Dialogflow. Hướng dẫn này sử dụng Dialogflow CX, có tính năng tích hợp trực tiếp với Google Chat. Bạn cũng có thể sử dụng Dialogflow ES để tạo một ứng dụng Google Chat Dialogflow ES bằng cách làm theo hướng dẫn về Google Chat Dialogflow ES.

Ví dụ: hãy xem xét một ứng dụng Chat giúp mọi người thuê ô tô. Người dùng có thể viết "Tôi muốn thuê xe". Ứng dụng Chat có thể trả lời bằng một câu hỏi như "Bạn muốn nhận xe ở đâu?". Câu hỏi này sẽ bắt đầu một cuộc trò chuyện giống như trò chuyện với con người, trong đó ứng dụng Chat vừa hiểu vừa trả lời bằng lời nói của con người trong khi đặt dịch vụ cho thuê xe.

Đây chỉ là một ví dụ. Các ứng dụng Chat của Dialogflow rất hữu ích trong mọi loại hình tương tác. Nếu cần có lời nói tự nhiên của con người, thì bạn cần có một ứng dụng Chat Dialogflow. Các tác nhân được tạo sẵn giúp bạn bắt đầu nhanh chóng và cho thấy những việc mà Dialogflow có thể làm, chẳng hạn như:

  • Đặt chuyến bay
  • Đặt lịch hẹn gặp bác sĩ
  • Đặt đồ ăn giao tận nơi
  • Trả lời các câu hỏi về danh mục sản phẩm bán lẻ, chẳng hạn như liệu các mặt hàng có màu khác hay không
  • Trang chọn nhân viên hỗ trợ dự án Dialogflow được tạo sẵn.
    Hình 1. Chọn một nhân viên hỗ trợ được tạo sẵn cho ứng dụng Chat trên Dialogflow.
  • Kiểm thử nhân viên hỗ trợ trong Dialogflow CX.
    Hình 2. Kiểm thử tác nhân trong Dialogflow CX để đảm bảo logic và cấu hình của tác nhân hoạt động như dự kiến. Sơ đồ này cho thấy một tập hợp tuần tự các trang theo chủ đề liên quan đến các bước cụ thể trong cuộc trò chuyện, chẳng hạn như thiết lập địa điểm nhận và trả xe cho xe cho thuê, đồng thời định cấu hình logic kết nối các trang đó. Cuộc trò chuyện được kiểm thử trong một trình mô phỏng.
  • Định cấu hình ứng dụng Chat Dialogflow.
    Hình 3. Định cấu hình một ứng dụng trò chuyện để xử lý các phản hồi bằng cách sử dụng tác nhân Dialogflow CX trên trang cấu hình Chat API trong Google Cloud Console.
  • Kiểm thử ứng dụng Chat Dialogflow CX
    Hình 4. Trò chuyện về việc đặt xe cho thuê với ứng dụng Dialogflow Chat trong Google Chat.

Mục tiêu

  • Thiết lập môi trường.
  • Tạo và triển khai một nhân viên hỗ trợ Dialogflow CX.
  • Tạo và triển khai một ứng dụng trong Chat dựa trên nhân viên hỗ trợ Dialogflow CX.
  • Kiểm thử ứng dụng Chat.

Điều kiện tiên quyết

Kiến trúc

Sơ đồ sau đây cho thấy cấu trúc của một ứng dụng trò chuyện được tạo bằng Dialogflow:

Cấu trúc của một ứng dụng Chat được triển khai bằng Dialogflow.

Trong sơ đồ trước đó, một người dùng tương tác với ứng dụng trò chuyện Dialogflow sẽ có luồng thông tin như sau:

  1. Người dùng gửi tin nhắn trong Chat cho một ứng dụng Chat, có thể là trong tin nhắn trực tiếp hoặc trong một không gian Chat.
  2. Một nhân viên hỗ trợ ảo Dialogflow (nằm trong Google Cloud) sẽ nhận và xử lý tin nhắn để đưa ra câu trả lời.
  3. Nếu muốn, bạn có thể sử dụng webhook Dialogflow. Nhờ đó, tác nhân Dialogflow có thể tương tác với các dịch vụ bên ngoài của bên thứ ba, chẳng hạn như hệ thống quản lý dự án hoặc công cụ bán vé.
  4. Tác nhân Dialogflow sẽ gửi phản hồi trở lại dịch vụ ứng dụng Chat trong Chat.
  5. Phản hồi sẽ được gửi đến phòng Chat.

Thiết lập môi trường

Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.

  1. Trong Google Cloud Console, hãy bật Google Chat API và Dialogflow API.

    Bật các API

  2. Xác nhận rằng bạn đang bật các API trong dự án Cloud chính xác, sau đó nhấp vào Tiếp theo.

  3. Xác nhận rằng bạn đang bật đúng API, sau đó nhấp vào Bật.

Tạo một nhân viên hỗ trợ Dialogflow CX

Nhân viên hỗ trợ Dialogflow CX là một nhân viên hỗ trợ ảo xử lý các cuộc trò chuyện đồng thời với người dùng cuối. Đây là một mô-đun hiểu ngôn ngữ tự nhiên, có khả năng hiểu được các sắc thái trong ngôn ngữ của con người. Dialogflow dịch văn bản của người dùng cuối trong cuộc trò chuyện thành dữ liệu có cấu trúc mà các ứng dụng và dịch vụ của bạn có thể hiểu được. Bạn thiết kế và tạo một tác nhân Dialogflow để xử lý các loại cuộc trò chuyện cần thiết cho hệ thống của mình.

Nhân viên hỗ trợ dự án Dialogflow giống như nhân viên hỗ trợ tại trung tâm cuộc gọi. Bạn huấn luyện cả hai để xử lý các tình huống trò chuyện dự kiến và bạn không cần phải huấn luyện quá rõ ràng.

Sau đây là cách tạo nhân viên hỗ trợ Dialogflow CX:

  1. Trong bảng điều khiển Dialogflow CX, hãy mở Bảng điều khiển Dialogflow CX. Nhấp vào Trình đơn > Dialogflow CX.

    Truy cập bảng điều khiển Dialogflow CX

  2. Chọn một dự án trên Google Cloud. Để tìm dự án, bạn có thể phải nhấp vào Tất cả rồi tìm dự án đó.

  3. Giờ đây, bạn có thể chọn một tác nhân được tạo sẵn hoặc tạo tác nhân của riêng mình. Nếu bạn muốn tìm hiểu chi tiết về cách tuỳ chỉnh nhân viên hỗ trợ sau, hãy chọn một trong các nhân viên hỗ trợ được tạo sẵn. Đây cũng là những nhân viên hỗ trợ hữu ích để tìm hiểu về những việc mà nhân viên hỗ trợ có thể làm.

    Để chọn một tác nhân được tạo sẵn, hãy làm theo các bước sau:

    1. Nhấp vào Sử dụng các đặc vụ được tạo sẵn.

    2. Chọn một tác nhân được tạo sẵn. Trong hướng dẫn này, hãy chọn Du lịch: thuê xe.

      Nhân viên hỗ trợ được đánh giá là người mới bắt đầu, người có trình độ trung bình hoặc người có trình độ nâng cao dựa trên số lượng tính năng mà nhân viên hỗ trợ sử dụng và mức độ phức tạp của logic trò chuyện. Việc chọn một tác nhân trung gian hoặc nâng cao có thể yêu cầu các chế độ cài đặt và tuỳ chỉnh dành riêng cho tác nhân, bao gồm cả việc bật các tính năng và API trong Google Cloud Console.

    3. Nhấp vào Nhập dưới dạng nhân viên.

    Để tạo một trợ lý ảo của riêng bạn, hãy làm theo các bước sau:

    1. Nhấp vào Tạo tác nhân.
    2. Chọn Tự động tạo để tạo tác nhân lưu trữ dữ liệu hoặc chọn Tự xây dựng để tạo các loại tác nhân khác.

    Để xem hướng dẫn chi tiết về quy trình tạo tác nhân, hãy xem phần Tạo một tác nhân Dialogflow CX.

  4. Định cấu hình các chế độ cài đặt cơ bản của tác nhân:

    1. Trong phần Tên hiển thị, hãy nhập tên hiển thị.
    2. Chọn vị trí bạn muốn. Nếu bạn muốn thay đổi chế độ cài đặt vị trí nâng cao, hãy nhấp vào Chỉnh sửa.
    3. Chọn múi giờ bạn muốn.
    4. Chọn ngôn ngữ mặc định cho trợ lý ảo. Bạn không thể thay đổi ngôn ngữ mặc định cho một nhân viên hỗ trợ sau khi tạo.

  5. Nhấp vào Tạo. Dialogflow CX bắt đầu tạo tác nhân, sau đó hiển thị luồng bắt đầu mặc định của tác nhân.

  6. Bạn có thể tuỳ chỉnh nhân viên hỗ trợ (nếu muốn). Để xem hướng dẫn chi tiết về quy trình tuỳ chỉnh tác nhân, hãy xem phần Tạo một tác nhân Dialogflow CX.

  7. Theo phương pháp hay nhất, hãy kiểm thử tác nhân:

    1. Nhấp vào Tác nhân kiểm thử.
    2. Chọn Test agent in environment (Tác nhân kiểm thử trong môi trường).
    3. Trong mục Môi trường, hãy chọn Bản nháp.
    4. Trong Flow, hãy chọn Default Start Flow (Luồng bắt đầu mặc định).
    5. Trong Page (Trang), hãy chọn Start Page (Trang bắt đầu).
    6. Trong thanh soạn tin Nói chuyện với nhân viên hỗ trợ, hãy nhập Hello rồi nhấn phím Enter. Nhân viên hỗ trợ sẽ tự giới thiệu khi trả lời.
    7. Hoàn tất quy trình kiểm thử bằng cách thực hiện cuộc trò chuyện kiểm thử mẫu.

  8. Nhân viên hỗ trợ Dialogflow CX được tạo. Quay lại bảng điều khiển Dialogflow CX. Nhấp vào Trình đơn > Dialogflow CX.

    Truy cập bảng điều khiển Dialogflow CX

  9. Trong mục Agents (Nhân viên), hãy nhấp vào biểu tượng > Copy name (Sao chép tên). Hãy lưu tên này vì bạn sẽ dùng tên này khi định cấu hình ứng dụng Chat.

Tạo một ứng dụng Chat và kết nối ứng dụng đó với nhân viên hỗ trợ Dialogflow

Sau khi tạo một đặc vụ Dialogflow CX, hãy làm theo các bước sau để biến đặc vụ đó thành một ứng dụng trò chuyện:

  1. Trong Google Cloud Console, hãy chuyển đến Google Chat API. Tìm "Google Chat API" rồi nhấp vào Google Chat API, sau đó nhấp vào Quản lý.

    Chuyển đến Chat API

  2. Nhấp vào Cấu hình rồi thiết lập ứng dụng Chat:

    1. Trong Tên ứng dụng, hãy nhập Dialogflow App.
    2. Trong URL hình đại diện, hãy nhập https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    3. Trong phần Nội dung mô tả, hãy nhập Responds to real human conversation.
    4. Trong phần Chức năng, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm.
    5. Trong phần Connection settings (Chế độ cài đặt kết nối), hãy chọn Dialogflow.
    6. Trong phần Cài đặt Dialogflow, hãy chọn Dialogflow CX.
    7. Trong Agent or Environment resource name (Tên tài nguyên Nhân viên hỗ trợ hoặc Môi trường), hãy dán tên nhân viên hỗ trợ Dialogflow CX mà bạn đã sao chép ở cuối phần Tạo nhân viên hỗ trợ Dialogflow CX.
    8. Cung cấp ứng dụng Chat này cho những người và nhóm cụ thể trong miền của bạn rồi nhập địa chỉ email của bạn.
    9. Trong mục Nhật ký, hãy chọn Ghi lỗi vào Nhật ký.

  3. Nhấp vào Lưu.

Ứng dụng Chat đã sẵn sàng nhận và trả lời tin nhắn trên Chat.

Kiểm thử ứng dụng Chat

Kiểm thử ứng dụng Chat Dialogflow CX bằng cách nhắn tin cho ứng dụng này trong Google Chat.

  1. Mở Google Chat bằng tài khoản Google Workspace mà bạn đã cung cấp khi thêm chính mình làm người kiểm thử tin cậy.

    Truy cập vào Google Chat

  2. Nhấp vào biểu tượng Cuộc trò chuyện mới.
  3. Trong trường Thêm một hoặc nhiều người, hãy nhập tên của ứng dụng Chat.

  4. Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.

  5. Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập Hello rồi nhấn enter.

    Ứng dụng Dialogflow Chat sẽ phản hồi bằng cách tự giới thiệu.

  6. Hoàn tất quy trình kiểm thử bằng cách thực hiện cuộc trò chuyện kiểm thử mẫu.

Cuộc trò chuyện kiểm thử mẫu

Để kiểm thử ứng dụng Chat Dialogflow CX trong bảng điều khiển Dialogflow CX hoặc trong Google Chat, hãy trò chuyện như sau. Phần giải thích này giúp bạn hiểu cách tác nhân Dialogflow CX diễn giải ngôn ngữ tự nhiên của người dùng và tạo ra phản hồi bằng ngôn ngữ tự nhiên của riêng mình ở mỗi bước trong cuộc trò chuyện. Cuộc trò chuyện mẫu này dựa trên trợ lý được tạo sẵn có tên là Du lịch: thuê xe.

Hộp thoại Giải thích
Người dùng cuối: Xin chào
Nhân viên hỗ trợ: Xin chào! Tôi là nhân viên cho thuê ô tô ảo. Tôi có thể giúp bạn bắt đầu đặt chỗ thuê xe mới. Hôm nay, tôi có thể hỗ trợ gì cho bạn?
  1. Tuyến Default Welcome Intent (Ý định chào mừng mặc định) trong Default Start Flow (Luồng bắt đầu mặc định) sẽ được gọi.
  2. Hoạt động thực hiện cho trình xử lý trạng thái này ("Chào bạn! Tôi...") được thêm vào hàng đợi phản hồi.
  3. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Tôi muốn thuê một chiếc ô tô.
Nhân viên hỗ trợ: Bạn muốn đến lấy xe ở đâu?
  1. Đường dẫn ý định car_rental.reservation_create trong Trang bắt đầu được so khớp.
  2. Phiên sẽ chuyển sang trang Địa điểm đến lấy.
  3. Biểu mẫu trên trang Địa điểm đến lấy hàng chưa hoàn tất, vì vậy, tác nhân sử dụng tham số pickup_location để nhắc người dùng ("Bạn muốn đến lấy hàng ở đâu..."), được thêm vào hàng đợi phản hồi.
  4. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Las Vegas
Nhân viên hỗ trợ: Được rồi, bạn sẽ đến lấy hàng ở Las Vegas.
Nhân viên hỗ trợ: Địa điểm trả xe của bạn có khác với địa điểm lấy xe không?
  1. Thông tin đầu vào của người dùng cuối sẽ điền vào tham số pickup_location mà tác nhân yêu cầu trong lượt trò chuyện trước đó.
  2. Lộ trình ý định car_rental.return_different_location trong Luồng bắt đầu mặc định được so khớp.
  3. Lộ trình hoàn tất biểu mẫu trong trang Địa điểm đến lấy được đánh giá và gọi. Hành động này có một yêu cầu thực hiện ("Ok, your pickup..."), được thêm vào hàng đợi phản hồi với các tham chiếu tham số được phân giải thành các giá trị thực do người dùng cuối cung cấp.
  4. Phiên này sẽ chuyển sang trang Xác nhận vị trí.
  5. Trang Xác nhận vị trí có một mục hoàn tất ("Vị trí trả hàng của bạn có khác..."), được thêm vào hàng đợi phản hồi.
  6. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Có. Tôi sẽ trả xe ở Los Angeles.
Nhân viên hỗ trợ: Được rồi, bạn sẽ trả xe ở Los Angeles.
Nhân viên hỗ trợ: Bạn muốn đến lấy xe vào ngày và giờ nào?
  1. Lộ trình ý định car_rental.return_different_location trong Luồng bắt đầu mặc định được so khớp.
  2. Phiên sẽ chuyển sang trang Vị trí trả xe.
  3. Thông tin đầu vào của người dùng cuối sẽ điền vào tham số drop_off_location mà tác nhân yêu cầu trong lượt trò chuyện trước đó.
  4. Lộ trình hoàn tất biểu mẫu trong trang Drop Off Location (Vị trí trả hàng) sẽ được đánh giá và gọi. Nó có một yêu cầu thực hiện ("Ok, your drop off..."), được thêm vào hàng đợi phản hồi.
  5. Phiên chuyển sang trang Rental Duration (Thời hạn thuê).
  6. Trang Thời gian thuê có các giá trị biểu mẫu chưa hoàn chỉnh, vì vậy, trang này sẽ nhắc người dùng nhập thông số pickup_date_time ("Bạn muốn đến lấy xe vào ngày và giờ nào..."), được thêm vào hàng đợi phản hồi.
  7. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Tôi muốn đến lấy xe vào trưa ngày 5 tháng 3.
Nhân viên hỗ trợ: Bạn muốn đến giao xe vào ngày và giờ nào?
  1. Thông tin đầu vào của người dùng cuối sẽ điền vào tham số pickup_date_time mà tác nhân yêu cầu trong lượt trò chuyện trước đó.
  2. Trang Thời gian thuê có một giá trị biểu mẫu khác bị thiếu, vì vậy, trang này sẽ nhắc người dùng nhập thông số drop_off_date_time ("Bạn muốn trả xe vào ngày và giờ nào..."), được thêm vào hàng đợi phản hồi.
  3. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: 12 giờ trưa ngày 15 tháng 3.
Nhân viên hỗ trợ: Để xác nhận:

Bạn sẽ nhận xe ở Las Vegas vào 12:00:00 ngày 5 tháng 3 năm 2024 và trả xe ở Los Angeles vào 12:00:00 ngày 15 tháng 3 năm 2024

Thông tin này có chính xác không?
  1. Thông tin đầu vào của người dùng cuối sẽ điền vào tham số drop_off_date_time mà tác nhân yêu cầu trong lượt trò chuyện trước đó.
  2. Phiên sẽ chuyển sang trang Xác nhận thời gian thuê.
  3. Trang Xác nhận thời gian thuê có một mục hoàn tất yêu cầu ("Để xác nhận..."), được thêm vào hàng đợi phản hồi.
  4. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Vâng, cảm ơn bạn.
Nhân viên hỗ trợ: Tuyệt vời! Bây giờ, hãy chọn một chiếc xe.
Nhân viên hỗ trợ: Bạn muốn thuê xe phổ thông hay xe sang?
  1. Ý định small_talk.confirmation.yes được so khớp với tuyến trong trang Xác nhận thời gian thuê.
  2. Nhân viên hỗ trợ xác nhận lựa chọn của người dùng bằng một tin nhắn ("Tuyệt vời! Giờ thì chúng ta hãy chọn..."), được thêm vào hàng đợi phản hồi.
  3. Phiên chuyển sang trang Phân biệt xe.
  4. Biểu mẫu trang Phân biệt xe chưa hoàn tất, vì vậy, tác nhân sử dụng tham số vehicle_type để nhắc người dùng ("Bạn muốn xe tiết kiệm nhiên liệu hay xe hạng sang..."), được thêm vào hàng đợi phản hồi.
  5. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Tiết kiệm nhé.
Nhân viên: Bạn muốn mua xe Cymbal hay xe tải Cymbal?
  1. Lộ trình ý định $session.params.vehicle_type="economy_vehicle" được so khớp.
  2. Phiên sẽ chuyển sang trang Economy Options (Lựa chọn tiết kiệm).
  3. Trang Economy Options (Các lựa chọn tiết kiệm) có một mục hoàn tất việc nhập ("Bạn có muốn..."), được thêm vào hàng đợi phản hồi.
  4. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Cymbal Truck.
Nhân viên: Xe Cymbal Truck có giá 50,33 USD mỗi ngày. Xe có 4 chỗ ngồi và được trang bị đài AM/FM. Bạn có muốn chuyển sang bước thanh toán không?
Người dùng cuối: Có, vui lòng.
  1. Lộ trình ý định $session.params.vehicle_type="Cymbal Truck" được so khớp và tham số vehicle_model được điền.
  2. Phiên sẽ chuyển sang trang Xác nhận xe tải Cymbal.
  3. Trang Confirm Cymbal Truck (Xác nhận Cymbal Truck) có một mục thực hiện yêu cầu ("The Cymbal Truck is $50.33 per day..." (Cymbal Truck có giá 50,33 USD/ngày...)), được thêm vào hàng đợi phản hồi.
  4. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
  5. Câu trả lời của người dùng khớp với tuyến đường small_talk.confirmation.yes.
Nhân viên hỗ trợ: Bạn sẽ sử dụng loại thẻ nào?
Người dùng cuối: Altostrat
Nhân viên: Vui lòng nhập số thẻ.
Người dùng cuối: 1234 1234 1234 1234
Nhân viên hỗ trợ: Tên trên thẻ là gì?
Người dùng cuối: Charlie
Nhân viên hỗ trợ: Địa chỉ đường phố thanh toán là gì?
Người dùng cuối: 1800 Amphibious Blvd. Mountain View, CA
Nhân viên hỗ trợ: Mã bưu chính thanh toán là gì?
Người dùng cuối: 94045
Nhân viên: Bạn sẽ nhận chiếc xe Cymbal ở Las Vegas vào lúc 12:00:00 ngày 5 tháng 3 năm 2024 và trả xe vào lúc 12:00:00 ngày 15 tháng 3 năm 2024. Tổng chi phí cho chuyến đi này là 175,38 USD.
Nhân viên hỗ trợ: Cảm ơn bạn đã thuê phim của chúng tôi. Chúc bạn một ngày tốt lành!
  1. Phiên sẽ chuyển sang trang Thanh toán.
  2. Biểu mẫu Payment (Thanh toán) chưa hoàn tất nên trợ lý sẽ nhắc người dùng cung cấp các tham số card_type (loại thẻ), card_number (số thẻ), billing_name (tên người thanh toán), billing_street_address (địa chỉ đường phố của người thanh toán) và billing_zip_code (mã bưu chính của người thanh toán) ("Bạn sẽ dùng loại thẻ nào..."), được thêm tuần tự vào hàng đợi phản hồi và gửi khi người dùng phản hồi. Phản hồi của người dùng sẽ đặt từng giá trị tham số.
  3. Phiên chuyển sang trang Xác nhận cho thuê.
  4. Trang Xác nhận cho thuê có một mục hoàn tất ("Ok, your pickup will be..." (Ok, bạn sẽ đến lấy vào...)), được thêm vào hàng đợi phản hồi.
  5. Trợ lý gửi hàng đợi phản hồi cho người dùng cuối.
  6. Phiên sẽ chuyển sang trang Kết thúc phiên.

Gửi tin nhắn dạng thẻ từ Dialogflow

Dialogflow có thể phản hồi bằng tin nhắn văn bản hoặc thẻ. Để phản hồi bằng một thông báo thẻ, hãy chỉ định thông báo đó là tải trọng tuỳ chỉnh trong thực hiện.

JSON sau đây cho biết cách gửi một thông báo dạng thẻ dưới dạng tải trọng tuỳ chỉnh trong quá trình thực hiện:

json

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from Dialogflow',
        'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
        'imageType': 'CIRCLE'
      },
      'sections': [
        {
          'widgets': [
            {
              'buttonList': {
                'buttons': [
                  {
                    'text': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Giới hạn và điểm cần cân nhắc

  • Sự kiện tương tác qua tin nhắn có phạm vi hỗ trợ hạn chế và một số điểm cần lưu ý:
    • Sau đây là các loại sự kiện tương tác được hỗ trợ:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • Đối với sự kiện MESSAGE hoặc ADDED_TO_SPACE, dữ liệu đầu vào truy vấn được gửi đến tác nhân Dialogflow tương ứng với giá trị của trường argumentText trong Tin nhắn trò chuyện. Nếu thông báo có lệnh gạch chéo, thì giá trị của trường text sẽ được dùng thay thế.
    • Đối với các sự kiện CARD_CLICKED, dữ liệu đầu vào của truy vấn được gửi đến tác nhân Dialogflow sẽ được định dạng dưới dạng CARD_CLICKED.functionName, trong đó functionName tương ứng với giá trị của trường function trong đối tượng Action được đính kèm vào phần tử thẻ tương tác (chẳng hạn như nút).
    • Toàn bộ tải trọng JSON của mỗi sự kiện tương tác trên Chat sẽ được gửi đến Dialogflow dưới dạng tải trọng tuỳ chỉnh trong tham số truy vấn và có thể truy cập bằng webhook Dialogflow bằng cách truy vấn giá trị của trường WebhookRequest.payload.
  • Những điều cần cân nhắc khi phản hồi lệnh dấu gạch chéo và nhận dữ liệu từ thẻ hoặc hộp thoại:
    • Khi nhận được một thông báo có lệnh dấu gạch chéo, ứng dụng Chat Dialogflow sẽ chỉ chứa giá trị của trường text trong dữ liệu đầu vào truy vấn. Trường text bắt đầu bằng tên của lệnh dấu gạch chéo (ví dụ: /command). Bạn có thể dùng tên này để định cấu hình ý định của một tác nhân Dialogflow nhằm phát hiện lệnh dấu gạch chéo.
    • Nếu cần xử lý tải trọng JSON của sự kiện Tương tác qua tin nhắn, thì tác nhân Dialogflow có thể làm như vậy bằng cách sử dụng webhook Dialogflow để kiểm tra tải trọng tuỳ chỉnh trong tham số truy vấn.
    • Để hiển thị một hộp thoại từ Đặc vụ Dialogflow, hãy phản hồi bằng một tải trọng JSON tuỳ chỉnh duy nhất bao gồm một thông báo chứa DIALOG phản hồi hành động.
    • Để xử lý dữ liệu được nhập từ thẻ, tác nhân Dialogflow có thể phát hiện các ý định bắt đầu bằng văn bản CARD_CLICKED và phản hồi bằng một tải trọng JSON tuỳ chỉnh duy nhất chứa hành động thích hợp.
  • Tính năng xem trước đường liên kết không được hỗ trợ.
  • Nếu chỉ phản hồi bằng một thông báo, thì thông báo đó sẽ được gửi đến Google Chat một cách đồng bộ. Nếu tác nhân Dialogflow phản hồi bằng nhiều tin nhắn, thì tất cả các tin nhắn sẽ được gửi đến Chat không đồng bộ bằng cách gọi phương thức create trên tài nguyên spaces.messages trong Chat API một lần cho mỗi tin nhắn.
  • Khi sử dụng tính năng tích hợp Dialogflow CX với Chat, bạn phải thiết lập tác nhân Dialogflow và ứng dụng Chat trong cùng một dự án Google Cloud. Nếu cần thiết lập Dialogflow và Chat trong các dự án trên đám mây khác nhau, thì bạn có thể thiết lập một máy chủ trung gian để tạo điều kiện thuận lợi cho việc kết nối. Để tìm hiểu cách thực hiện, hãy xem Ví dụ về tính năng tích hợp Chat cho Dialogflow CX này trên GitHub.

Khắc phục sự cố

Khi một ứng dụng Google Chat hoặc thẻ trả về lỗi, giao diện Chat sẽ hiển thị thông báo "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng Chat không hiển thị bất kỳ thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat lại tạo ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.

Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng Chat, nhưng bạn có thể sử dụng thông báo lỗi mô tả và dữ liệu nhật ký để khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho ứng dụng Chat. Để được trợ giúp xem, gỡ lỗi và khắc phục lỗi, hãy xem bài viết Khắc phục lỗi trong Google Chat.

Dọn dẹp

Để tránh phát sinh phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được dùng trong hướng dẫn này, bạn nên xoá dự án trên Cloud.

  1. Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào Trình đơn > IAM và Quản trị > Quản lý tài nguyên.

    Chuyển đến Resource Manager

  2. Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào biểu tượng Xoá .
  3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.
  • Dialogflow CX sử dụng phương pháp máy trạng thái để thiết kế tác nhân Dialogflow, giúp bạn kiểm soát rõ ràng và tường minh một cuộc trò chuyện, mang lại trải nghiệm tốt hơn cho người dùng cuối và quy trình phát triển hiệu quả hơn. Khi tạo một ứng dụng trò chuyện Dialogflow, bạn nên sử dụng Dialogflow CX.
  • Dialogflow ES là một cách khác để sử dụng Dialogflow với một ứng dụng Chat.