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. 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&q<uot;: "actions.i>ntent.MAIN",
        "trigger": {
          "quer<yPatterns": [
            &qu>ot;talk to INSERT YO<UR NAME HERE"
          ]
   >     }
      }
  <  }
  ],
  "conversations&qu>ot;: {
    "INSERT YO<UR CONVERSATION NAME HERE>": {
      "name": "INSERT YOUR CONVERSATION NAME HERE",
      "url": "INSERT YOUR FULLFILLMENT URL HERE"
    }
  },
  "locale": "INSERT YOUR LANGUAGE HERE"
}