Este guia descreve as etapas necessárias para configurar um servidor proxy. Você usará o servidor proxy em conjunto com um servidor de aplicativos para simplificar a autenticação com a API Dialogflow. 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 aplicativos e um servidor proxy no mesmo diretório são necessários para 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.
Antes de começar
Verifique se você já implantou o servidor de aplicativos antes de iniciar este tutorial.
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. O LivePerson vai fornecer
essas variáveis quando você
criar um aplicativo do Conversational Cloud,
e você as atualizará nesse momento. Você também vai pular inicialmente APPLICATION_SERVER_URL e DF_PROXY_SERVER_URL, definindo as duas depois que os servidores de aplicativos e proxy forem implantados e retornarem os valores necessários.
LP_ACCOUNT_ID: ID da conta do LivePerson.LP_CLIENT_ID: ID do cliente do LivePerson. Ele será fornecido pelo LivePerson depois que o aplicativo do Conversational Cloud for instalado. Pule essa variável por enquanto. Você vai atualizá-la quando as informações forem fornecidas.LP_CLIENT_SECRET: chave secreta do cliente do LivePerson. Ela será fornecida pelo LivePerson depois que o aplicativo do Conversational Cloud for instalado. Pule essa variável por enquanto. 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 do "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 de "accountConfigReadOnly".APPLICATION_SERVER_URL: URL do servidor de aplicativos da UI.JWT_SECRET: uma frase "secreta" que será usada para assinar os tokens de autenticação. Você pode usar qualquer frase, embora uma chave secreta longa e aleatória seja mais segura. Consulte as práticas recomendadas em https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
Arquivo .env de amostra:
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
Implantar
O servidor de aplicativos da interface precisa ser implantado em um serviço de hospedagem do Google Cloud. Recomendamos usar o Google App Engine ou o Cloud Run. As etapas abaixo usam o Cloud Run como exemplo.
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
Container Registry do Google Cloud Platform. Substitua PROJECT-ID pelo ID do projeto do Google Cloud Platform.
gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-proxy-server
Implante sua integração para produção usando o comando a seguir. Substitua PROJECT-ID pelo ID do projeto do Google Cloud Platform do 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-proxy-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
- Quando uma região for solicitada, selecione uma região (por exemplo,
us-central1). - Quando o nome do serviço for solicitado, 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. É possível conferir uma lista das implantações de integração ativas no 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 DF_PROXY_SERVER_URL para o servidor de aplicativos usando esse valor.
Desligar o servidor proxy
Para desligar o servidor de aplicativos, é necessário excluir o serviço do Cloud Run.
No terminal local, execute o comando a seguir e selecione a plataforma segmentada escolhida anteriormente para listar as implantações ativas:
gcloud beta run services list
Em seguida, execute o comando a seguir:
gcloud beta run services delete agent-assist-modules-proxy-server