Consultar um banco de dados

No momento, seu webhook usa dados codificados na função cruisePlanCoverage. Nesta etapa do tutorial, você vai criar um banco de dados do Spanner, preencher com destinos cobertos e atualizar sua função para consultar o banco de dados.

Configuração do projeto

É importante que o agente do Dialogflow e o banco de dados estejam no mesmo projeto. Essa é a maneira mais fácil de sua função ter acesso seguro ao banco de dados. Além disso, você precisa ativar a API Spanner.

  1. Antes de criar o banco de dados, selecione seu projeto no console Google Cloud .

    Acessar o seletor de projetos

  2. Ative a API Spanner para o projeto.

    Ativar a API Spanner

Criar uma instância do Spanner

Quando você usa o Spanner pela primeira vez, é preciso criar uma instância, que é uma alocação de recursos usados pelos bancos de dados do Spanner nessa instância.

  1. No console Google Cloud , acesse a página Instâncias do Spanner.

    Acessar as instâncias do Spanner

  2. Clique em Criar instância.

  3. Para o nome da instância, insira Instância do tutorial.

  4. O ID da instância é inserido automaticamente com base no nome dela.

  5. Em Escolher sua configuração, mantenha a opção padrão Regional e selecione o mesmo local que você escolheu ao criar a função.

  6. Em Alocar capacidade de computação, insira 100 unidades de processamento. Isso fornece uma capacidade mínima para o tutorial.

  7. Clique em Criar. O console do Google Cloud mostra a página Visão geral da instância que você criou.

Criar um banco de dados do Spanner

Agora que você tem uma instância, é necessário criar um banco de dados. Para criar um banco de dados:

  1. Na página Visão geral da instância, clique em Criar banco de dados.
  2. Para o nome do banco de dados, digite tutorial-database.
  3. Selecione o dialeto do banco de dados SQL padrão do Google.
  4. Clique em Criar. O console Google Cloud mostra a página Visão geral do banco de dados que você criou.

Criar uma tabela para o banco de dados

Agora que você tem um banco de dados, é necessário criar uma tabela para ele. Para criar uma tabela:

  1. Na seção "Tabelas" da página Visão geral do banco de dados, clique em Criar tabela.

  2. Na página Escrever instruções DDL, insira:

    CREATE TABLE Destinations (
  Destination STRING(1024),
  Covered BOOL,
) PRIMARY KEY(Destination);

  3. Clique em Enviar. O console do Google Cloud retorna à página Visão geral do banco de dados e mostra que as atualizações do esquema estão em andamento. Aguarde a conclusão da atualização.

Inserir dados na tabela

Agora que seu banco de dados tem uma tabela, você precisa adicionar dados a ela. Para adicionar dados:

  1. Na lista de tabelas da página Visão geral do banco de dados, clique na tabela "Destinations". O console do Google Cloud exibe a página Esquema da tabela "Destinations".
  2. No menu de navegação à esquerda, clique em Dados para exibir a página Dados da tabela "Destinations".

  3. Clique em Inserir. O console Google Cloud mostra a página Consulta da tabela "Destinations" com uma nova guia de consulta que contém instruções INSERT e SELECT. Substitua essas declarações pelo seguinte:

    INSERT INTO Destinations (Destination, Covered)
VALUES('anguilla', TRUE),
      ('canada', TRUE),
      ('china', TRUE),
      ('italy', TRUE),
      ('mexico', TRUE),
      ('spain', FALSE);

  4. Clique em Executar.

  5. No menu de navegação à esquerda, clique em Dados novamente para mostrar os dados da tabela "Destination". Confirme se a tabela contém os dados desejados.

Atualizar a função do Cloud para consultar o banco de dados

A função cruisePlanCoverage no código do webhook verifica se variáveis de ambiente específicas estão definidas com informações para conexão com o banco de dados. Se essas variáveis de ambiente não estiverem definidas, a função usará uma lista codificada de destinos.

Agora que você tem um banco de dados configurado, atualize sua função do Cloud para definir as variáveis de ambiente necessárias:

  1. Abra a página de visão geral do Cloud Functions.

    Acessar a visão geral do Cloud Functions

  2. Clique na função tutorial-telecommunications-webhook para acessar a página de detalhes.

  3. Clique em Editar.

  4. Abra a seção Configurações de ambiente de execução, criação e conexões.

  5. Selecione a guia Ambiente de execução.

  6. Adicione as seguintes variáveis na seção "Variáveis de ambiente de execução":

    • PROJECT_ID: ID do projeto;
    • SPANNER_INSTANCE_ID: o ID da instância do Spanner (provavelmente tutorial-instance)
    • SPANNER_DATABASE_ID: o ID do banco de dados do Spanner (provavelmente tutorial-database)

  7. Clique em Próxima.

  8. Clique em Implantar.

  9. Aguarde até que o indicador de status mostre que a função foi implantada com sucesso.

Testar o agente

Seu agente está pronto para ser testado. Clique no botão Testar agente no console do Dialogflow para abrir o simulador. Tente ter a seguinte conversa com o agente:

Turno de conversa Você Agente
1 Olá Olá! Sou o agente virtual de telecomunicações. Posso ajudar você a resolver dúvidas sobre faturamento e planejamento, solucionar problemas e adicionar planos de viagem e cruzeiros. Como posso ajudar hoje?
2 Quero adicionar um plano de cruzeiro Vamos conferir isso para você. Qual é seu número de telefone?
3 123-123-1234 Quantos dias dura o cruzeiro?
4 7 A opção 1 inclui telefone e mensagens. Ele custa US $[XX]/dia. Saiba mais aqui [URL]. A opção 2 inclui telefone, mensagens e dados. Ele custa US $[XX]/dia. Saiba mais aqui [URL]. Qual plano de cruzeiro você quer adicionar?
5 Opção 1 Ok. Esse plano já foi adicionado à sua conta. Durante o cruzeiro, você também pode precisar de cobertura em terra. Em qual porto você vai parar?
6 Itália E quantos dias você vai passar lá?
7 3 Temos uma ótima novidade! A Itália tem cobertura terrestre sem custo financeiro. Tudo pronto. Posso ajudar com mais alguma coisa hoje?

Se você examinar o código, a Itália não estará na lista codificada de destinos cobertos. Isso significa que o webhook se conectou ao banco de dados, que inclui a Itália.

Solução de problemas

O código do webhook inclui instruções de geração de registros. Se você estiver com problemas, tente conferir os registros da sua função do Cloud.

Se a função não estiver se conectando ao banco de dados e você encontrar um erro de permissão nos registros, talvez seja necessário corrigir a função da conta de serviço padrão usada pela função. Essa conta de serviço tem o formato PROJECT_ID@appspot.gserviceaccount.com. Você pode corrigir isso de uma das seguintes maneiras:

Mais informações

Para mais informações sobre as etapas acima, consulte:

Anterior
Criar um serviço de webhook
Avançar
Hospedar o agente