gactions CLI (Dialogflow)

gactions 是用于测试和更新 Actions 项目的命令行界面。

系统架构

若要选择正确的下载内容，您需要找到自己的系统架构。

  • 在 Mac OS X 和 Linux 设备上，您可以使用终端命令 uname -a 查找计算机的 CPU 架构。

  • 在 Windows 10 设备上，请按照以下步骤查找 CPU 架构：

    1. 打开设置

    2. 点击系统

    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 个最新版本的 Actions 项目：审核中、正式版、已批准等： 
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 使用以下语法更新给定项目的 Action 包： 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

例如：

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

如需使用 update 参数，您必须使用 Action 的项目 ID。如需获取项目 ID，您可以在 Actions on Google 项目中点击设置齿轮 ，然后点击项目设置。

如果您的 Actions 项目支持多种语言，请参阅 Action 软件包文档。
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>"
}