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 xây dựng một ứng dụng Google Chat vừa có thể hiểu vừa có thể trả lời bằng ngôn ngữ tự nhiên thông qua Dialogflow. Hướng dẫn này sử dụng Dialogflow CX, tích hợp trực tiếp với Google Chat trong Bản dùng thử cho nhà phát triển. Bạn cũng có thể sử dụng Dialogflow ES để tạo ứng dụngDialogflow ES Google Chat bằng cách làm theo hướng dẫn Dialogflow ES Google Chat.

Ví dụ: hãy xem xét một ứng dụng trong Chat giúp mọi người thuê ô tô. Người dùng có thể viết: "Tôi muốn thuê một chiếc xe ô tô". Ứ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?" bắt đầu một cuộc trò chuyện giống như con người với người dùng, trong đó ứng dụng Chat đều hiểu và trả lời bằng giọng nói của con người khi đặt thuê xe.

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

  • Đặt vé máy bay
  • Đặt lịch hẹn với bác sĩ
  • Đặt dịch vụ giao đồ ăn
  • 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ư có mặt hàng có màu khác hay không
  • Trang chọn nhân viên hỗ trợ Dialogflow tạo sẵn.
    Hình 1. Chọn một nhân viên hỗ trợ tạo sẵn cho ứng dụng Dialogflow Chat.
  • Thử nghiệm nhân viên hỗ trợ trong Dialogflow CX.
    Hình 2. Thử nghiệm nhân viên hỗ trợ trong Dialogflow CX để đảm bảo logic và cấu hình của nhân viên hỗ trợ này 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 chủ đề liên quan đến các bước cụ thể trong cuộc trò chuyện, như việc thiết lập vị trí đón và trả cho xe cho thuê, đồng thời định cấu hình logic kết nối các trang này. Cuộc trò chuyện sẽ được thử nghiệm trong trình mô phỏng.
  • Định cấu hình ứng dụng Dialogflow Chat.
    Hình 3. Định cấu hình ứng dụng Chat để xử lý câu trả lời bằng nhân viên hỗ trợ Dialogflow CX trên trang cấu hình API Chat trong bảng điều khiển Google Cloud.
  • Thử nghiệm ứng dụng Dialogflow CX Chat
    Hình 4. Đang trò chuyện về việc đặt thuê xe bằng ứ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ợ dự án Dialogflow CX.
  • Tạo và triển khai ứng dụng Chat do tác nhân Dialogflow CX cung cấp.
  • Kiểm thử ứng dụng Chat.

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

Cấu trúc

Biểu đồ sau đây thể hiện cấu trúc của một ứng dụng trong Chat đượ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 biểu đồ trước, một người dùng tương tác với một ứng dụng Dialogflow Chat sẽ có luồng thông tin như sau:

  1. Người dùng gửi tin nhắn trong Chat đến một ứng dụng trong Chat, qua tin nhắn trực tiếp hoặc trong phòng 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 để tạo phản hồi.
  3. Nếu muốn, hãy sử dụng WebhookDialogflow, nhân viên hỗ trợ Dialogflow có thể tương tác với các dịch vụ bên thứ ba bên ngoài, chẳng hạn như hệ thống quản lý dự án hoặc công cụ bán vé.
  4. Nhân viên hỗ trợ Dialogflow sẽ gửi lại phản hồi cho dịch vụ ứng dụng Chat trong Chat.
  5. Câu trả lời sẽ được gửi đến phòng Chat.

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

Trước khi sử dụng các API của Google, bạn cần bật những API đó trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án trên Google Cloud.
  1. Trong bảng điều khiển Google Cloud, hãy bật API Google Chat và API Dialogflow.

    Bật API

  2. Xác nhận rằng bạn đang bật API trong đúng dự án Google Cloud, sau đó nhấp vào Next (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ợ dự án Dialogflow CX

Tác nhân Dialogflow CX là một tác nhân ả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, hiểu được sắc thái ngôn ngữ của con người. Dialogflow dịch văn bản của người dùng cuối trong một 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à xây dựng một nhân viên hỗ trợ Dialogflow để xử lý các loại cuộc trò chuyện cần thiết cho hệ thống của bạn.

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

Dưới đây là cách tạo nhân viên hỗ trợ dự án Dialogflow CX:

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

    Chuyển đến bảng điều khiển Dialogflow CX

  2. Chọn một dự án trong Google Cloud. Để tìm dự án của mình, bạn có thể cần phải nhấp vào All (Tất cả) rồi tìm kiếm dự án đó.

  3. Giờ đây, bạn có thể chọn một tác nhân 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ề việc tuỳ chỉnh tác nhân sau này, hãy chọn một trong các tác nhân hỗ trợ tạo sẵn. Các tác nhân này cũng rất hữu ích khi tìm hiểu về những việc tác nhân có thể làm.

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

    1. Nhấp vào Sử dụng tác nhân tạo sẵn.
    2. Chọn một nhân viên hỗ trợ tạo sẵn. Đối với hướng dẫn này, hãy chọn phần Du lịch: thuê xe.

      Nhân viên hỗ trợ được đánh giá là người mới bắt đầu, trung cấp hoặc 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 độ tinh vi của logic trò chuyện. Khi chọn nhân viên hỗ trợ trung cấp hoặc nâng cao, bạn có thể phải tuỳ chỉnh và cài đặt riêng cho nhân viên hỗ trợ, bao gồm cả việc bật các tính năng và API trong bảng điều khiển Google Cloud.

    3. Nhấp vào Nhập với tư cách tác nhân.

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

    1. Nhấp vào Tạo nhân viên hỗ trợ.
    2. Chọn Tự động tạo để tạo tác nhân lưu trữ dữ liệu hoặc chọn Tạo tác nhân của riêng bạn để tạo các loại tác nhân đại lý khác.

    Để xem hướng dẫn từng bước chi tiết về quy trình xây dựng nhân viên hỗ trợ, hãy xem bài viết Tạo nhân viên hỗ trợ Dialogflow CX.

  4. Định cấu hình các chế độ cài đặt cơ bản về nhân viên hỗ trợ:

    1. Trong mục Tên hiển thị, hãy nhập một tên hiển thị.
    2. Chọn vị trí mà 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 nhân viên hỗ trợ. Bạn không thể thay đổi ngôn ngữ mặc định cho nhân viên hỗ trợ sau khi tạo.
  5. Nhấp vào Tạo. Dialogflow CX bắt đầu tạo nhân viên hỗ trợ, sau đó hiển thị quy trình bắt đầu mặc định của nhân viên hỗ trợ đó.

  6. Tuỳ chỉnh nhân viên hỗ trợ (không bắt buộc). Để biết hướng dẫn từng bước chi tiết về quy trình tuỳ chỉnh của nhân viên hỗ trợ, hãy xem bài viết Tạo một nhân viên hỗ trợ Dialogflow CX.

  7. Cách tốt nhất là kiểm thử nhân viên hỗ trợ:

    1. Nhấp vào Kiểm thử tác nhân.
    2. Chọn Kiểm thử tác nhân trong môi trường.
    3. Trong mục Môi trường, hãy chọn Bản nháp.
    4. Trong Quy trình, chọn Luồng bắt đầu mặc định.
    5. Trong trang, chọn Trang chủ.
    6. Trong thanh soạn thư Trò 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ợ trả lời bằng cách tự giới thiệu.
    7. Hoàn tất thử nghiệm bằng cách tham gia cuộc trò chuyện mẫu trong thử nghiệm.
  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 biểu tượng Trình đơn > Dialogflow CX.

    Chuyển đến bảng điều khiển Dialogflow CX

  9. Trong phần Nhân viên hỗ trợ, hãy nhấp vào > Sao chép tên. Lưu tên này, vì bạn sẽ 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 rồi kết nối ứng dụng đó với nhân viên hỗ trợ Dialogflow

Sau khi tạo một nhân viên hỗ trợ dự án Dialogflow CX, hãy làm theo các bước sau để chuyển nhân viên hỗ trợ đó thành một ứng dụng Chat:

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến API Google Chat. Tìm "Google Chat API" rồi nhấp vào Google Chat API, sau đó nhấp vào Manage (Quản lý).

    Chuyển đến API Chat

  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 Mô tả, hãy nhập Responds to real human conversation.
    4. Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1 rồi chọn Tham gia không gian và cuộc trò chuyện nhóm.
    5. Trong phần Cài đặt kết nối, hãy chọn Dialogflow.
    6. Trong phần Settings (Cài đặt hộp thoại), hãy chọn Dialogflow CX.
    7. Trong mục Tê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.
    9. Trong phần Logs (Nhật ký), hãy chọn Log error to Logging (Ghi nhật ký 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 Dialogflow CX Chat 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 tự thêm mình làm người kiểm tra đáng tin cậy.

    Truy cập Google Chat

  2. Nhấp vào Cuộc trò chuyện mới.
  3. Trong trường Thêm 1 hoặc nhiều người, hãy nhập tên ứng dụng trong Chat.
  4. Chọn ứng dụng Chat của bạn 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 phản hồi bằng cách tự giới thiệu.

  6. Hoàn tất kiểm thử bằng cách tham gia cuộc trò chuyện mẫu thử nghiệm.

Cuộc trò chuyện mẫu về thử nghiệm

Để kiểm thử ứng dụng Dialogflow CX Chat trong bảng điều khiểnDialogflow CX hoặc trong Google Chat, hãy trao đổi như sau. Phần giải thích này giúp bạn hiểu cách nhân viên hỗ trợ Dialogflow CX diễn giải ngôn ngữ tự nhiên của người dùng và đưa ra phản hồi bằng ngôn ngữ tự nhiên ở mỗi bước trong cuộc trò chuyện. Cuộc trò chuyện mẫu này dựa trên nhân viên hỗ trợ tạo sẵn có tên là Travel: 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 hỗ trợ cho thuê ô tô ảo. Tôi có thể giúp bạn bắt đầu một yêu cầu thuê ô tô mới. Tôi có thể hỗ trợ gì cho bạn hôm nay?
  1. Tuyến Ý định chào mừng mặc định trong Luồng bắt đầu mặc định sẽ được gọi.
  2. Phương thức thực hiện cho trình xử lý trạng thái này ("Xin chào! Tôi là...") sẽ được thêm vào hàng đợi phản hồi.
  3. Nhân viên hỗ trợ 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 lấy xe ở đâu?
  1. Tuyến theo ý định car_rental.reservation_create trong Trang chủ được so khớp.
  2. Phiên hoạt động này sẽ chuyển sang trang Vị trí đón khách.
  3. Biểu mẫu trang Vị trí đến lấy hàng chưa hoàn chỉnh, vì vậy, nhân viên hỗ trợ sẽ sử dụng thông 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. Nhân viên hỗ trợ 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, đơn vị đón bạn sẽ đến tại Las Vegas.
Nhân viên hỗ trợ: Địa điểm trả xe của bạn có khác với vị trí đến lấy hàng không?
  1. Thông tin do người dùng cuối nhập sẽ điền thông số pickup_location mà nhân viên hỗ trợ yêu cầu trong lượt trò chuyện trước đó.
  2. Tuyến ý định car_rental.return_different_location trong Luồng bắt đầu mặc định được so khớp.
  3. Tuyến đường hoàn thành biểu mẫu trên trang Vị trí đến lấy sẽ được đánh giá và gọi. Phương thức này có phương thức thực hiện ("Ok, đến lấy hàng..."). Phương thức này được thêm vào hàng đợi phản hồi cùng các tham số tham chiếu được phân giải thành giá trị thực tế 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ó phương thức thực hiện mục nhập ("Địa điểm trả khách của bạn có khác..."), được thêm vào hàng đợi phản hồi.
  6. Nhân viên hỗ trợ 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, chúng tôi sẽ trả khách tại 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. Tuyến ý định car_rental.return_different_location trong Luồng bắt đầu mặc định được so khớp.
  2. Phiên hoạt động sẽ chuyển sang trang Vị trí trả xe.
  3. Thông tin do người dùng cuối nhập sẽ điền thông số drop_off_location mà nhân viên hỗ trợ yêu cầu trong lượt trò chuyện trước đó.
  4. Quy trình hoàn thành biểu mẫu trên trang Vị trí bỏ ngang sẽ được đánh giá và gọi. Phương thức này có phương thức thực hiện ("Ok, trả hàng...") và phương thức này được thêm vào hàng đợi phản hồi.
  5. Phiên hoạt động sẽ chuyển sang trang Thời lượng thuê.
  6. Trang Thời gian thuê có giá trị biểu mẫu chưa hoàn chỉnh, nên trang sẽ nhắc người dùng nhập thông số pickup_date_time ("Bạn muốn đến lấy hàng vào ngày và giờ nào..."), được thêm vào hàng đợi phản hồi.
  7. Nhân viên hỗ trợ 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 trả xe vào ngày và giờ nào?
  1. Thông tin do người dùng cuối nhập sẽ điền thông số pickup_date_time mà nhân viên hỗ trợ yêu cầu trong lượt trò chuyện trước đó.
  2. Trang Thời gian thuê còn thiếu một giá trị biểu mẫu khác, vì vậy, trang này nhắc người dùng nhập thông số drop_off_date_time ("Bạn muốn bỏ qua ngày và giờ nào..."), được thêm vào hàng đợi phản hồi.
  3. Nhân viên hỗ trợ gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Vào trưa ngày 15 tháng 3.
Nhân viên hỗ trợ: Vui lòng xác nhận:

Bạn sẽ đến lấy xe tại Las Vegas 12:00:00 và trả xe tại Los Angeles 2024-03-15 12:00:00

Bạn có đồng ý không?
  1. Thông tin do người dùng cuối nhập sẽ điền thông số drop_off_date_time mà nhân viên hỗ trợ yêu cầu trong lượt trò chuyện trước đó.
  2. Phiên hoạt động sẽ chuyển sang trang Xác nhận thời lượng thuê.
  3. Trang Xác nhận thời lượng thuê có một phương thức thực hiện mục nhập ("Vậy nên để xác nhận..."), được thêm vào hàng đợi phản hồi.
  4. Nhân viên hỗ trợ 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! Giờ hãy chọn một chiếc xe.
Nhân viên hỗ trợ: Bạn muốn chọn xe hạng phổ thông hay xe sang?
  1. Tuyến ý định small_talk.confirmation.yes trên trang small_talk.confirmation.yes đã khớp.
  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 thông báo ("Tuyệt vời! Giờ hãy chọn..."), được thêm vào hàng đợi phản hồi.
  3. Phiên này chuyển sang trang Phân biệt xe.
  4. Biểu mẫu trang Phân biệt xe chưa hoàn chỉnh, vì vậy, nhân viên hỗ trợ sẽ sử dụng thông số vehicle_type để nhắc người dùng ("Bạn muốn phân biệt xe phổ thông hay hạng sang..."), được thêm vào hàng đợi phản hồi.
  5. Nhân viên hỗ trợ gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Nên dùng nền kinh tế.
Nhân viên hỗ trợ: Bạn thích xe Cymbal hay xe Cymbal?
  1. Tuyến ý định $session.params.vehicle_type="economy_vehicle" đã khớp.
  2. Phiên hoạt động sẽ chuyển sang trang Các lựa chọn về hoạt động kinh tế.
  3. Trang Lựa chọn tiết kiệm có cách thực hiện mục nhập ("Bạn có muốn..."), được thêm vào hàng đợi phản hồi.
  4. Nhân viên hỗ trợ gửi hàng đợi phản hồi cho người dùng cuối.
Người dùng cuối: Xe tải chũm chọe.
Nhân viên hỗ trợ: Xe Cymbal có giá 50,33 USD mỗi ngày. Thiết bị này dành cho 4 người và có đài phát thanh AM/FM. Bạn có muốn tiếp tục thanh toán không?
Người dùng cuối: Có.
  1. Lộ trình theo ý định $session.params.vehicle_type="Cymbal Truck" đã khớp và thông số vehicle_model đã được điền.
  2. Phiên này chuyển sang trang Xác nhận xe tải chũm chọe.
  3. Trang Xác nhận xe tải Cymbal có phương thức thực hiện mục nhập ("Xe Cymbal 50,33 USD mỗi ngày..."), được thêm vào hàng đợi phản hồi.
  4. Nhân viên hỗ trợ gửi hàng đợi phản hồi cho người dùng cuối.
  5. Phản hồi của người dùng khớp với tuyến 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 hỗ trợ: 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 hỗ trợ: Bạn sẽ đến đón xe Cymbal tại Las Vegas, 12:00:00 ngày 5/3/2024 và trả xe, 12:00:00 ngày 15/3/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ê dịch vụ và chúc bạn một ngày tốt lành!
  1. Phiên hoạt động này sẽ chuyển sang trang Thanh toán.
  2. Biểu mẫu Thanh toán chưa hoàn chỉnh nên nhân viên hỗ trợ sẽ nhắc người dùng nhập các thông số card_type, card_number, billing_name, billing_street_addressbilling_zip_code ("Loại thẻ nào..."), được thêm tuần tự vào hàng đợi phản hồi và được gửi khi người dùng phản hồi. Phản hồi của người dùng đặt từng giá trị thông số.
  3. Phiên này sẽ chuyển sang trang Xác nhận cho thuê.
  4. Trang Xác nhận cho thuê có một phương thức thực hiện mục nhập ("Ok, đến lấy hàng sẽ được..."), được thêm vào hàng đợi phản hồi.
  5. Nhân viên hỗ trợ gửi hàng đợi phản hồi cho người dùng cuối.
  6. Phiên hoạt động sẽ chuyển sang trang Kết thúc phiên.

Gửi tin nhắn 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 thông báo thẻ, hãy chỉ định thông báo đó ở dạng tải trọng tuỳ chỉnh trong phương thức phương thức thực hiện.

Tệp JSON sau đây minh hoạ cách gửi thông báo thẻ dưới dạng tải trọng tuỳ chỉnh trong phương thức 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à cân nhắc

  • Sự kiện tương tác trò chuyện có hỗ trợ hạn chế và một số điểm cần cân nhắc:
    • Các loại sự kiện tương tác sau đây được hỗ trợ:
      • MESSAGE
      • ADDED_TO_SPACE
    • Mục nhập truy vấn mà bạn gửi cho nhân viên hỗ trợ Dialogflow tương ứng với giá trị của trường argumentText trong tin nhắn trong Chat. Nếu thông báo có lệnh dấu gạch chéo, thì giá trị của trường text sẽ được dùng.
    • Tải trọng JSON đầy đủ của mỗi sự kiện tương tác với Chat sẽ được gửi tới Dialogflow dưới dạng tải trọng tuỳ chỉnh trong tham số truy vấn và bạn có thể truy cập vào bằng webhookDialogflow bằng cách truy vấn giá trị của trường WebhookRequest.payload.
  • Lệnh slash hỗ trợ hạn chế:
    • Các ứng dụng Dialogflow không hỗ trợ các lệnh dấu gạch chéo để mở hộp thoại.
    • Khi các ứng dụng Dialogflow Chat nhận được một tin nhắn có lệnh dấu gạch chéo, nội dung nhập vào cụm từ tìm kiếm chỉ chứa giá trị của trường text. 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ể sử dụng lệnh này để định cấu hình ý định của tác nhân Dialogflow nhằm phát hiện lệnh dấu gạch chéo.
    • Nếu nhân viên hỗ trợ Dialogflow cần xử lý tải trọng sự kiện tương tác trên Chat của lệnh gạch chéo lên, thì nhân viên hỗ trợ có thể thực hiện bằng cách sử dụng webhook của Dialogflow để kiểm tra tải trọng tuỳ chỉnh trong tham số truy vấn.
  • Không hỗ trợ Bản xem trước đường liên kết.
  • Nếu nhân viên hỗ trợ Dialogflow trả lời chỉ bằng một tin nhắn, thì tin nhắn đó sẽ được gửi đồng bộ đến Google Chat. Nếu nhân viên hỗ trợ Dialogflow phản hồi bằng nhiều tin nhắn, thì tất cả tin nhắn sẽ được gửi tới 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 API Chat một lần cho mỗi tin nhắn.

Khắc phục sự cố

Khi ứ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 của Chat không hiển thị thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat cho 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 hiển thị trong giao diện người dùng Chat, nhưng chúng tôi cung cấp dữ liệu nhật ký và thông báo lỗi mô tả để giúp bạn khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat. Để được trợ giúp về việc xem, gỡ lỗi và sửa lỗi, hãy xem phần Khắc phục sự cố và sửa lỗi trên Google Chat.

Dọn dẹp

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

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào biểu tượng Trình đơn > IAM & Admin (IAM và quản trị viên) > Quản lý tài nguyên.

    Chuyển đến Trình quản lý tài nguyên

  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 Shut Down (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à rõ ràng đối với một cuộc trò chuyện, mang lại trải nghiệm người dùng cuối tốt hơn và quy trình phát triển tốt hơn. Khi tạo ứng dụng Dialogflow Chat, bạn nên sử dụng Dialogflow CX.
    • Để tìm hiểu thêm về cách xây dựng và định cấu hình nhân viên hỗ trợ, hãy xem Dialogflow CX Agents.
    • Để xem hướng dẫn từng bước chi tiết về cách tạo và định cấu hình tác nhân, hãy xem bài viết Tạo tác nhân Dialogflow CX.
  • Dialogflow ES là một cách khác để sử dụng Dialogflow với ứng dụng Chat.