gactions CLI (luồng hội thoại)

gactions là giao diện dòng lệnh mà bạn dùng để kiểm thử và cập nhật dự án Actions (Hành động).

Cấu trúc hệ thống

Để chọn đúng tệp tải xuống, bạn cần tìm cấu trúc hệ thống của mình.

  • Trên các thiết bị Mac OS X và Linux, bạn có thể tìm thấy cấu trúc CPU của máy tính bằng lệnh trong dòng lệnh uname -a.

  • Trên thiết bị Windows 10, hãy làm theo các bước sau để tìm kiến trúc CPU:

    1. Mở phần Cài đặt

    2. Nhấp vào System (Hệ thống)

    3. Nhấp vào Giới thiệu

Nội dung đã tải xuống

Bạn có thể tải gactions xuống cho hệ điều hành của mình (ở bên dưới).

Hệ điều hành Nội dung đã tải xuống
Windows
Mac
Linux

Yêu cầu

  • Làm cho tệp đã tải xuống có thể thực thi bằng cách đặt các quyền thích hợp.
    • Trên Mac và Linux, hãy chạy chmod +x gactions để tệp nhị phân có thể thực thi.
    • Trên Windows, bạn phải có quyền Quản trị viên.
  • Vị trí tải xuống gactions phải nằm trong biến môi trường PATH.

Đối số được hỗ trợ

Bảng sau đây mô tả các đối số được hỗ trợ cho gactions:

Đối số Nội dung mô tả
help, h Xuất ra văn bản trợ giúp cho công cụ này. Ví dụ:
gactions help

Để xem văn bản trợ giúp cho một đối số cụ thể, hãy sử dụng cú pháp sau:

gactions help argument

Ví dụ:

gactions help test
get Lấy nội dung của dự án cụ thể (Hành động + siêu dữ liệu). Hãy sử dụng cú pháp sau:
gactions get --project PROJECT_ID
init Tạo một tệp action.json mặc định trong thư mục hiện tại bằng cú pháp sau:
gactions init

Nếu đã có tệp action.json, bạn có thể ghi đè tệp đó bằng cách thêm đối số --force, như trong ví dụ sau:

gactions init --force
list Liệt kê tối đa 10 phiên bản gần đây của dự án Actions: đang xem xét, đang phát hành, đã được phê duyệt, v.v. với cú pháp sau:
gactions list --project PROJECT_ID
test Đẩy một gói hành động đến Nền tảng Trợ lý để kiểm thử bằng cú pháp sau:
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Ví dụ:

gactions test --action_package mypackage.json --project my-project-1234567

Bạn có thể tuỳ ý tắt hoạt động kiểm thử trong môi trường hộp cát bằng cờ
--disable_sandbox.

Ngừng sử dụng cờ --preview_mins.

update Cập nhật gói Hành động cho dự án đã cho bằng cú pháp sau:
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Ví dụ:

gactions update --action_package action.json --project my-project-1234567

Để sử dụng đối số update, bạn phải dùng Mã dự án cho Hành động của mình. Bạn có thể lấy mã dự án bằng cách nhấp vào bánh răng cài đặt trong dự án Actions on Google, sau đó nhấp vào Cài đặt dự án.

Nếu dự án Hành động của bạn hỗ trợ nhiều ngôn ngữ, hãy xem Tài liệu về gói hành động.

selfupdate gaction tự động kiểm tra bản cập nhật trước khi mỗi lệnh chạy, nhưng bạn có thể buộc kiểm tra bằng selfupdate
gactions selfupdate

Xem kết quả chi tiết

Để xem kết quả chi tiết hơn trong quá trình xử lý, hãy thêm cờ --verbose. Ví dụ:

gactions --verbose test --action_package action.json --project my-project-1234567

Ví dụ về action.json mặc định

Khi chạy gactions init trong thư mục dự án, bạn sẽ tạo một tệp action.json mặc định trong thư mục đó:

{
  "actions": [
    {
      "description": "Default Welcome Intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "<INSERT YOUR CONVERSATION NAME HERE>"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to <INSERT YOUR NAME HERE>"
          ]
        }
      }
    }
  ],
  "conversations": {
    "<INSERT YOUR CONVERSATION NAME HERE>": {
      "name": "<INSERT YOUR CONVERSATION NAME HERE>",
      "url": "<INSERT YOUR FULLFILLMENT URL HERE>"
    }
  },
  "locale": "<INSERT YOUR LANGUAGE HERE>"
}