Implantar o servidor de aplicativos

Este guia descreve as etapas necessárias para configurar um servidor de aplicativo que pode ser usado para renderizar sugestões do Assistente do agente no LivePerson. O servidor de aplicativo é usado com um servidor proxy no mesmo diretório. Para instruções sobre como renderizar os módulos da UI no espaço de trabalho do agente, consulte a página principal do tutorial do LivePerson. Um servidor de aplicativo e um servidor proxy são necessários antes de renderizar os módulos no LivePerson.

Embora seja possível configurar essa implantação de integração em qualquer plataforma de hospedagem, estas instruções usam o Cloud Run do Google.

Configuração

Ao implantar o serviço, você precisa definir as seguintes variáveis de ambiente. Deixe as variáveis LP_CLIENT_ID e LP_CLIENT_SECRET em branco ao criar o servidor de aplicativos pela primeira vez. O LivePerson vai fornecer essas variáveis quando você criar um aplicativo do Conversational Cloud, e você vai atualizá-las nesse momento. Você também vai pular APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL. Cada uma dessas duas variáveis será definida depois que os servidores de aplicativo e proxy forem implantados e retornarem os valores de URL necessários.

  • LP_ACCOUNT_ID: ID da conta da LivePerson.
  • LP_CLIENT_ID: seu ID do cliente da LivePerson. O LivePerson vai fornecer isso assim que o aplicativo do Conversational Cloud for instalado. (Por enquanto, ignore essa variável. Você vai atualizá-la depois que as informações forem fornecidas).
  • LP_CLIENT_SECRET: sua chave secreta do cliente da LivePerson. Isso será fornecido pelo LivePerson assim que o aplicativo do Conversational Cloud for instalado. (Por enquanto, ignore essa variável. Você vai atualizá-la quando as informações forem fornecidas).
  • LP_SENTINEL_DOMAIN: acesse https://developers.liveperson.com/domain-api.html. Insira o número da sua conta e procure o domínio "sentinel".
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: acesse https://developers.liveperson.com/domain-api.html. Insira o número da sua conta e procure o domínio "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL do servidor do aplicativo da UI. Pule por enquanto e atualize depois que o servidor do aplicativo for implantado e você souber o URL dele.
  • DF_PROXY_SERVER_URL: o URL do servidor proxy. Pule por enquanto e atualize depois que o servidor proxy for implantado e você souber o URL dele.
  • PROJECT_ID pelo ID do projeto no Google Cloud. Não inclua o prefixo projects/.

Arquivo .env de amostra:

    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

Implantar

O servidor de aplicativos da interface precisa ser implantado em um serviço de hospedagem do Google Cloud. Recomendamos o uso do Google App Engine ou do Cloud Run. As etapas abaixo usam o Cloud Run como exemplo.

Configurar uma CLI gcloud

Os processos de implantação descritos neste tutorial usam comandos da CLI gcloud. Siga as etapas abaixo para configurar a CLI gcloud localmente para esta implantação:

  1. Na página de documentação da gcloud CLI, selecione seu SO e siga as instruções de instalação.
  2. Execute gcloud config get-value project para verificar a configuração do projeto do Google Cloud Platform.
  3. Acesse as configurações do agente do Dialogflow e verifique o ID do projeto associado ao agente. O projeto do Google Cloud Platform configurado na CLI do gcloud precisa 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 da etapa 3.

Configurar uma conta de serviço

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

Siga estas etapas para criar uma conta de serviço e configurar a integração:

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

Ativar APIs obrigatórias

  1. Navegue até o projeto do Google Cloud Platform desejado.
  2. Clique no menu de navegação no console da Google Cloud Platform e selecione Faturamento. Verifique se o faturamento foi ativado para o projeto.
  3. Ative o Cloud Build e a API Cloud Run para este projeto.
  4. Clone o repositório git a seguir na sua máquina local ou no 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.

Implantar usando a CLI

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

Execute o comando a seguir para salvar o estado do repositório no Google Cloud Platform Container Registry. Substitua PROJECT-ID pelo ID do projeto do Google Cloud Platform.

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

Implante a integração usando o comando a seguir. Substitua PROJECT-ID pelo ID do projeto do Google Cloud Platform do seu agente e SERVICE-ACCOUNT-EMAIL pelo e-mail do cliente da 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 uma região for solicitada, selecione uma (por exemplo, us-central1).
  • Quando for solicitado o nome de um serviço, pressione Enter para aceitar o padrão.
  • Quando solicitado a permitir invocações não autenticadas, pressione y.

Para mais informações, consulte a documentação do Cloud Run. Você pode conferir uma lista das implantações de integração ativas em Cloud Run no Console do Google Cloud Platform.

Variáveis de ambiente

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

Depois que o serviço for implantado, a CLI vai gerar o URL em que o aplicativo foi implantado (target_url). Volte e defina a variável de ambiente APPLICATION_SERVER_URL usando esse valor.

Desligar o servidor do aplicativo

Para desligar o servidor do aplicativo, você precisa excluir o serviço do Cloud Run.

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

    gcloud beta run services list

Em seguida, execute o comando abaixo:

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