Guia de início rápido do SDK e do Builder do Actions

Neste guia, mostramos como configurar seu ambiente para criar ações usando o SDK e o Actions Builder. Você vai realizar as seguintes tarefas:

  • Instalar o Node.js: você precisa desse ambiente de execução para usar nossa biblioteca de fulfillment do Node.js.
  • Instalar a CLI do Firebase: essa ferramenta de linha de comando permite desenvolver e implantar dependências do Firebase, como apps da Web para tela interativa, no Firebase Hosting.
  • Instale a ferramenta de linha de comando gactions:ao desenvolver com o SDK, você usa essa ferramenta para criar, gerenciar e implantar o pacote de ações.
  • Criar um projeto do Actions:um projeto do Actions é o contêiner lógico para suas ações de conversa. É necessário criar um no Console do Actions antes de começar a criar.
  • Inicialize e implante uma amostra:esse exemplo simples mostra como começar a criar ações com a tela interativa.

Depois de concluir este início rápido, você pode sincronizar seu projeto do Actions entre seu ambiente de desenvolvimento local e a experiência da Web do Actions Builder.

Instalar o Node.js e a CLI do Firebase

Faça o download e instale o Node.js de acordo com a documentação do Node.js para usar nossa biblioteca de fulfillment. A instalação do Node.js também permite que você instale a CLI do Firebase com o npm e, mais tarde, para executar sua implementação de fulfillment conversacional localmente.

Instale e configure a CLI do Firebase de acordo com a documentação do Firebase. Com a CLI do Firebase, é possível implantar um app da Web de tela interativa no Firebase Hosting e, se necessário, implantar manualmente o fulfillment no Cloud Functions para Firebase.

Instalar a ferramenta de linha de comando gactions

Para instalar a ferramenta de interface de linha de comando (CLI) dos gactions, faça o download de um pacote de instalação, descompacte-o e configure o caminho de execução.

Para instalar e configurar as ações, siga estas etapas:

  1. Faça o download do pacote adequado para seu sistema operacional:

    Plataforma Pacote Soma de verificação
    Windows Fazer o download SHA256
    Linux Fazer o download SHA256
    Mac OS Fazer o download SHA256
  2. Extraia o pacote para um local de sua escolha e adicione o binário à variável PATH do ambiente. Como alternativa, extraia o pacote para um local que já esteja na variável PATH (por exemplo, /usr/local/bin).

  3. No Linux e no Mac, ative as permissões de execução, se necessário:

    chmod +x PATH_TO/gactions
  4. Execute o comando a seguir para autenticar a CLI. Esse comando inicia um fluxo de autenticação e requer um navegador da Web:

    gactions login

    Quando o fluxo é concluído, a CLI é autenticada automaticamente.

Criar e configurar um projeto

Antes de usar a ferramenta de linha de comando dos gactions, você precisa criar um projeto no Console do Actions e conceder acesso a ele. Para criar e configurar um projeto, faça o seguinte:

  1. Acesse o Console do Actions.
  2. Clique em Novo projeto, insira um nome e clique em Criar projeto.
  3. Selecione uma categoria e clique em Próxima.
  4. Selecione Projeto em branco e clique em Começar a criar.
  5. Ative a API Actions no console do Google Cloud seguindo as instruções em Ativar e desativar APIs. Isso permite que as gactions interajam com seu projeto.

Fazer o download do exemplo "Hello World"

O exemplo interativo Hello World mostra como criar um projeto de ações simples com uma única ação da tela interativa.

  1. Crie um diretório vazio e inicialize o exemplo de tela interativa nesse diretório. Por exemplo, o código a seguir inicializa a amostra em um diretório interactive-canvas-sample/, que é usado como exemplo em todo este documento:

    gactions init interactive-canvas --dest interactive-canvas-sample
    cd interactive-canvas-sample
    
  2. Abra o arquivo interactive-canvas-sample/sdk/settings/settings.yaml e altere o valor do campo projectId para o ID do projeto.

Implantar e testar a amostra

Depois de configurar o exemplo, você pode implantar o app da Web de tela interativa e seu projeto do Actions. Esse processo cria uma versão de rascunho do projeto que pode ser implantada no simulador do Actions para visualização e teste:

  1. No diretório interactive-canvas-sample/, execute o comando a seguir para implantar o app da Web da tela interativa (o conteúdo do diretório public/).

    firebase deploy --project PROJECT_ID --only hosting
    

    É possível ver uma versão renderizada do app da Web no URL retornado pela CLI do Firebase em um navegador: https://PROJECT_ID.web.app.

  2. Abra o arquivo interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js e altere o valor da variável CANVAS_URL para o URL do app da Web do seu projeto.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';
    
  3. No diretório interactive-canvas-sample/sdk/, execute o seguinte comando para enviar a versão local do projeto do Actions para o console como uma versão de rascunho:

    gactions push
    
  4. No diretório interactive-canvas-sample/sdk/, execute o seguinte comando para testar seu projeto do Actions no simulador:

    gactions deploy preview
    
  5. Abra o link retornado pela ferramenta de linha de comando para acessar o simulador.

  6. No simulador, insira Amostra de tela interativa do Google Talk para iniciar a ação. Você verá um triângulo giratório do app da Web implantado em https://PROJECT_ID.web.app

    Figura 1. O simulador com uma prévia do projeto do Actions.