Google Assistant CLI Commands

Learn how to build and deploy Google Assistant projects using the Jovo CLI.

The Google Assistant CLI plugin allows you to interact with the Actions on Google Console using the Jovo CLI.

To use the Google Assistant CLI, add it as plugin to your jovo.project.js file. Learn more about Google Assistant project configuration here.

const { ProjectConfig } = require('@jovotech/cli-core');
const { GoogleAssistantCli } = require('@jovotech/platform-googleassistant');
// ...

const project = new ProjectConfig({
  // ...
  plugins: [
    new GoogleAssistantCli(),
    // ...
  ],
});

This CLI plugin uses the official gactions CLI provided by Google for deployment. Follow the official Google Assistant docs to install and configure gactions CLI. A tip: To find the right path where to put the gactions binary, you can for example type which jovov4 into your command line and place it into the same parent folder.

The gactions CLI is also available as an NPM package since 2021. Instead of downloading the binary, you can alo install it like this:

$ npm install -g @assistant/gactions

The Google Assistant CLI plugin hooks into the following commands:

• build: Create Google Assistant project files based on the project config and models folder
• deploy: Deploy project files to the Actions on Google Console
• get: Synchronize your local project files with the Actions on Google Console

The Google Assistant CLI plugin hooks into the build command and creates a platform.googleAssistant folder inside the build directory in the root of your Jovo project. Learn more about the build command here.

$ jovo build:platform googleAssistant

It uses Google Assistant jovo.project.js configuration and files in the models folder to create Google Assistant-specific project files that are ready for deployment.

The folder then contains several files and folders, including actions, custom, settings, and webhooks.

The Google Assistant CLI plugin adds the following flags to the build:platform command:

The Google Assistant CLI plugin hooks into the deploy:platform command to deploy the Google Assistant project files (which were previously generated using the build command) to the Actions on Google Console. Learn more about the deploy:platform command here.

$ jovo deploy:platform googleAssistant

After successful deployment, you can open the Google Actions Console and see the changes there.

It is possible that the deployment process results in a few warnings, for example Short description is required. This is not a problem for deployment. Before you want to release the Action, make sure to fill out all directory information. We recommend doing that using the Google Actions Console and then retrieving the settings using the get command. They can then be added to the build process using the files configuration.

The Google Assistant CLI plugin adds the following flags to the deploy:platform command:

The Google Assistant CLI plugin hooks into the get:platform command to synchronize the files in your build directory with the project data from the Actions on Google Console. Learn more about the get:platform command here.

$ jovo get:platform googleAssistant

This is helpful if you've made any updates to the Action's configuration (for example directory information) that you now want to add to the jovo.project.js file using the files configuration.

The Google Assistant CLI plugin adds the following flags to the get:platform command: