Implantar o servidor de aplicativos Genesys Cloud

É 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:

  1. 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 Pub/Sub e o Memorystore para Redis na nuvem.
  2. Implante o servidor de aplicativos do Genesys Cloud para renderizar o módulo da interface do Assistente do agente no Cloud Run.
  3. Crie um cliente OAuth.
  4. Preencha as variáveis de ambiente.
  5. Configure o widget de interação no Genesys Cloud.
  6. Configure a integração do Agent Assist com o widget de interação no Genesys Cloud.
  7. Configure o Messenger no Genesys Cloud.
  8. Use o chat na 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:

  1. Instale a Google Cloud CLI, caso ainda não tenha feito isso.
  2. Siga as instruções do Google Cloud para criar uma conta de serviço e atribuir a função de cliente da API Dialogflow.
  3. Entre em contato com agent-assist-ui-modules-support@google.com para ter acesso ao repositório do Genesys Cloud.
  4. Implante um back-end de módulos da interface do Agent Assist. 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

  1. Clone o repositório git na sua máquina local ou ambiente de desenvolvimento com o seguinte código:
    git clone https://github.com/GoogleCloudPlatform/agent-assist-integrations
    
  2. 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 Docker reside antes de executar os builds da Google Cloud CLI.
    cd genesyscloud/frontend
    
  3. Quando for solicitado um nome de serviço, pressione Enter para aceitar o padrão.
  4. Implante a integração usando o seguinte comando. Substitua PROJECT-ID pelo ID do projeto do seu 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
  5. Clique em Enter para aceitar o nome padrão do serviço.

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

Criar um cliente OAuth

  1. Siga as instruções na documentação do Genesys Cloud para criar um novo cliente OAuth (concessão implícita de token).
  2. Verifique se o tipo de concessão é Concessão implícita (navegador).
  3. Adicione o URL do aplicativo à seção URIs de redirecionamento autorizados.
  4. Atualize a duração do token do cliente OAuth 2.0 para 3.600 segundos. Isso corresponde ao token JWT para o acesso à API Dialogflow de uma hora.
    {Application_SERVER_URL}?conversationProfile={CONVERSATION_PROFILE_NAME}&features={FEATURES}Replace {APPLICATION_SERVER_URL} with the URL of your UI application server.
    
  5. Substitua CONVERSATION_PROFILE_NAME pelo nome do perfil de conversa, como projects/your-project/locations/your-location/conversationProfiles/abc123.
  6. Substitua {FEATURES} por uma lista separada por vírgulas dos recursos do Assistente do agente que você quer incluir no aplicativo. Importante: inclua apenas recursos configurados no seu perfil de conversa. O Genesys Cloud é compatível com os seguintes recursos:
  7. Para adicionar escopos ao cliente OAuth, navegue até a seção Escopo e selecione suas tags.

. Os escopos precisam incluir alertas, autorização, conversas, notificações e organização.

URL de exemplo:

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

Concluir 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 US West(Oregon). O valor padrão é mypurecloud.com.
  • GENESYS_CLOUD_ENVIRONMENT: ambiente de nuvem do Genesys. O valor padrão é prod.
  • PROXY_SERVER: o URL do conector de back-end do Assistente de IA.
  • APPLICATION_SERVER_URL: URL do servidor de aplicativos 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 os 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 Google Cloud . Use o App Engine ou o Cloud Run.

Desligar o servidor de aplicativos

  1. Exclua o serviço do Cloud Run.
  2. No terminal local, execute o seguinte comando:
    gcloud run services list
    
  3. Selecione a plataforma de destino escolhida anteriormente para listar as implantações ativas.
  4. Execute este comando:
    gcloud run services delete agent-assist-modules-application-server
    

Exoneração de responsabilidade sobre preços

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

A seguir