Esta página foi traduzida pela API Cloud Translation.

Implemente o servidor de aplicações do Genesys Cloud

Pode configurar um servidor de aplicações para renderizar sugestões do Agent Assist na Web no Genesys Cloud.

Objetivos

A integração do Genesys Cloud envolve os seguintes processos:

Implemente o servidor de back-end para que o módulo de IU chame a API Dialogflow, registe um token de autenticação e configure o Cloud Pub/Sub e o Memorystore para Redis.
Implemente o servidor de aplicações do Genesys Cloud para renderizar o módulo da IU do Agent Assist no Cloud Run.
Crie um cliente OAuth.
Conclua 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 na Web e as ferramentas de mensagens do Genesys Cloud para testar a integração.

Antes de começar

Tem de concluir as seguintes ações antes de iniciar a integração do Genesys Cloud:

Instale a CLI Google Cloud, se ainda não a tiver configurado.
Siga as Google Cloud instruções para criar uma conta de serviço e atribuir a função de cliente da API Dialogflow.
Contacte agent-assist-ui-modules-support@google.com para aceder ao repositório do Genesys Cloud.
Implemente um back-end de módulos da IU do Agent Assist. Quando implementar o servidor de back-end, especifique a variável de ambiente AUTH_OPTION como GenesysCloud, seguindo as instruções de implementação.

Implemente o servidor de aplicações do Genesys Cloud através da CLI

Clone o repositório Git para a sua máquina local ou ambiente de desenvolvimento com o seguinte código:
```
git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
```
No seu terminal local, use o seguinte código para alterar o diretório ativo para o diretório raiz do repositório onde o ficheiro Docker reside antes de executar as compilações da CLI Google Cloud.
```
cd genesyscloud/frontend
```
Quando lhe for pedido um nome de serviço, prima Enter para aceitar a predefinição.
Implemente a integração através do seguinte comando. Substitua PROJECT-ID pelo ID do projeto Google Cloud do seu agente, UI_MODULE_SERVICE_ACCOUNT pelo email do cliente da sua 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 Introduzir para aceitar o nome do serviço predefinido.

Para ver detalhes, consulte a documentação do Cloud Run. Na Google Cloud consola, pode ver uma lista das implementações de integração ativas em Cloud Run.

Crie um cliente OAuth

Siga as instruções na documentação do Genesys Cloud para criar um novo cliente OAuth (concessão implícita de token).
Certifique-se de que o tipo de concessão é Concessão implícita (navegador).
Adicione o URL da sua aplicação à secção URIs de redirecionamento autorizados.

Atualize a duração do token do cliente OAuth 2.0 para 3600 segundos. Isto corresponde ao token JWT para o acesso à API Dialogflow de 1 hora.

{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, como projects/your-project/locations/your-location/conversationProfiles/abc123.
Substitua {FEATURES} por uma lista separada por vírgulas de funcionalidades do Assistente do agente que quer que a aplicação inclua. Importante: inclua apenas funcionalidades configuradas no seu perfil de conversa. O Genesys Cloud suporta as seguintes funcionalidades
Para adicionar âmbitos ao cliente OAuth, navegue até à secção Âmbito e selecione as suas etiquetas.

. Os âmbitos devem incluir alertas, autorização, conversas, notificações e organização.

Exemplo de URL:

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

Preencha as variáveis de ambiente

A aplicação 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 US West(Oregon). O valor predefinido é mypurecloud.com.
GENESYS_CLOUD_ENVIRONMENT: ambiente de nuvem do Genesys. O valor predefinido é prod.
PROXY_SERVER: o URL do conector de back-end do Assistente do agente.
APPLICATION_SERVER_URL: URL do servidor da aplicação de IU.
PROJECT_ID: o ID do seu Google Cloud projeto.
CONVERSATION_PROFILE: o perfil de conversa a usar. Este deve corresponder ao perfil no URL de redirecionamento do cliente OAuth.
FEATURES: constante separada por vírgulas para funcionalidades do Assistente do agente. Isto deve corresponder às funcionalidades no URL de redirecionamento do cliente OAuth.
CHANNEL: escolha o tipo de integração. O valor pode ser "voz" ou "chat".

Exemplo de ficheiro .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 cria um cliente OAuth, o Genesys Cloud também fornece um ID de cliente.

Execute o comando de implementaçã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 aplicações do Genesys Cloud tem de ser implementado num Google Cloud serviço de alojamento. Use o App Engine ou o Cloud Run.

Encerre o servidor de aplicações

Elimine 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 apresentar as implementações ativas.

Execute o seguinte comando:

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

Exclusão de responsabilidade de preços

Se usar a integração do Genesys Cloud, existe um custo associado ao serviço Cloud Run subjacente.

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