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:
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 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ávelPATH
(por exemplo,/usr/local/bin
).No Linux e no Mac, ative as permissões de execução, se necessário:
chmod +x PATH_TO/gactions
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:
- Acesse o Console do Actions.
- Clique em Novo projeto, insira um nome e clique em Criar projeto.
- Selecione uma categoria e clique em Próxima.
- Selecione Projeto em branco e clique em Começar a criar.
- 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.
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
Abra o arquivo
interactive-canvas-sample/sdk/settings/settings.yaml
e altere o valor do campoprojectId
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:
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óriopublic/
).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
.Abra o arquivo
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
e altere o valor da variávelCANVAS_URL
para o URL do app da Web do seu projeto.const CANVAS_URL = 'https://PROJECT_ID.web.app';
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
No diretório
interactive-canvas-sample/sdk/
, execute o seguinte comando para testar seu projeto do Actions no simulador:gactions deploy preview
Abra o link retornado pela ferramenta de linha de comando para acessar o simulador.
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