Implemente o servidor proxy

Este guia descreve os passos necessários para configurar um servidor proxy. Vai usar o servidor proxy juntamente com um servidor de aplicações para simplificar a autenticação com a API Dialogflow. Para ver 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 no mesmo diretório 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.

Antes de começar

Certifique-se de que já implementou o servidor de aplicações antes de iniciar este tutorial.

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, definindo ambos após a implementação dos servidores de aplicações e proxy, e a devolução dos valores 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 de "accountConfigReadOnly".
  • APPLICATION_SERVER_URL: URL do servidor da aplicação de IU.
  • JWT_SECRET: uma expressão "secreta" que vai ser usada para assinar os tokens de autenticação. Pode usar qualquer expressão, embora um segredo longo e aleatório seja mais seguro. Consulte as práticas recomendadas em https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.

Ficheiro de exemplo .env:

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

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.

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-proxy-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-proxy-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.

Depois de o serviço ter sido 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 DF_PROXY_SERVER_URL para o servidor de aplicações com este valor.

Encerre o servidor proxy

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-proxy-server