gactions CLI (Dialogflow)

gactions 是用於測試及更新動作專案的指令列介面。

系統架構

如要選取合適的下載項目，您必須先找出系統架構。

  • 在 Mac OS X 和 Linux 裝置上，您可以使用終端機指令 uname -a 找出電腦的 CPU 架構。

  • 在 Windows 10 裝置上，按照下列步驟找出 CPU 架構：

    1. 開啟「設定」

    2. 按一下「System」。

    3. 點選 [簡介]

下載內容

您可以在下方下載適用於您作業系統的 gactions。

作業系統 下載內容
Windows
Mac
Linux

需求條件

  • 設定適當權限，將下載的檔案設為可執行檔。
    • 在 Mac 和 Linux 上，執行 chmod +x gactions 讓二進位檔執行。
    • 在 Windows 系統中，您必須具備管理員權限。
  • gactions 下載位置必須位於 PATH 環境變數中。

支援的引數

下表說明 gactions 支援的引數：

引數 說明
help、h 輸出這項工具的說明文字。例如： 
gactions help

如要查看特定引數的說明文字，請使用以下語法：

gactions help argument

例如：

gactions help test
get 取得指定專案的內容 (動作 + 中繼資料)。請使用以下語法： 
gactions get --project PROJECT_ID
init 使用下列語法在目前的目錄中建立預設的 action.json 檔案： 
gactions init

如果已有 action.json 檔案，您可以新增 --force 引數覆寫該檔案，如以下範例所示：

gactions init --force
list 列出最多 10 個動作專案的近期版本：審核中、實際工作環境、已核准等，語法如下： 
gactions list --project PROJECT_ID
test 使用下列語法將動作套件推送至 Google 助理平台進行測試： 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

例如：

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

您可以選擇使用
--disable_sandbox 標記，停用沙箱環境中的測試功能。

--preview_mins 旗標已淘汰。
update 使用下列語法更新指定專案的動作套件： 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

例如：

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

如要使用 update 引數，您必須使用動作的專案 ID。如要取得專案 ID，請在 Actions on Google 專案中按一下「設定」齒輪圖示 ，然後點選「專案設定」。

如果您的動作專案支援多種語言，請參閱動作套件說明文件。
selfupdate gactions 會在每個指令執行前自動檢查更新，但您可以用 selfupdate 
gactions selfupdate
強制檢查

查看詳細輸出內容

如要在處理期間查看更詳細的輸出內容，請新增 --verbose 旗標。例如：

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

預設 action.json 範例

在專案目錄中執行 gactions init 時，您會在該目錄中產生預設的 action.json 檔案：

{
  "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>"
}