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 tệp tải xuống phù hợp, bạn cần tìm cấu trúc hệ thống của mình.

  • Trên thiết bị Mac OS X và Linux, bạn có thể tìm thấy kiến trúc CPU của máy tính bằng lệnh trong cửa sổ 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 cấu 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

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 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 máy 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ố Mô tả
help, h Xuất 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 đã cho (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 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 này 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, phát hành công khai, được phê duyệt, v.v. với cú pháp sau: 
gactions list --project PROJECT_ID
test Đẩy gói hành động đến Nền tảng Trợ lý để kiểm thử với nội dung sau cú pháp: 
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 tính năng thử nghiệm trong môi trường hộp cát bằng cờ
--disable_sandbox.

Cờ --preview_mins không được dùng nữa.
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

Để dùng đối số update, bạn phải sử dụng Mã dự án của Hành động. Bạn có thể tải mã dự án của bạn bằng cách nhấp vào biểu tượng bánh răng cài đặt trong Dự án Actions on Google sau đó là phần Project Settings (Cài đặt dự án).

Nếu dự án Actions 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 chạy mỗi lệnh, nhưng bạn có thể buộc kiểm tra với 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 giá trị mặc định action.json tệp 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>"
}