Tổng quan về SDK Hành động (Dialogflow)

Actions on Google cho phép bạn mở rộng chức năng của Trợ lý Google bằng Thao tác. Hành động cho phép người dùng hoàn tất công việc thông qua giao diện trò chuyện có thể bao gồm một lệnh nhanh như bật một số đèn hay trò chuyện, chẳng hạn như chơi trò đố vui.

SDK Hành động là một phương thức phát triển phương thức thực hiện cuộc trò chuyện mà không cần bằng Dialogflow. Khi sử dụng SDK Hành động, bạn cần dùng một Gói Hành động để liên kết ý định với phương thức thực hiện của chúng. Bạn cũng phải cung cấp mẫu truy vấn trong Gói hành động để xác định các cụm từ mẫu mà người dùng có thể nói.

CLI của gaction

Khi phát triển bằng SDK Hành động, bạn sử dụng dòng lệnh gactions (CLI) để kiểm tra và cập nhật dự án Actions của bạn. gactions CLI cũng giúp bạn tạo và quản lý gói Hành động cho Hành động trò chuyện.

Tạo Actions trong gói Hành động

Bạn tạo Hành động trong gói Hành động bằng cách liên kết các ý định đến phương thức thực hiện. Mỗi Hành động xác định một điểm truy cập để bắt đầu cuộc trò chuyện bằng một điểm truy cập duy nhất có tên là intent (ý định). Ý định liên kết với các phương thức thực hiện, giúp xử lý ý định.

Ví dụ: giả sử bạn muốn tạo một dự án có chứa Actions to mua một số hàng hoá, kiểm tra trạng thái đơn đặt hàng và hiển thị một số ưu đãi hằng ngày. Bạn có thể xác định các ý định được kích hoạt bằng cách nói:

  • "Ok Google, hãy nói chuyện với ExampleAction."
  • "Ok Google, hãy nói chuyện với ExampleAction để mua một số đôi giày."
  • "Ok Google, hãy nói chuyện với ExampleAction để kiểm tra đơn đặt hàng của tôi."
  • "Ok Google, hãy nói chuyện với ExampleAction để cho tôi xem các ưu đãi hôm nay."

Tệp JSON của gói Hành động có thể có dạng như sau:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "intent": {
        "name": "com.example.ExampleAction.BUY",
        "parameters": [{
          "name": "color",
          "type": "org.schema.type.Color"
        }],
        "trigger": {
          "queryPatterns": [
            "find some $org.schema.type.Color:color sneakers",
            "buy some blue suede shoes",
            "get running shoes"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

Tạo và triển khai webhook cho phương thức thực hiện

Khi một Hành động trong dự án của bạn được gọi, Actions on Google sẽ gọi thực hiện hành động để bắt đầu cuộc trò chuyện với người dùng nhằm thực hiện Hành động.

Trong mỗi yêu cầu đối với webhook của phương thức thực hiện, bạn sẽ nhận được thông tin do người dùng nhập dưới dạng chuỗi văn bản. Để xử lý ý định, bạn thường phân tích cú pháp văn bản đầu vào và trả về phản hồi. Quá trình trao đổi qua lại này diễn ra cho đến khi cuộc trò chuyện kết thúc.

Tải gói Hành động lên

Sau khi tạo gói Hành độngtriển khai phương thức thực hiện của gói đó, bạn có thể tải gói Hành động lên Bảng điều khiển Actions. Bảng điều khiển Actions sử dụng các dự án Hành động để nhóm Hành động trò chuyện với siêu dữ liệu như bài đánh giá trạng thái và tên hiển thị trong thư mục Trợ lý. Dự án này cũng cho phép bạn xác định siêu dữ liệu về Hành động của bạn, đồng thời quản lý và theo dõi Hành động của bạn thông qua quy trình phê duyệt.

Khi đã có một dự án, bạn có thể tải lên Gói Hành động xác định tất cả Hành động bằng CLI gactions.

Gửi dự án của bạn để phê duyệt và cung cấp dự án cho người dùng

Mẫu

Để khám phá các dự án đã hoàn tất, hãy xem mẫu SDK hành động của Node.js và Java.