Usando Adaptive Cards no Copilot Studio

Adaptive Cards são snippets de interface do usuário independentes da plataforma escritos em JSON, que podem ser trocados abertamente por aplicativos e serviços. Quando entregue a um aplicativo específico (geralmente chamado de "host"), a representação JSON é transformada em interface de usuário nativa que se adapta automaticamente ao contexto. Usando Adaptive Cards, você pode projetar e integrar a interface do usuário leve para todas as principais plataformas e estruturas.

Captura de tela de um Cartão Adaptável coletando informações do usuário como parte de uma conversa.

Adaptive Cards são especialmente utilizados em produtos como Microsoft Teams e Outlook, pois o designer de UI não pode prever se o usuário está no modo escuro ou modo claro, por exemplo. De qualquer forma, sem problemas: o Cartão Adaptável simplesmente se adapta!

Note

Copilot Studio dá suporte às versões de esquema Adaptive Cards 1.6 e anteriores. No entanto, a versão do esquema apropriada depende do aplicativo host de destino:

  • O componente Web Chat do Bot Framework (ou seja, o padrão de integração de sites padrão) dá suporte à versão 1.6, mas não dá suporte a Action.Execute
  • O widget de chat ao vivo (usado para Omnichannel para Atendimento ao Cliente) é limitado à versão 1.5
  • O Teams também está limitado à versão 1.5

Além disso, o Copilot Studio renderiza apenas cartões versão 1.6 no chat de teste, não na tela.

Para obter mais informações sobre o esquema Adaptive Cards, consulte Schema Explorer.

Use Adaptive Cards em agentes do Copilot Studio para validar informações do cliente, para fazer perguntas ou simplesmente para aprimorar a experiência de conversa:

Dica

Use os seguintes recursos para criar novos Adaptive Cards:

  • O site Adaptive Cards, para documentação e exemplos de esquema.
  • Tópicos anteriores do agente (duplicar e revisar cartões anteriores para manter a consistência).
  • ChatGPT ou Copilot no Bing para gerar o conteúdo do JSON para um cartão.
  • Power Apps ou Power Automate (para projetar o cartão).

Práticas recomendadas para cartões interativos

Ao usar cartões adaptáveis interativos (cartões com botões Enviar ), verifique se cada ação de envio inclui dados exclusivos que identificam o cartão ou a ação. O uso de dados exclusivos específicos de cartão ou ação reduz o risco de comportamento inesperado quando vários cartões estão visíveis ou quando um usuário seleciona um botão em um cartão anterior.

Saiba mais no comportamento do botão Enviar para agentes com cartões consecutivos.

  • Last updated on