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ê một chiếc ô tô". Ứng dụng Chat có thể phản hồ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ư con người với người dùng, trong đó ứng dụng Chat vừa hiểu vừa phản hồ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ó giọng nói tự nhiên của con người, thì bạn cần có một ứng dụng Dialogflow Chat. Các đặc vụ đượ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 vé máy 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 mặt hàng có màu khác hay không
  • Trang chọn tác nhân Dialogflow được tạo sẵn.
    Hình 1. Chọn một tác nhân được tạo sẵn cho ứng dụng Chat trên Dialogflow.
  • Kiểm thử tác nhân 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 vị trí 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 Chat để 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 của Dialogflow CX
    Hình 4. Trò chuyện về việc đặt xe cho thuê với ứng dụng Chat của Dialogflow trong Google Chat.

Mục tiêu

  • Thiết lập môi trường.
  • Tạo và triển khai một tác nhân Dialogflow CX.
  • Tạo và triển khai một ứng dụng Chat dựa trên tác nhân 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 xây dựng 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 trợ lý ảo Dialogflow (nằm trong Google Cloud) sẽ nhận và xử lý tin nhắn để tạo ra câu trả lời.
  3. Nếu muốn, bằng cách sử dụng webhook Dialogflow, 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 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 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 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 trên đám mây chính xác, rồi 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 tác nhân 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 sắc thái của ngôn ngữ 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 tổng đà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 huấn luyện quá rõ ràng.

Sau đây là cách tạo tác nhân 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 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 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ự tạo tác nhân. Nếu bạn muốn tìm hiểu chi tiết về cách tuỳ chỉnh tác nhân sau này, hãy chọn một trong các tác nhân được tạo sẵn. Các tác nhân này cũng hữu ích để tìm hiểu về những việc mà tác nhân 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. Đối với 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 hỗ trợ.

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

    1. Nhấp vào Tạo trợ lý ảo.
    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 xây dựng tác nhân, hãy xem bài viết Tạo 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ị quy trình bắt đầu mặc định của tác nhân.

  6. Bạn có thể tuỳ chỉnh tác nhân (không bắt buộc). Để xem hướng dẫn chi tiết về quy trình tuỳ chỉnh tác nhân, hãy xem bài viết Tạo tác nhân Dialogflow CX.

  7. Tốt nhất là bạn nên kiểm thử tác nhân:

    1. Nhấp vào Kiểm thử tác nhân.
    2. Chọn Test agent in environment (Kiểm thử tác nhân trong môi trường).
    3. Trong phần 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 nhắn Nói chuyện với nhân viên hỗ trợ, hãy nhập Hello rồi nhấn phím Enter. Tác nhân sẽ tự giới thiệu khi phản hồ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. Tác nhân 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.

    Chuyển đến 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). 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 tác nhân Dialogflow

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

  1. Trong bảng điều khiển Google Cloud, 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 phần Tên ứng dụng, hãy nhập Dialogflow App.
    2. Trong URL của hình đại diện, hãy nhập https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    3. Trong phần Description (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 Dialogflow settings (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 một số 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 phần 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 thử nghiệm đáng tin cậy.

    Chuyển đến 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 ứng dụng Chat của bạn.

  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 Chat Dialogflow 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.

Hội thoại 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 thực hiện cuộc trò chuyện 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 tác nhân được tạo sẵn có tên là Du lịch: thuê ô tô.

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. Yêu cầu 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. Tác nhân 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ê ô 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 nhận hàng.
  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. Tác nhân 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ợ: Vâng, bạn sẽ đến lấy hàng ở Las Vegas.
Nhân viên hỗ trợ: Địa điểm trả khách có khác với địa điểm đón khách 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 Quy trình 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 hàng sẽ đượ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 sẽ chuyển sang trang Xác nhận vị trí.
  5. Trang Xác nhận vị trí có một mục nhập 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. Tác nhân 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ợ: Vâng, 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 Quy trình bắt đầu mặc định được so khớp.
  2. Phiên này sẽ chuyển sang trang Vị trí thả.
  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. Tuyến đường hoàn tất biểu mẫu trong trang Drop Off Location (Vị trí trả hàng) đượ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. Tác nhân 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 lấy 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. Tác nhân 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 lúc 12:00:00 ngày 5 tháng 3 năm 2024 và trả xe ở Los Angeles vào lúc 12:00:00 ngày 15 tháng 3 năm 2024

Thông tin này có đúng 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 hạn thuê có một mục hoàn tất việc nhập ("Để xác nhận..."), được thêm vào hàng đợi phản hồi.
  4. Tác nhân 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 hạng phổ thông hay hạng sang?
  1. Ý định small_talk.confirmation.yes trong tuyến Xác nhận thời gian thuê trên trang được so 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 tin nhắn ("Tuyệt vời! Giờ chúng ta hãy chọn..."), được thêm vào hàng đợi phản hồi.
  3. Phiên này sẽ 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. Tác nhân 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 gói tiết kiệm.
Nhân viên: Bạn muốn chiếc 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. Tác nhân 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 hỗ trợ: Xe Cymbal Truck có giá 50,33 USD mỗi ngày. Xe này có thể chở 4 người và có đài AM/FM. Bạn có muốn chuyển sang bước thanh toán không?
Người dùng cuối: Vâng, vui lòng cho phép.
  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 xe tải chở đàn cymbal) có một mục thực hiện yêu cầu ("The Cymbal Truck is $50.33 per day..." (Xe tải chở đàn cymbal có giá 50,33 USD/ngày...)), được thêm vào hàng đợi phản hồi.
  4. Tác nhân 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ã ZIP 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ê xe của chúng tôi và 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 tác nhân nhắc người dùng cung cấp các thông 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. Câu trả lời của người dùng sẽ đặt từng giá trị tham 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 mục thực hiện yêu cầu ("Ok, your pickup will be..." (Ok, bạn sẽ đến lấy xe vào...)), được thêm vào hàng đợi phản hồi.
  5. Tác nhân 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 thông báo 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 dạng thẻ, hãy chỉ định thông báo đó là một tải trọng tuỳ chỉnh trong hoạt động thực hiện.

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

json

{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
  "message": { "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"
        }}
      }]}}]}]
    }
  }]}
}}}}

Hạn mức và lưu ý

  • Khi sử dụng các ứng dụng Google Chat với Dialogflow, các đối tượng sự kiện Chat có những hạn chế và điểm cần cân nhắc sau:
    • Sự kiện trên trang chủ của ứng dụng: Chúng tôi hiện chưa hỗ trợ sự kiện APP_HOME.
    • Đầu vào truy vấn Dialogflow: Văn bản được gửi dưới dạng đầu vào truy vấn đến tác nhân Dialogflow tuỳ thuộc vào loại sự kiện:
      • MESSAGE: Giá trị của trường argumentText trong tin nhắn trò chuyện.
      • APP_COMMAND: Chuỗi "APP_COMMAND_PAYLOAD".
      • ADDED_TO_SPACE: Chuỗi "ADDED_TO_SPACE_PAYLOAD".
      • REMOVED_FROM_SPACE: Chuỗi "REMOVED_FROM_SPACE_PAYLOAD".
      • CARD_CLICKED: Chuỗi "BUTTON_CLICKED_PAYLOAD".
      • WIDGET_UPDATED: Chuỗi "WIDGET_UPDATED_PAYLOAD" (dùng cho tính năng tự động hoàn thành).
    • Tải trọng sự kiện đầy đủ: Tải trọng JSON đầy đủ của sự kiện Tương tác qua tin nhắn được gửi đến Dialogflow trong trường WebhookRequest.payload. Bạn có thể truy cập vào phần này trong webhook Dialogflow. Để biết thêm thông tin, hãy xem tài liệu về yêu cầu webhook của Dialogflow CX.
  • Những điểm cần lưu ý khi phản hồi lệnh và nhận dữ liệu từ thẻ hoặc hộp thoại:
  • Không hỗ trợ bản xem trước đường liên kết.
  • Nếu tác nhân Dialogflow chỉ phản hồi bằng một tin nhắn, thì tin nhắn đó sẽ được gửi đến Google Chat một cách đồng bộ. 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 đến Chat một cách 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 chế độ 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 trê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ố

Để gỡ lỗi ứng dụng Chat, hãy bắt đầu bằng cách xem xét nhật ký lỗi. Vì ứng dụng này sử dụng Dialogflow, nên bạn có thể sử dụng một số tài nguyên ghi nhật ký và khắc phục sự cố:

  • Nhật ký về tiện ích bổ sung của Google Workspace: Nhật ký truy vấn để biết thông tin chi tiết về hành vi của ứng dụng Chat, bao gồm cả các hoạt động tương tác của ứng dụng này với Chat. Xem Nhật ký truy vấn cho Tiện ích bổ sung Google Workspace.

  • Lỗi ứng dụng Google Chat: Để biết thông tin chung về thông báo lỗi và cách khắc phục lỗi ứng dụng Chat, hãy tham khảo bài viết Khắc phục sự cố và sửa lỗi ứng dụng Chat.

  • Cloud Logging của Dialogflow CX: Đảm bảo bạn đã bật Cloud Logging trong chế độ cài đặt tác nhân Dialogflow để ghi lại nhật ký thực thi chi tiết, bao gồm cả lỗi từ tác nhân và các lượt tương tác webhook. Tìm hiểu cách bật và định cấu hình tính năng này trong tài liệu về phần Cài đặt tác nhân Dialogflow CX. Bạn có thể xem các nhật ký này trong Trình khám phá nhật ký của Google Cloud Console.

  • Nhật ký trò chuyện trên Dialogflow CX: Xem lại các lượt tương tác trước đây để hiểu luồng trò chuyện và xác định vị trí xảy ra vấn đề. Xem Nhật ký trò chuyện.

  • Khắc phục sự cố chung về Dialogflow: Đối với các vấn đề chung về Dialogflow, hãy tham khảo Hướng dẫn khắc phục sự cố về Dialogflow CX.

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 đám mây.

  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 xây dựng 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.

Ứng dụng nhắn tin không phải là tiện ích bổ sung: Xây dựng ứng dụng Google Chat bằng Dialogflow CX

Nếu bạn đang tạo hoặc duy trì một ứng dụng Chat không phải là tiện ích bổ sung Google Workspace, hãy lưu ý những điểm khác biệt sau đây về cấu hình, tải trọng và sự kiện.

Định cấu hình một ứng dụng Chat Dialogflow CX không phải là tiện ích bổ sung

Khi định cấu hình Google Chat API trong Google Cloud Console:

  1. Xoá lựa chọn Tạo ứng dụng Chat này dưới dạng một tiện ích bổ sung của Google Workspace. Một hộp thoại sẽ mở ra và yêu cầu bạn xác nhận. Trong hộp thoại, hãy nhấp vào Tắt.
  2. Hoàn tất các chế độ cài đặt cấu hình còn lại của Dialogflow CX rồi nhấp vào Lưu.

Gửi tin nhắn dạng thẻ từ một ứng dụng Chat Dialogflow CX không phải là tiện ích bổ sung

Trong một ứng dụng Chat không phải là tiện ích bổ sung, hãy chỉ định một đối tượng cardsV2 cấp cao nhất trong tải trọng tuỳ chỉnh của Dialogflow trong dịch vụ thực hiện yêu cầu:

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 đối với các ứng dụng Chat Dialogflow CX không phải là tiện ích bổ sung

  • Sự kiện tương tác trong cuộc trò chuyện có những điểm hỗ trợ và lưu ý sau:
    • Các loại sự kiện tương tác sau đây được hỗ trợ:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • Đối với các sự kiện MESSAGE hoặc ADDED_TO_SPACE, dữ liệu đầu vào của 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ó chứa một lệnh dấu gạch chéo, thì giá trị của trường text sẽ được sử 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 Thao tác đượ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 trong cuộc trò chuyện đượ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 trong Các ứng dụng Chat không phải là tiện ích bổ sung:
    • Khi các ứng dụng Dialogflow Chat không phải là tiện ích bổ sung nhận được một thông báo có lệnh dấu gạch chéo, đầu vào truy vấn 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ể 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.
    • Để hiển thị một hộp thoại từ tác nhân Dialogflow trong một ứng dụng Chat không phải là tiện ích bổ sung, 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 phản hồi DIALOG.
    • Để xử lý dữ liệu được nhập từ các thẻ trong một ứng dụng Chat không phải là tiện ích bổ sung, 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.