Implantar o servidor de aplicativos Genesys Cloud

É possível configurar um servidor de aplicativos para renderizar sugestões do Agent Assist 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 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 do Genesys Cloud para renderizar o módulo de IU do Agent Assist 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 Agent Assist com o widget de interação no Genesys Cloud.
Configure o Messenger no Genesys Cloud.
Use o chat da Web e as ferramentas de mensagens do Genesys Cloud para testar a integração.

Antes de começar

Conclua as ações a seguir antes de iniciar a integração do Genesys Cloud:

Instale a Google Cloud CLI, caso ainda não a tenha configurado.
Siga as Google Cloud instruções para criar uma conta de serviço e atribuir o papel de cliente da API Dialogflow.
Entre em contato com agent-assist-ui-modules-support@google.com para acessar o repositório do Genesys Cloud.
Implante um back-end de módulos de IU do Agent Assist backend. Ao implantar o servidor de back-end, especifique a variável de ambiente AUTH_OPTION como GenesysCloud, seguindo as instruções de implantação.

Implantar o servidor de aplicativos do Genesys Cloud usando a CLI

Clone o repositório do Git na sua máquina local ou ambiente de desenvolvimento com o seguinte código:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
No terminal local, use o código a seguir para mudar o diretório ativo para o diretório raiz do repositório em que o arquivo do Docker reside antes de executar os builds da Google Cloud CLI.
```
cd genesyscloud/frontend
```
Quando o nome do serviço for solicitado, pressione Enter para aceitar o padrão.
Implante a integração usando o comando a seguir. Substitua PROJECT-ID pelo ID do projeto do agente Google Cloud , UI_MODULE_SERVICE_ACCOUNT pelo e-mail do cliente da conta de serviço e defina o REGION 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 do serviço padrão.

Para mais detalhes, consulte a documentação do Cloud Run. No Google Cloud console, é possível conferir uma lista das implantações de integração ativas no Cloud Run.

Crie um cliente OAuth

Siga as instruções na documentação do Genesys Cloud para criar um cliente OAuth.
Verifique se o tipo de concessão é Autorização de código / PKCE.
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 à duração padrão do token JWT de 1 hora para acesso à API Dialogflow. Se você precisar de uma duração personalizada, atualize as durações dos tokens OAuth e JWT de acordo.
```
{Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}
```
Substitua {APPLICATION_SERVER_URL} pelo URL do servidor de aplicativos da UI.
Substitua CONVERSATION_PROFILE_NAME pelo nome do perfil de conversa, como projects/your-project/locations/your-location/conversationProfiles/abc123.
Substitua {FEATURES} por uma lista separada por vírgulas dos recursos do Agent Assist que você quer que o aplicativo inclua. Importante: inclua apenas os recursos configurados no seu perfil de conversa. O Genesys Cloud oferece suporte aos seguintes recursos
Para adicionar escopos ao cliente OAuth, acesse a seção Escopos.
Selecione os seguintes escopos: alerting, authorization, conversations, notifications, messaging e organization.

URL de exemplo:

https://my-project.wm.run.app?conversationProfile=projects/my-project/conversationProfiles/abc123&features=CONVERSATION_SUMMARIZATION,AGENT_COACHING,PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST

Recomendamos ativar a autenticação pop-out para iframes incorporados para garantir uma experiência de login perfeita.

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 o Oeste dos EUA(Oregon). O valor padrão é mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: ambiente do Genesys Cloud. O valor padrão é prod.
PROXY_SERVER: o URL do conector de back-end do Agent Assist.
APPLICATION_SERVER_URL: URL do servidor de aplicativos da UI.
PROJECT_ID: o ID do Google Cloud projeto do.
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 "voice" ou "chat".

Arquivo .env de amostra:

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}

Ao criar um cliente OAuth, o Genesys Cloud também fornece um ID do cliente.

Execute o comando de implantação com 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_ENVIRONMENT=$GENESYS_CLOUD_ENVIRONMENT~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 Google Cloud . Use o App Engine ou o Cloud Run.

Desligar o servidor de aplicativos

Exclua o serviço do Cloud Run.
No terminal local, execute o seguinte comando:
```
gcloud run services list
```
Selecione a plataforma segmentada escolhida anteriormente para listar as implantações ativas.

Execute este comando:

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

Aviso de preço

Se você usar a integração do Genesys Cloud, haverá um custo associado ao serviço do Cloud Run.

Implantar o servidor de aplicativos Genesys Cloud Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.