Implemente o servidor de aplicações

Este guia descreve os passos necessários para configurar um servidor de aplicações que pode usar para renderizar sugestões do Agent Assist no LivePerson. O servidor de aplicações é usado com um servidor proxy no mesmo diretório. Para obter instruções sobre a renderização dos módulos da IU no espaço de trabalho do agente, consulte a página principal do tutorial do LivePerson. É necessário um servidor de aplicações e um servidor proxy antes de poder renderizar os módulos no LivePerson.

Embora seja possível configurar esta implementação de integração em qualquer plataforma de alojamento, estas instruções usam o Cloud Run da Google.

Configuração

Quando implementa o serviço, tem de definir as seguintes variáveis de ambiente. Certifique-se de que deixa as variáveis LP_CLIENT_ID e LP_CLIENT_SECRET em branco quando criar inicialmente o servidor de aplicações. A LivePerson fornece estas variáveis quando cria uma aplicação Conversational Cloud, e atualiza-as nessa altura. Inicialmente, também vai ignorar APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL. Cada uma destas duas variáveis é definida depois de os servidores de aplicações e proxy terem sido implementados e devolvido os valores de URL necessários.

  • LP_ACCOUNT_ID: ID da conta do LivePerson.
  • LP_CLIENT_ID: o seu ID de cliente do LivePerson. Este valor é fornecido pela LivePerson assim que a aplicação Conversational Cloud for instalada. (Ignore esta variável por agora. Vai atualizá-la quando as informações forem fornecidas).
  • LP_CLIENT_SECRET: o segredo do cliente do LivePerson. Esta informação é fornecida pela LivePerson assim que a aplicação Conversational Cloud for instalada. (Ignore esta variável por agora. Vai atualizá-la assim que as informações forem fornecidas).
  • LP_SENTINEL_DOMAIN: aceda a https://developers.liveperson.com/domain-api.html. Introduza o número de conta e procure o domínio "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: aceda a https://developers.liveperson.com/domain-api.html. Introduza o número da sua conta e procure o domínio para "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL do servidor da aplicação de IU. (Ignore por agora e atualize após a implementação do servidor de aplicações e quando souber o respetivo URL).
  • DF_PROXY_SERVER_URL: o URL do servidor proxy. (Ignore por agora e atualize depois de o servidor proxy ter sido implementado e de saber o respetivo URL.)
  • PROJECT_ID: o ID do seu projeto do Google Cloud. Não inclua o prefixo projects/.

Ficheiro de exemplo .env:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    DF_PROXY_SERVER_URL = https://proxy-server-dot-my-project.wm.r.appspot.com
    PROJECT_ID = my-project

Implementação

O servidor de aplicações da IU tem de ser implementado num serviço de alojamento da Google Cloud. Recomendamos que use o Google App Engine ou o Cloud Run. Os passos abaixo usam o Cloud Run como exemplo.

Configure uma CLI gcloud

Os processos de implementação descritos neste tutorial usam comandos da CLI gcloud. Siga os passos abaixo para configurar a CLI gcloud localmente para esta implementação:

  1. Na página de documentação da CLI gcloud, selecione o seu SO e siga as instruções de instalação.
  2. Execute gcloud config get-value project para verificar a configuração do projeto da Google Cloud Platform.
  3. Aceda às definições do agente do Dialogflow e verifique o ID do projeto associado ao agente. O projeto da Google Cloud Platform configurado na CLI gcloud deve corresponder ao ID do projeto do agente.
  4. Se os IDs dos projetos não corresponderem, execute gcloud config set project PROJECT-ID, substituindo PROJECT-ID pelo ID do projeto do passo 3.

Configure uma conta de serviço

Tem de criar uma conta de serviço no seu projeto da Google Cloud Platform para que a integração funcione corretamente. Para mais detalhes, consulte a documentação do Dialogflow.

Siga estes passos para criar uma conta de serviço e configurar a integração:

  1. Selecione o projeto da Google Cloud Platform associado aos seus recursos do Agent Assist.
  2. Clique no menu de navegação na Google Cloud Platform Console, passe o cursor do rato sobre IAM e administrador e clique em Contas de serviço.
  3. Clique em + CRIAR CONTA DE SERVIÇO, preencha os detalhes e atribua-lhe a função API de Cliente do Dialogflow.

Ative as APIs necessárias

  1. Navegue para o projeto da Google Cloud Platform pretendido.
  2. Clique no menu de navegação na Google Cloud Platform Console e selecione Faturação. Certifique-se de que a faturação está ativada para o seu projeto.
  3. Ative o Cloud Build e a API Cloud Run para este projeto.
  4. Clone o seguinte repositório git para a sua máquina local ou ambiente de desenvolvimento: git clone [repository url].
  5. Abra o diretório raiz do repositório na sua máquina local ou ambiente de desenvolvimento.

Implemente através da CLI

No terminal local, altere o diretório ativo para o diretório raiz do repositório.

Execute o seguinte comando para guardar o estado do seu repositório no Google Cloud Platform Container Registry. Substitua PROJECT-ID pelo ID do seu projeto da Google Cloud Platform.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-application-server

Implemente a sua integração em produção com o seguinte comando. Substitua PROJECT-ID pelo ID do projeto da Google Cloud Platform do seu agente e SERVICE-ACCOUNT-EMAIL pelo email do cliente da sua conta de serviço.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Quando lhe for pedida uma região, selecione uma região (por exemplo, us-central1).
  • Quando lhe for pedido um nome de serviço, prima Enter para aceitar a predefinição.
  • Quando lhe for pedido para permitir invocações não autenticadas, prima y.

Para mais informações, consulte a documentação do Cloud Run. Pode ver uma lista das implementações de integração ativas em Cloud Run na Google Cloud Platform Console.

Variáveis de ambiente

Siga as instruções do Cloud Run para definir as variáveis de ambiente necessárias.

Assim que o serviço for implementado, a CLI vai gerar o URL para o qual a aplicação foi implementada (target_url). Regresse e defina a variável de ambiente APPLICATION_SERVER_URL com este valor.

Encerre o servidor de aplicações

Para encerrar o servidor de aplicações, tem de eliminar o serviço do Cloud Run.

No seu terminal local, execute o seguinte comando e selecione a plataforma de destino escolhida anteriormente para listar as implementações ativas:

    gcloud beta run services list

Em seguida, execute o seguinte comando:

   gcloud beta run services delete agent-assist-modules-application-server