É possível configurar um servidor de aplicativos para renderizar sugestões do Assistente do agente na Web no Genesys Cloud.
Objetivos
A integração do Genesys Cloud envolve os seguintes processos:
- Implante o servidor de back-end para que o módulo da UI chame a API Dialogflow, registre um token de autenticação e configure o Cloud Pub/Sub e o Memorystore para Redis.
- Implante o servidor de aplicativos Genesys Cloud para renderizar o módulo da interface do Agente de assistência no Cloud Run.
- Crie um cliente OAuth.
- Preencha as variáveis de ambiente.
- Configure o widget de interação no Genesys Cloud.
- Configure a integração do Assistente do agente com o widget de interação no Genesys Cloud.
- Configure o Messenger no Genesys Cloud.
- Use as ferramentas de chat e mensagens da Web do Genesys Cloud para testar a integração.
Antes de começar
Antes de iniciar a integração com a Genesys Cloud, você precisa concluir as seguintes ações:
- Instale a Google Cloud CLI, caso ainda não tenha configurado.
- Siga as instruções do Google Cloud para criar uma conta de serviço e atribuir a função de cliente da API Dialogflow.
- Entre em contato com agent-assist-ui-modules-support@google.com para ter acesso ao repositório do Genesys Cloud.
- Implante um back-end de módulos de interface do Agent Assist. Ao implantar o servidor de back-end, especifique a variável de ambiente
AUTH_OPTION
comoGenesysCloud
, seguindo as instruções de implantação.
Implantar o servidor de aplicativos Genesys Cloud usando a CLI
- Clone o repositório do git na máquina local ou no ambiente de desenvolvimento com o seguinte código:
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
- No terminal local, use o código abaixo para mudar o diretório ativo para o diretório raiz do repositório em que o arquivo do Docker está localizado antes de executar os builds da Google Cloud CLI.
cd genesyscloud/frontend
- Quando for solicitado um nome de serviço, pressione Enter para aceitar o padrão.
- Implante a integração usando o comando a seguir. Substitua
PROJECT-ID
pelo ID do projeto Google Cloud do agente,UI_MODULE_SERVICE_ACCOUNT
pelo e-mail do cliente da conta de serviço e configure oREGION
para o Cloud Run.gcloud run deploy $AA_MODULE_APPLICATION_SERVER
--source= ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
- Clique em Enter para aceitar o nome de serviço padrão.
Para mais detalhes, consulte a documentação do Cloud Run. No console do Google Cloud , você pode conferir uma lista das implantações de integração ativas em Cloud Run.
Criar um cliente OAuth
- Siga as instruções na documentação do Genesys Cloud para criar um novo cliente OAuth (permissão implícita de token).
- Verifique se o tipo de concessão é Conceito implícito (navegador).
- Adicione o URL do aplicativo à seção URIs de redirecionamento autorizados.
- Atualize a duração do token do cliente OAuth 2.0 para 3.600 segundos. Isso corresponde ao token JWT para o acesso de 1 hora à API Dialogflow.
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
- Substitua
CONVERSATION_PROFILE_NAME
pelo nome do perfil de conversa, comoprojects/your-project/locations/your-location/conversationProfiles/abc123
. - Substitua
FEATURES
por uma lista separada por vírgulas dos recursos do Assistente do agente que você quer incluir no aplicativo. Inclua apenas os recursos configurados no seu perfil de conversa. A Genesys Cloud oferece suporte aos seguintes recursos:
URL de exemplo:
https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION
Preencha as variáveis de ambiente
O aplicativo Genesys Cloud usa as seguintes variáveis de ambiente. Para definir as variáveis de ambiente, siga as instruções do Cloud Run.
OAUTH_CLIENT_ID
: ID do cliente OAuth do Genesys Cloud.GENESYS_CLOUD_REGION
: região do Genesys Cloud. Por exemplo,usw2.pure.cloud
para a região Oeste dos EUA(Oregon). O valor padrão émypurecloud.com
.GENESYS_CLOUD_ENVIRONMENT
: ambiente de nuvem Genesys. O valor padrão éprod
.PROXY_SERVER
: o URL do conector de back-end do Agente Assist.APPLICATION_SERVER_URL
: URL do servidor do aplicativo da UI.PROJECT_ID
: o ID do projeto do Google Cloud .CONVERSATION_PROFILE
: o perfil de conversa a ser usado. Ele precisa corresponder ao perfil no URL de redirecionamento do cliente OAuth.FEATURES
: constante separada por vírgulas para recursos do Agent Assist. Ele precisa corresponder aos recursos no URL de redirecionamento do cliente OAuth.CHANNEL
: escolha o tipo de integração. O valor pode ser "voz" ou "chat".
Exemplo de arquivo .env:
OAUTH_CLIENT_ID={your-oauth-client-id} GENESYS_CLOUD_REGION={your-pure-cloud-region} GENESYS_CLOUD_ENVIRONMENT={your-pure-cloud-environment} PROXY_SERVER={your-proxy-server-endpoint} PROJECT_ID={your-gcp-project-id} CONVERSATION_PROFILE={your-conversation-profile} FEATURES=ARTICLE_SUGGESTION,CONVERSATION_SUMMARIZATION CHANNEL={use-voice-or-chat}
Quando você cria um cliente OAuth, o Genesys Cloud também fornece um ID do cliente.
Execute o comando de implantação com as variáveis de ambiente atualizadas.
gcloud run deploy $AA_MODULE_APPLICATION_SERVER
--source ./
--service-account=$ui_module_service_account
--memory 1Gi --platform managed
--region us-central1
--allow-unauthenticated
--set-env-vars ^~^OAUTH_CLIENT_ID=$OAUTH_CLIENT_ID~GENESYS_CLOUD_REGION=$GENESYS_CLOUD_REGION~GENESYS_CLOUD_ENVIORNMENT=$GENESYS_CLOUD_ENVIORNMENT~CONVERSATION_PROFILE=$CONVERSATION_PROFILE~FEATURES=$FEATURES~PROJECT_ID=$PROJECT_ID~APPLICATION_SERVER_URL=''~PROXY_SERVER=$PROXY_SERVER~APPLICATION_SERVER_URL=$APPLICATION_SERVER_URL
O servidor de aplicativos do Genesys Cloud precisa ser implantado em um serviço de hospedagem do Google Cloud . Use o App Engine ou o Cloud Run.
Desligar o servidor do aplicativo
- Exclua o serviço do Cloud Run.
- No terminal local, execute o seguinte comando:
gcloud run services list
- Selecione a plataforma de destino escolhida anteriormente para listar as implantações ativas.
- Execute este comando:
gcloud run services delete agent-assist-modules-application-server