Adicionar Adaptive Cards em AI Agents (Cognigy) para Virtual Agent Hub e NiCE CXone DX Chat
Adaptive Cards permitem apresentar conteúdo rico e estruturado — como texto, imagens e botões de ação — em uma conversa em vez de texto simples. AI Agents (Cognigy) oferece suporte nativo a Adaptive Cards por meio do nó Say, portanto, você pode projetar uma definição de cartão e renderizá-la em qualquer canal conectado por meio do Virtual Agent Hub, incluindo os canais de chat NiCE CXone DX compatíveis.
Nem todos os canais de chat DX suportam Adaptive Cards. Por exemplo, alguns canais de mensagens, como WhatsApp, podem não suportar Cartões adaptáveis.
Este tópico explica como adicionar um Adaptive Card nativo a um nó Say, referenciar uma variável de contexto dentro do cartão, pré-visualizar o cartão no AI Agents (Cognigy) e testá-lo em uma interação de chat DX NiCE CXone.
Antes de começar
Certifique-se de que:
-
Um projeto AI Agents (Cognigy) com um Fluxo que você pode editar.
-
Virtual Agent Hub configurado e conectado ao seu projeto AI Agents (Cognigy). Consulte Setup AI Agents (Cognigy) Text Bot in Virtual Agent Hub para obter detalhes.
-
Um canal de chat DX NiCE CXone criado e vinculado em Virtual Agent Hub.
Adicionar um Adaptive Card Nativo a um Nó Say
-
Em AI Agents (Cognigy), selecione Construir > Fluxos.
-
Selecione o Fluxo que deseja editar ou selecione o ícone de adição (+) no local em que o nó Say deve ser adicionado.
-
Clique no nó Say para abrir o painel Edit Node.
Em Canais, certifique-se de que o Canal AI usado por Virtual Agent Hub esteja selecionado. Não selecione o canal CXone ao criar um Adaptive Card nativo
-
De Output Type na lista suspensa, selecione Adaptive Card.
-
No campo de definição JSON, cole o Adaptive Card JSON do seu cartão. Um link acima deste campo abre o Microsoft Adaptive Card Designer, uma ferramenta visual para criar e visualizar cartões.
-
No Adaptive Card Designer, construa ou cole o layout do seu cartão e, em seguida, selecione Copy card payload para copiar o JSON do cartão.
-
Retorne ao nó Say em AI Agents (Cognigy) e cole o JSON copiado no campo de definição JSON.
-
AI Agents (Cognigy) renderiza uma visualização em tempo real do cartão diretamente abaixo do campo JSON para que você possa confirmar que está correto.
-
Clique em Salvar Nó para salvar o nó.
Usar uma Variável de Contexto em um Adaptive Card
Você pode referenciar uma variável de contexto dentro de uma definição de Adaptive Card para que o cartão exiba dados dinâmicos, como o nome do cliente ou o número do pedido.
-
Verifique se a variável de contexto está preenchida antes da execução do nó Say. O valor pode ser definido por um nó set Context ou por outro processo no Fluxo que preenche o Contexto.
-
Abra o nó Say em que o Adaptive Card está configurado.
-
Na definição JSON do cartão, faça referência à variável de contexto usando a sintaxe de variável AI Agents (Cognigy) no ponto do cartão em que o valor deve aparecer.
Sintaxe
{\"type\": \"TextBlock\","text": "{{context.dynamicVariable}}"}Exemplo:
{"type": "TextBlock","text": "{{context.account_number}}"} -
Salve o nó e use o Interaction Panel para testar se o valor da variável é exibido corretamente no cartão.
Durante a visualização em AI Agents (Cognigy), as variáveis de contexto são exibidas como espaços reservados porque nenhum valor em tempo de execução foi fornecido. O valor real é substituído somente quando o Fluxo é executado e a variável de contexto é preenchida.
Testar o Adaptive Card no NiCE CXone DX Chat
Depois que o nó Say for configurado e salvo, verifique se o cartão é renderizado corretamente para os usuários finais no canal de chat NiCE CXone DX.
-
Confirme se o AI Agents (Cognigy), o Virtual Agent Hub e o canal DX NiCE CXone estão totalmente configurados e vinculados.
-
Confirme se o Fluxo está configurado para acionar o nó Say que contém o Adaptive Card (por exemplo, quando um usuário insere uma palavra-chave específica).
-
Abra o canal de chat NiCE CXone DX como um usuário final e envie a mensagem ou palavra-chave que aciona o cartão.
-
Confirmar se o Adaptive Card é exibido conforme esperado na janela de chat.
Nativo Adaptive Card Versus JSON Personalizado no Canal NiCE CXone
As opções de Tipo de Saída disponíveis em um nó Say dependem do canal que você seleciona. Isso pode ser motivo de confusão quando um Fluxo usa tanto o canal nativo AI (Virtual Agent Hub/ NiCE CXone DX chat) quanto um canal CXone.
-
Canal AI (nativo, usado pelo chat DX Virtual Agent Hub e NiCE CXone): o nó Say oferece Adaptive Card como um Tipo de Saída dedicado. Cole o JSON bruto do Adaptive Card diretamente, e AI Agents (Cognigy) exibe uma pré-visualização em tempo real.
-
Canal CXone: o nó Say não oferece uma opção Adaptive Card. Em vez disso, selecione Custom Json como o Tipo de Saída e envolva a definição do cartão na estrutura específica do NiCE CXone, com os campos uiComponent, data e action.
-
Escolha o Tipo de Saída que corresponda ao canal selecionado no nó Say. Um cartão criado para o tipo de saída Adaptive Card do canal AI não será renderizado corretamente se for colado no campo Custom Json de um canal CXone sem adaptá-lo à estrutura uiComponent/data/action, e vice-versa.
-
As implementações existentes de CXone Custom Json continuam funcionando e não estão sendo removidas. No entanto, as novas implementações devem usar a Adaptive Card saída nativa sempre que possível, pois é mais simples de configurar, não requer o wrapper/cabeçalho específico do CXone e oferece uma visualização em tempo real no nó Say.