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à trả lời bằng ngôn ngữ tự nhiên sử dụng Dialogflow. Hướng dẫn này sử dụng Dialogflow CX, trong đó có 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 theo dõi thời gian Dialogflow ES Google Chat của chúng tôi.

Ví dụ: hãy cân nhắc 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 xe ô tô". Chiến lược phát hành đĩa đơn Ứng dụng Chat có thể trả lời bằng một câu hỏi như "Bạn muốn lấy xe ở đâu?" khởi đầu một trải nghiệm như con người cuộc trò chuyện với người dùng trong đó ứng dụng Chat có thể 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 trong Chat hữu ích trong tất cả các loại tương tác khác nhau. Nếu cần đến lời nói tự nhiên của con người, thì tính năng này cần có Ứng dụng Dialogflow Chat. Chiến lược phát hành đĩa đơn nhân viên hỗ trợ dựng 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 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ư liệu các mặt hàng có các màu khác
  • Trang chọn tác nhân Dialogflow được 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. Kiểm thử 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ợ hoạt động như dự kiến. Sơ đồ này cho thấy một loạt các trang chủ đề theo tuần tự liên quan đến các bước cụ thể trong cuộc trò chuyện, chẳng hạn như đặt vị trí nhận xe và trả lại xe cho thuê ô tô, đồng thời định cấu hình logic kết nối các trang này. Cuộc trò chuyện được kiểm tra trong một trình mô phỏng.
  • Định cấu hình ứng dụng Dialogflow trong Chat.
    Hình 3. Thiết lập một ứng dụng trong Chat để xử lý phản hồi bằng tác nhân Dialogflow CX trên trang cấu hình API Chat trong bảng điều khiển Google Cloud.
  • Kiểm thử ứng dụng Dialogflow CX Chat
    Hình 4. 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 nhân viên hỗ trợ Dialogflow CX.
  • Tạo và triển khai ứng dụng Chat dựa trên Nhân viên hỗ trợ phiên bản CX của Dialogflow.
  • Kiểm thử ứng dụng Chat.

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

Kiến trúc

Sơ đồ dưới đây thể hiện cấu trúc của một Ứng dụng Chat được tạo bằng Dialogflow:

Cấu trúc của một ứng dụng trong 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 Dialogflow Ứng dụng Chat có luồng thông tin sau đây:

  1. Người dùng gửi tin nhắn trong Chat tới ứng dụng Chat, trong 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. (Không bắt buộc) sử dụng Webhook củaDialogflow, nhân viên hỗ trợ 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ư làm hệ thống quản lý dự án hoặc công cụ bán vé.
  4. Nhân viên hỗ trợ Dialogflow gửi phản hồi cho Dịch vụ ứng dụng Chat trong Chat.
  5. Câu trả lời đượ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 các API này 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 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 các API theo đúng cách Dự án trên đám mây, 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 nhân viên hỗ trợ Dialogflow CX

Đáp Tác nhân CX củaDialogflow 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 đọc hiểu ngôn ngữ tự nhiên hiểu được sắc thái của ngôn ngữ của con người. Dialogflow dịch văn bản của người dùng cuối khi ứng dụng và dịch vụ của bạn trò chuyện với dữ liệu có cấu trúc đều 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 bắt buộc đối với hệ thống của bạn.

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

Dưới đâ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 chuột Thực đơ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 của mình, có thể bạn cần phải nhấp vào Tất cả, rồi tìm kiếm phần tử đó.

  3. Giờ đây, bạn có thể chọn một tác nhân tạo sẵn hoặc tạo của riêng bạn. Nếu bạn muốn tìm hiểu về nhân viên hỗ trợ tùy chỉnh chi tiết sau này, hãy chọn một trong tác nhân tích hợp sẵn, những thông tin này cũng rất hữu ích khi tìm hiểu về những việc nhân viên hỗ trợ 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 nhân viên hỗ trợ tạo sẵn.
    2. Chọn một tác nhân tạo sẵn. Để xem hướng dẫn này, hãy chọn Du lịch: cho thuê ô tô.

      Nhân viên hỗ trợ được đánh giá là 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à sự phức tạp trong logic hội thoại. Chọn một tác nhân trung cấp hoặc nâng cao có thể yêu cầu tác nhân người dùng cụ thể các tính năng và chế độ cài đặt, 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 dưới dạng nhân viên hỗ trợ.

    Để 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 nhân viên hỗ trợ kho dữ liệu hoặc chọn Xây dựng đội ngũ riêng để tạo các loại nhân viên hỗ trợ 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 Tạo nhân viên hỗ trợ Dialogflow CX.

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

    1. Trong Tên hiển thị, hãy nhập một tên hiển thị.
    2. Chọn mục bạn thích vị trí. Nếu bạn muốn thay đổi cài đặt vị trí, 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 đó cho thấy quy trình bắt đầu mặc định của nhân viên hỗ trợ.

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

  7. Phương pháp hay nhất là kiểm thử tác nhân:

    1. Nhấp vào Nhân viên thử nghiệm.
    2. Chọn Kiểm thử nhân viên trong môi trường.
    3. Trong 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 trang, chọn Trang chủ.
    6. Trong thanh soạn tin nhắn 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ợ phản hồi bằng cách tự giới thiệu.
    7. Hoàn thành bài kiểm tra bằng cách tham gia mẫu cuộc trò chuyện để kiểm thử.
  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 dưới dạng mà bạn dùng khi định cấu hình ứng dụng Chat.

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

Sau khi tạo nhân viên hỗ trợ dự án Dialogflow, hãy làm theo các bước sau để biế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" và nhấp vào API Google Chat, rồi nhấp vào Quản lý.

    Truy cập 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:1Tham gia các không gian và cuộc trò chuyện nhóm.
    5. Trong phần Connection settings (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 phần Tên tài nguyên nhân viên hỗ trợ hoặc Môi trường, hãy dán nhân viên hỗ trợ Dialogflow CX tên mà bạn đã sao chép ở cuối 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 Logs (Nhật ký), hãy chọn Log lỗi to Logging (Ghi nhật ký 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 gửi tin nhắn cho ứng dụng này Google Chat.

  1. Mở Google Chat bằng tài khoản Google Workspace mà bạn khi bạn tự thêm chính 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, nhập tên của Ứng dụng Chat.
  4. Chọn ứng dụng Chat của bạn trong kết quả. Người trực tiếp tin nhắn sẽ mở ra.

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

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

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

Ví dụ về cuộc trò chuyện thử nghiệm

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

Bạn sẽ nhận xe sau Las Vegas 2024-03-05 12:00:00 và thả nó đi ở Los Angeles 15-03-2024 12:00:00

Như vậy có đúng không?
  1. Thông tin đầu vào của người dùng cuối điền vào drop_off_date_time do tác nhân yêu cầu trong cuộc trò chuyện.
  2. Phiên chuyển đổi sang trang Xác nhận thời lượng thuê.
  3. Trang Xác nhận thời lượng cho thuê có một mục nhập ("Để xác nhận...", sẽ đượ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: Đúng vậy, 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 xe hạng phổ thông hay sang trọng chiếc xe?
  1. Ý định small_talk.confirmation.yes tuyến trong trang Xác nhận thời lượng thuê là trùng 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! Bây giờ, hãy chọn..."), sẽ đượ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 trên trang Phân định xe chưa hoàn chỉnh, vì vậy tác nhân sử dụng thông số vehicle_type để nhắc người dùng ("Bạn muốn sử dụng xe tiết kiệm hay sang trọng..."), sẽ đượ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: Tiết kiệm.
Nhân viên hỗ trợ: Bạn muốn xe Cymbal hay xe Cymbal?
  1. Ý định $session.params.vehicle_type="economy_vehicle" tuyến đường phù hợp.
  2. Phiên chuyển đổi sang trang Lựa chọn tiết kiệm.
  3. Trang Lựa chọn tiết kiệm có một phương thức thực hiện mục nhập ("Bạn có muốn..."), sẽ đượ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ợ: Chi phí thuê xe Cymbal là 50,33 USD mỗi ngày. Xe có đủ chỗ cho 4 người và có đài AM/FM. Bạn có muốn tiếp tục sang bước thanh toán không?
Người dùng cuối: Có.
  1. Ý định $session.params.vehicle_type="Cymbal Download" tuyến đường được so khớp và thông số vehicle_model được điền.
  2. Phiên chuyển đổi sang trang Xác nhận xe tải Cymbal.
  3. Trang Xác nhận xe tải Cymbal có phương thức thực hiện mục nhập ("Xe tải Cymbal có giá 50,33 đô la mỗi ngày..."), sẽ đượ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 thông báo small_talk.confirmation.yes tuyến đường.
Nhân viên hỗ trợ: Bạn 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, California
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ẽ chọn Xe chũm chọe tại Las Vegas, 2024-03-05 12:00:00 và thả nó đi, 15-03-2024 12:00:00. Tổng số tiền cho chuyến đi này sẽ là 175,38 đô la Mỹ.
Nhân viên hỗ trợ: Cảm ơn bạn đã thuê dịch vụ của chúng tôi 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 tất nên nhân viên hỗ trợ sẽ nhắc người dùng cho card_type, card_number, billing_name, billing_street_address, và thông số billing_zip_code ("Loại thẻ nào sẽ..."), được thêm tuần tự vào hàng đợi phản hồi và được gửi dưới dạng người dùng phản hồi. Các câu trả lời của người dùng đặt ra từng giá trị thông số.
  3. Phiên hoạt động này sẽ chuyển sang trang Xác nhận cho thuê.
  4. Trang Xác nhận cho thuê có một yêu cầu thực hiện mục nhập ("Ok, bạn sẽ đến lấy hàng..."), sẽ đượ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 sẽ chuyển đổi 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 văn bản hoặc thẻ thư. Cách trả lời bằng thẻ hãy chỉ định email đó là tải trọng tuỳ chỉnh inch phương thức thực hiện.

JSON sau đây cho biết cách gửi thông báo thẻ dưới dạng một 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à có một số điểm cần cân nhắc:
    • Nội dung sau đây các loại sự kiện tương tác được hỗ trợ:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • Đối với các sự kiện MESSAGE hoặc ADDED_TO_SPACE, mục nhập 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 trong Chat. Nếu thông báo chứa lệnh dấu gạch chéo, giá trị của trường text sẽ được sử dụng thay thế.
    • Đối với các sự kiện CARD_CLICKED, thông tin đầu vào về cụm từ tìm kiếm sẽ được gửi cho nhân viên hỗ trợ dự án Dialogflow được định dạng là CARD_CLICKED.functionName, trong đó functionName tương ứng với giá trị của trường function của Đối tượng Hành động được đính kèm vào phần tử thẻ tương tác (như một nút).
    • Tải trọng JSON đầy đủ của mỗi sự kiện tương tác trong Chat được gửi đến Dialogflow dưới dạng một tải trọng tuỳ chỉnh trong thông số truy vấn và có thể truy cập bằng Webhook củaDialogflow 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éonhận dữ liệu từ thẻ hoặc hộp thoại:
    • Khi các ứng dụng Dialogflow trong Chat nhận được tin nhắn có dấu gạch chéo thì đầu vào của 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) mà bạn có thể dùng để định cấu hình ý định của nhân viên hỗ trợ Dialogflow để 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 JSON sự kiện tương tác trong Chat, ứng dụng có thể thực hiện điều đó bằng cách sử dụng Webhook củaDialogflow để kiểm tra tải trọng tuỳ chỉnh trong thông số truy vấn.
    • Để hiển thị hộp thoại từ Nhân viên hỗ trợ Dialogflow, phản hồi bằng một tải trọng JSON tùy chỉnh duy nhất bao gồm một tin nhắn chứa DIALOG phản hồi hành động.
    • Để xử lý dữ liệu được nhập từ các thẻ, nhân viên hỗ trợ Dialogflow có thể phát hiện ý định bắt đầu bằng văn bản CARD_CLICKED và phản hồi bằng tải trọng JSON tuỳ chỉnh phù hợp hành động.
  • Không hỗ trợ tính năng 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 đó được gửi đến Google Chat một cách đồng bộ. Nếu nhân viên hỗ trợ Dialogflow trả lời có nhiều tin nhắn, thì tất 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 API Chat một lần cho mỗi .
  • Khi dùng công cụ tích hợp Dialogflow CX với Chat, bạn phải đặt nhân viên hỗ trợ Dialogflow và ứng dụng Chat trong cùng một dự án Google Cloud. Nếu bạn cần thiết lập Dialogflow và Chat trong nhiều dự án Cloud, thì bạn có thể thiết lập một máy chủ trung gian để tạo điều kiện cho việc kết nối. Để tìm hiểu cách thực hiện, xem cái này Ví dụ về công cụ tích hợp Chat cho Dialogflow CX trên GitHub.

Khắc phục sự cố

Khi một ứng dụng Google Chat hoặc card trả về một lỗi, thì phương thức Giao diện Chat hiển thị một thông báo với nội dung "Đã 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ông báo lỗi nào ngoài ứng dụng Chat hoặc thẻ 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, thông báo lỗi mô tả và dữ liệu nhật ký luôn có sẵn để giúp bạn sửa lỗi khi tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat được bật. Để được trợ giúp xem, gỡ lỗi và sửa lỗi, hãy xem Khắc phục lỗi và khắc phục lỗi của Google Chat.

Dọn dẹp

Để tránh phát sinh phí đối với tài khoản Google Cloud của bạn cho tài nguyên được sử dụng trong hướng dẫn này, chúng tôi khuyên bạn nên xóa Dự án trên đám mây.

  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 chuột Thực đơn > 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 mà bạn muốn xoá rồi nhấp vào 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ẽ lấy máy trạng thái phương pháp tiếp cận thiết kế tác nhân Dialogflow, cho bạn biết rõ ràng và kiểm soát cuộc trò chuyện, trải nghiệm người dùng cuối tốt hơn và trong quy trình phát triển. Khi tạo Dialogflow Ứng dụng Chat, bạn nên dùng Dialogflow CX.
  • Dialogflow ES là một cách khác để dùng Dialogflow với ứng dụng Chat.