Criar e integrar agentes do Dialogflow

Antes de criar qualquer tipo de agente virtual, é necessário criar um agente do Customer Experience Agent Studio ou do Dialogflow e integrá-lo à Contact Center AI Platform. Neste documento, explicamos como fazer a integração com um Dialogflow.

Plataformas de agente virtual do Dialogflow

Dialogflow ES: essa plataforma só é compatível com a configuração de agentes para canais de chat. Selecione essa opção para integrar agentes virtuais criados usando o Dialogflow ES.

Dialogflow CX: essa opção é compatível com a configuração de agentes para canais de chat e voz. As interações do agente incluem funções avançadas, como suporte a DTMF, interrupção do consumidor, assistente de chamada, análise de fala, Insights da experiência do cliente e muitas outras. Selecione essa opção para integrar agentes virtuais criados com o Dialogflow CX.

Respostas específicas do canal

(CCAI Platform) define automaticamente o valor do canal ao chamar a API Dialogflow. As ligações têm o canal definido como voice, e as conversas por chat são definidas como chat. Isso se aplica ao suporte de agente virtual para chat em dispositivos móveis, chat na Web e URA. Esses recursos permitem criar respostas específicas do canal nos agentes virtuais. Para mais informações, consulte Mensagens de resposta específicas do canal.

Criar agentes virtuais do Dialogflow ES e do Dialogflow CX

Instruções específicas para a criação de agentes virtuais do Dialogflow CX e de agentes virtuais do Dialogflow ES.

Criar perfil de conversação para agentes virtuais do Dialogflow CX

Depois de criar um agente virtual, para integrá-lo ao portal da plataforma CCAI, é necessário criar um perfil de conversa no console do Agent Assist.

  1. Acesse o Agent Assist.

  2. Selecione Perfis de conversa no menu.

  3. Na lista suspensa "Projeto" na parte de cima, selecione o projeto em que o agente virtual do Dialogflow CX foi criado.

  4. Na lista suspensa "Local" na parte de cima, selecione a região Google Cloud em que o agente virtual está localizado.

  5. Clique em Criar novo. A página Novo perfil de conversa será exibida.

  6. Insira um nome para o perfil de conversa. Esse é o nome que vai aparecer no portal da plataforma CCAI na lista de agentes virtuais disponíveis.

  7. Para vincular o agente virtual do Dialogflow CX ao perfil de conversa:

    1. Navegue até a seção Escolher usar o Dialogflow CX.

    2. Ative a opção Ativar agente virtual.

    3. Insira Dialogflow CX Agent ID no campo Agentes.

  8. O campo Agentes aparece. Selecione o agente virtual que você criou no Dialogflow CX.

Para mais informações, leia sobre os perfis de conversa do Agent Assist.

Os perfis de conversa oferecem a capacidade de usar versões e ambientes do Dialogflow CX. Os ambientes são espaços isolados em que é possível implantar diferentes versões do agente de CX do Dialogflow CX. Isso permite gerenciar e testar várias versões do seu agente virtual de maneira controlada.

Crie uma conta de serviço e uma chave

A plataforma CCAI se integra ao Dialogflow CX usando a API Dialogflow. O acesso à API é controlado usando contas de serviço do Google Cloud e a chave de conta de serviço associada. A conta de serviço e a chave associada são específicas do projeto. Portanto, se vários agentes virtuais estiverem sendo usados em um único projeto, a mesma conta de serviço e chave poderão ser reutilizadas.

As etapas a seguir mostram o processo de criação da chave de serviço no Google Cloud. Para mais informações sobre as contas de serviço do Google, consulte O que são contas de serviço?

Se você já criou uma chave de serviço com acesso ao Dialogflow CX, pode pular esta seção. No entanto, é necessário inserir uma chave de serviço no portal da plataforma CCAI para vincular um agente virtual do Dialogflow CX.

Para criar uma conta de serviço, conceda as permissões corretas e gere uma chave de conta de serviço. Siga estas etapas:

  1. Acesse o console doGoogle Cloud . Um projeto padrão é exibido.

  2. No menu suspenso da barra de ferramentas, selecione o projeto do Google que você usou para configurar o agente do Dialogflow CX.

  3. Selecione IAM e administrador.

  4. Na navegação lateral, selecione Contas de serviço. O console da conta de serviço será carregado.

  5. Clique em + Criar conta de serviço.

Insira os detalhes da conta de serviço no serviço Google Cloud

  1. Insira os detalhes da conta de serviço.

    1. Nome de exibição para esta conta de serviço.

    2. O ID da conta de serviço é obrigatório e precisa ser exclusivo.

    3. Descreva como a conta de serviço será usada.

    4. Conceda a essa conta de serviço acesso a um projeto.

  2. No menu suspenso Selecionar um papel: atribua o papel Dialogflow API Admin à conta de serviço.

  3. Clique em Continuar.

Editar ações na página de contas de serviço

A página de contas de serviço do Google Cloud exibe todas as contas de serviço associadas ao seu projeto.

Página de contas de serviço

Para criar uma chave de conta de serviço, consulte Criar uma chave de conta de serviço. Siga as práticas recomendadas pelo Google para armazenar sua chave.

Com base em como sua empresa lida com a segmentação no Dialogflow CX, é possível criar várias entradas de plataforma de agente virtual e adicionar agentes de CX específicos do Dialogflow CX ou criar uma plataforma com muitos agentes de CX do Dialogflow CX.

Repita as etapas anteriores para cada agente de CX do Dialogflow CX que você precisa integrar ao portal da plataforma CCAI.

Adicionar uma plataforma de agente virtual

Dialogflow ES: essa plataforma só é compatível com a configuração de agentes para canais de chat. Selecione esta opção para integrar agentes criados usando o Dialogflow ES.

Dialogflow CX: essa opção é compatível com a configuração de agentes para canais de chat e voz. As interações do agente incluem funções avançadas, como suporte a DTMF, interrupção do consumidor, rastreamento do CCAI Insights, assistente de chamada, análise de sentimento e outras. Selecione essa opção para integrar agentes criados usando o Dialogflow CX.

Selecione essa opção para integrar agentes virtuais criados com o Dialogflow CX.

  1. Acesse Configurações > Configurações do desenvolvedor > Plataforma de agente virtual.

  2. Clique em + Adicionar plataforma.

    A caixa de diálogo Adicionar uma plataforma de agente virtual vai aparecer.

    Adicionar uma página de plataforma de agente virtual

  3. Insira um nome para a nova plataforma. Considere usar o nome do projeto em que os agentes virtuais foram criados.

  4. Selecione um dos seguintes serviços:

    • Dialogflow ES

    • Dialogflow CX

  5. Clique em Criar.

  6. Ao lado da nova plataforma de agente virtual na lista de plataformas de agente virtual, ative a plataforma de agente virtual para Ativada.

Os agentes virtuais integrados usando o Dialogflow CX vão usar a API StreamingAnalyzeContent, que oferece o melhor suporte para entradas DTMF e futuras atualizações de agente virtual.

Status da plataforma de agente virtual

A CCAI Platform valida as chaves de conta de serviço com base na estrutura JSON e na validade da chave. Um agente virtual do Dialogflow CX só é totalmente autenticado quando a chave está no estado Válido:

  • Válido: todos os fluxos de trabalho na plataforma são válidos.

  • Requer atenção: um ou mais fluxos de trabalho na plataforma são inválidos. Substitua por chaves de conta de serviço válidas para resolver o problema.

  • Inválido: todos os fluxos de trabalho na plataforma são inválidos. Quando o status de uma plataforma é inválido, ela é desativada automaticamente. Substitua as chaves de conta de serviço inválidas por chaves válidas para resolver o problema.

Se o status for Inválido ou Requer atenção, gere chaves de conta de serviço para as chaves inválidas e substitua-as pelas novas. Para mais informações, consulte Criar e excluir conta de serviço de serviço.

Quando as etapas de configuração forem concluídas, seus agentes virtuais estarão prontos. Para mais informações sobre como gerenciá-los, consulte Atribuir agentes virtuais a filas.

Suporte para resposta parcial no Dialogflow CX

A plataforma CCAI é compatível com o recurso de resposta parcial no Dialogflow CX. Isso é útil principalmente quando o agente virtual precisa chamar um webhook que provavelmente vai levar algum tempo para ser executado e retornar uma resposta. Com a resposta parcial ativada, o Dialogflow CX pode enviar imediatamente uma mensagem de fulfillment inicial ao usuário final, como "Aguarde um momento enquanto procuro isso". Dessa forma, enquanto o webhook é executado e a mensagem de fulfillment final é gerada, o usuário final espera um pouco em vez de presumir que há um problema. Para mais informações, consulte Resposta parcial para API de streaming.

O Dialogflow CX também permite especificar se a reprodução da resposta parcial precisa ser cancelada ao retornar o fulfillment final para a plataforma da CCAI. Se o cancelamento da resposta parcial estiver ativado, a CCAI Platform vai encerrar a reprodução do fulfillment inicial se ele ainda estiver sendo reproduzido e, em seguida, vai iniciar a reprodução do fulfillment final. Isso permite que você responda com uma resposta parcial que pode incluir o código da Linguagem de Marcação de Síntese de Fala (SSML, na sigla em inglês) para reproduzir um arquivo de áudio, como um som de digitação simulado. O exemplo a seguir é um fulfillment do Dialogflow CX que faz isso:

<speak>
  One moment while I look up your order.
  <audio src="typing-sound.mp3">
    <desc>Typing sound</desc>
    PURR (sound didn't load)
  </audio>
</speak>