gactions CLI(Dialogflow)

gactions は、Actions プロジェクトのテストと更新に使用するコマンドライン インターフェースです。

システム アーキテクチャ

適切なダウンロードを選択するため、ご使用のシステム アーキテクチャを確認する必要があります。

  • Mac OS X および Linux デバイスでは、ターミナル コマンド uname -a を使用してコンピュータの CPU アーキテクチャを確認できます。

  • Windows 10 デバイスでは、次の手順に従って CPU アーキテクチャを確認します。

    1. [設定] を開きます。

    2. [システム] をクリックします。

    3. [バージョン情報] をクリックします。

ダウンロード

お使いのオペレーティング システムに対応した gactions をダウンロードできます(下記参照)。

OS ダウンロード
ウィンドウ
Mac
Linux

要件

  • 適切な権限を設定して、ダウンロードしたファイルを実行可能にします。
    • Mac と Linux では、chmod +x gactions を実行してバイナリを実行可能にします。
    • Windows では、ファイルを実行するユーザーに管理者権限が必要です。
  • gactions のダウンロード場所は、PATH 環境変数に含める必要があります。

サポートされている引数

次の表に、gactions でサポートされている引数を示します。

引数 説明
helph このツールのヘルプテキストを出力します。次に例を示します。
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 次の構文を使用して、テスト用のアシスタント プラットフォームにアクション パッケージをプッシュします。
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>"
}