CLI do gactions (Dialogflow)

gactions é a interface de linha de comando usada para testar e atualizar o projeto do Actions.

arquitetura do sistema.

Para selecionar o download adequado, encontre a arquitetura do sistema.

  • Em dispositivos Mac OS X e Linux, é possível encontrar a arquitetura de CPU do computador usando o comando do terminal uname -a.

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

    1. Abra as Configurações.

    2. Clique em Sistema

    3. Clique em Sobre.

Downloads

Você pode fazer o download do gactions para seu sistema operacional (abaixo).

SO Downloads
Windows
Mac
Linux

Requisitos

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

Argumentos aceitos

A tabela abaixo descreve os argumentos compatíveis com gactions:

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

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

gactions help argument

Exemplo:

gactions help test
get Acessa o conteúdo de um projeto específico (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, você poderá substituí-lo adicionando o argumento --force, como mostra o exemplo a seguir:

gactions init --force
list Lista até 10 versões recentes do seu projeto do Actions: em revisão, produção, aprovada etc., com a seguinte sintaxe:
gactions list --project PROJECT_ID
test Envia um pacote de ações à plataforma do Google Assistente para testes com a 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 o teste no ambiente de sandbox com a sinalização
--disable_sandbox.

A sinalização --preview_mins foi descontinuada.

update Atualiza o pacote Action para o projeto especificado 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. Para conseguir o ID do projeto, clique no ícone de engrenagem de configurações no projeto do Actions on Google e, em seguida, em Project Settings.

Se o projeto do Actions for compatível com vários idiomas, consulte a documentação do pacote de ações.

selfupdate As ações verificam automaticamente se há atualizações antes da execução de cada comando, mas é possível forçar essa verificação com selfupdate
gactions selfupdate

Ver 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 padrão de action.json

Ao executar gactions init no diretório do projeto, você gera um arquivo action.json padrão 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>"
}