Neste guia, descrevemos as etapas necessárias para configurar um servidor de aplicativos que pode ser usado para renderizar sugestões do Agent Assist no LivePerson. O servidor de aplicativos é usado com um servidor proxy no mesmo diretório. Para instruções sobre como renderizar os módulos UI no espaço de trabalho do agente, consulte a página principal do tutorial do LivePerson. É necessário ter um servidor de aplicativos e um servidor proxy 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.
Configuração
Ao implantar o serviço, é preciso 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. A 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 servidor proxy forem implantados e retornarem os valores de URL necessários.
LP_ACCOUNT_ID: ID da conta do LivePerson.LP_CLIENT_ID: seu ID do cliente do LivePerson. Ele será fornecido pela LivePerson depois que o aplicativo Conversational Cloud for instalado. Pule essa variável por enquanto. Você vai atualizá-la quando as informações forem fornecidas.LP_CLIENT_SECRET: sua chave secreta do cliente do LivePerson. Ele será fornecido pela LivePerson depois que o aplicativo 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 conta e procure o domínio de "sentinel".LP_ACCOUNT_CONFIG_READONLY_DOMAIN: acesse https://developers.liveperson.com/domain-api.html. Insira o número da conta e procure o domínio de "accountConfigReadOnly".APPLICATION_SERVER_URL: URL do servidor de aplicativos da UI. Pule por enquanto e atualize depois que o servidor de aplicativos for implantado e você souber o URL.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_IDpelo ID do projeto no Google Cloud. Não inclua o prefixoprojects/.
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 essa implantação:
- Na página de documentação da CLI gcloud, selecione seu SO e siga as instruções de instalação.
- Execute
gcloud config get-value projectpara verificar a configuração do projeto do Google Cloud Platform. - 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 gcloud precisa corresponder ao ID do projeto do agente.
- Se os IDs do projeto não forem iguais, execute
gcloud config set project PROJECT-ID, substituindoPROJECT-IDpelo ID do projeto da etapa 3.
Configurar uma conta de serviço
É preciso criar uma conta de serviço no 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:
- Selecione o projeto do Google Cloud Platform associado aos recursos do Agent Assist.
- 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.
- Clique em + CRIAR CONTA DE SERVIÇO, preencha os detalhes e atribua a ela o papel de API Dialogflow Client.
Ativar APIs obrigatórias
- Acesse o projeto desejado do Google Cloud Platform.
- Clique no menu de navegação no console do Google Cloud Platform e selecione Faturamento. Verifique se o faturamento foi ativado para o projeto.
- Ative o Cloud Build e a API Cloud Run para este projeto.
- Clone o seguinte repositório git na máquina local ou no ambiente de desenvolvimento:
git clone [repository url]. - Abra o diretório raiz do repositório na máquina local ou no ambiente de desenvolvimento.
Criar um repositório do Docker no Artifact Registry
Use o comando
gcloud artifacts repositories create
para criar um repositório do Docker, onde você vai salvar o estado do seu
repositório:
gcloud artifacts repositories create REPOSITORY-NAME --repository-format=docker --location=LOCATION
Substitua:
REPOSITORY-NAME: o nome do repositório do Docker.LOCATION: o local do Google Cloud em que você quer que o repositório do Docker seja criado.
Implantar usando a CLI
No terminal local, mude o diretório ativo para o diretório raiz do repositório.
Use o comando gcloud builds submit
para salvar o estado do repositório no
Google Cloud Artifact Registry:
gcloud builds submit --tag=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server
Substitua:
LOCATION: o local do Google Cloud em que você criou o repositório do Docker.PROJECT-ID: o ID do projeto do Google Cloud em que você criou o repositório do Docker.REPOSITORY-NAME: o nome do repositório do Docker.
Implante sua integração em tempo real usando o
comando gcloud run deploy:
gcloud run deploy --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-NAME/agent-assist-modules-application-server --service-account=SERVICE-ACCOUNT-EMAIL --memory=1Gi
Substitua:
LOCATION: o local do Google Cloud em que você criou o repositório do Docker.PROJECT-ID: o ID do projeto do Google Cloud em que você criou o repositório do Docker.REPOSITORY-NAME: o nome do repositório do Docker.SERVICE-ACCOUNT-EMAIL: o e-mail do cliente da conta de serviço.
Enquanto o comando é executado, siga estas etapas:
- Quando uma região for solicitada, selecione uma (por exemplo,
us-central1). - Quando for solicitado um nome de serviço, pressione Enter para aceitar o padrão.
- Quando for solicitado que você permita invocações não autenticadas, pressione
y.
Para mais informações, consulte a documentação do Cloud Run. É possível ver 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.
Encerre o servidor de aplicativos.
Para encerrar o servidor de aplicativos, é preciso excluir o serviço do Cloud Run.
No terminal local, execute o comando a seguir e selecione a plataforma de destino escolhida anteriormente para listar as implantações ativas:
gcloud beta run services list
Em seguida, execute o seguinte comando:
gcloud beta run services delete agent-assist-modules-application-server