CLI do gactions (Dialogflow)

gactions é a interface de linha de comando usada para testar e atualizar seu Projeto do Actions.

arquitetura do sistema.

Para selecionar o download adequado, é preciso saber qual é a arquitetura do seu sistema.

  • Em dispositivos Mac OS X e Linux, você pode encontrar a arquitetura de CPU do seu computador usando o comando terminal uname -a:

  • Em dispositivos Windows 10, siga as etapas abaixo para encontrar a arquitetura da CPU:

    1. Abra Configurações.

    2. Clique em Sistema

    3. Clique em Sobre.

Downloads

Faça o download do gactions para seu sistema operacional (abaixo).

SO Downloads
Windows
Mac
Linux

Requisitos

  • Defina as permissões apropriadas para tornar o arquivo baixado executável.
    • No Mac e Linux, execute chmod +x gactions para tornar o binário executável.
    • No Windows, você precisa ter direitos de administrador.
  • O local de download gactions precisa estar na sua variável de ambiente PATH.

Argumentos aceitos

A tabela a seguir descreve os argumentos compatíveis com gactions:

Argumento Descrição
help, h Mostra o texto de ajuda para esta ferramenta. Por exemplo: 
gactions help

Para ver o texto de ajuda de um argumento específico, use a seguinte sintaxe:

gactions help argument

Exemplo:

gactions help test
get Recebe o conteúdo do projeto em questão (ações + metadados). Use a seguinte sintaxe: 
gactions get --project PROJECT_ID
init Cria um arquivo action.json padrão no diretório atual com a seguinte sintaxe: 
gactions init

Se já houver um arquivo action.json, será possível substituí-lo adicionando o --force, como mostra o exemplo a seguir:

gactions init --force
list Lista até 10 versões recentes do seu projeto do Actions: em análise, produção, aprovado etc, com a seguinte sintaxe: 
gactions list --project PROJECT_ID
test Envia um pacote de ações à plataforma do Assistente para testes com o seguinte sintaxe: 
gactions test --action_package PACKAGE_NAME --project PROJECT_ID

Exemplo:

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

Também é possível desativar os testes no ambiente do sandbox pela sinalização
--disable_sandbox.

A sinalização --preview_mins foi descontinuada.
update Atualiza o pacote Action de um determinado projeto com a seguinte sintaxe: 
gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Exemplo:

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

Para usar o argumento update, use o ID do projeto da sua ação. Você pode receber o ID do projeto clicando no ícone de engrenagem das configurações Projeto do Actions on Google seguido de Configurações do projeto.

Caso seu projeto do Actions ofereça suporte a vários idiomas, consulte a Documentação do pacote de ações.
selfupdate O gactions verifica automaticamente se há atualizações antes da execução de cada comando, mas é possível forçar essa verificação com selfupdate 
gactions selfupdate

Conferir saída detalhada

Para conferir uma saída mais detalhada durante o processamento, adicione a flag --verbose. Exemplo:

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

Exemplo de action.json padrão

Ao executar gactions init no diretório do projeto, você gera um action.json nesse diretório:

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