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 Hành động. Thao tác cho phép người dùng hoàn thành công việc thông qua một giao diện trò chuyện, có thể là từ một lệnh nhanh để bật một số đèn hoặc một cuộc trò chuyện dài hơn, chẳng hạn như chơi một trò chơi đố 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 sử dụng Dialogflow. Khi sử dụng SDK hành động, bạn sẽ sử dụng gói Hành động để liên kết các ý định với phương thức thực hiện với các hành động đó. Bạn cũng phải cung cấp các 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ủa bạn có thể nói.

điều khoản CLI

Khi phát triển bằng SDK Hành động, bạn sẽ sử dụng giao diện dòng lệnh (CLI) gactions để kiểm thử và cập nhật dự án Hành động. 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 Hành động trong gói Hành động

Bạn tạo các Hành động trong gói Hành động bằng cách liên kết các ý định với phương thức thực hiện. 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 giá trị nhận dạng riêng biệt được gọi là ý định. Ý định liên kết với phương thức thực hiện đơn hàng (xử lý ý định này).

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

  • "Ok Google, trò chuyện với ExampleAction."
  • "Ok Google, nói chuyện với ExampleAction để mua một vài đô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, trò chuyện với ExampleAction để cho tôi biết 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"
    }
  }
}

Xây dựng và triển khai webhook thực hiện

Khi một Hành động trong dự án được gọi, Hành động trên Google sẽ gọi phương thức thực hiện hành động của bạn để bắt đầu một 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 đến webhook thực hiện, bạn sẽ nhận được dữ liệu đầu vào của người dùng dưới dạng chuỗi văn bản. Để xử lý ý định, bạn thường phân tích cú pháp nội dung nhập 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 trong Hành động của bạn kết thúc.

Tải gói Hành động của bạn lên

Sau khi tạo Gói hành độngtriển khai việc thực hiện đơn hàng, bạn có thể tải gói Hành động lên Bảng điều khiển hành động. Bảng điều khiển Actions dùng các Dự án thao tác để nhóm Hành động trò chuyện với siêu dữ liệu như trạng thái xem xét 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 mình và quản lý cũng như theo dõi Hành động đó thông qua quy trình phê duyệt.

Sau khi có dự án, bạn có thể tải gói Hành động lên để 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

Ví dụ

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