Интерфейс командной строки gactions (Dialogflow)

gactions — это интерфейс командной строки, который вы используете для тестирования и обновления проекта Actions.

Архитектура системы

Чтобы выбрать подходящую загрузку, вам необходимо определить архитектуру вашей системы.

  • На устройствах Mac OS X и Linux вы можете узнать архитектуру процессора вашего компьютера, используя команду терминала uname -a .

  • На устройствах с Windows 10 выполните следующие действия, чтобы найти архитектуру ЦП:

    1. Открыть настройки

    2. Нажмите Система

    3. Нажмите «О программе»

Загрузки

Вы можете скачать gactions для своей операционной системы (ниже).

ОС Загрузки
Окна
Мак
Линукс

Требования

  • Сделайте загруженный файл исполняемым, установив соответствующие разрешения.
    • В 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 Отправляет пакет действий на платформу Assistant для тестирования со следующим синтаксисом:
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 , вы должны использовать идентификатор проекта вашего действия. Вы можете получить идентификатор своего проекта, щелкнув шестеренки в проекте 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>"
}