Partilhar via


Cartões Adaptativos para Desenvolvedores de Bots

As Cartas Adaptativas são uma ótima opção para Bots. Permitem-te criar um cartão uma vez e fazê-lo renderizar lindamente dentro de várias aplicações, como o Microsoft Teams, o teu próprio site e mais.

Observação

O Skype não é suportado na pré-visualização atual. Consulte a página de Estado do Parceiro para as últimas novidades.

Integração do Bot Framework

Com o Bot Framework podes escrever um único bot que consiga conversar com utilizadores através de vários "canais", como Skype, Microsoft Teams, Facebook Messenger, etc.

Walkthrough

É bastante simples adicionar um Cartão Adaptativo ao teu bot.

Passo 0: Comece com uma mensagem básica

Aqui está uma carga útil padrão do Bot Framework message que pode ser enviada para qualquer canal e exibir texto ao utilizador.

{
   "type": "message",
   "text": "Plain text is ok, but sometimes I long for more..."
}

Passo 1: Adicionar um Cartão Adaptativo attachment

Para acrescentar alguma riqueza para além do texto, o Bot Framework tem um conceito de attachments.

Vamos anexar um Cartão Adaptativo que mostre texto personalizado.

Cartão adaptativo básico

{
  "type": "message",
  "text": "Plain text is ok, but sometimes I long for more...",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
          {
            "type": "TextBlock",
            "text": "Hello World!",
            "size": "large"
          },
          {
            "type": "TextBlock",
            "text": "*Sincerely yours,*"
          },
          {
            "type": "TextBlock",
            "text": "Adaptive Cards",
            "separation": "none"
          }
        ],
        "actions": [
          {
            "type": "Action.OpenUrl",
            "url": "http://adaptivecards.io",
            "title": "Learn More"
          }
        ]
      }
    }
  ]
}

Passo 2: Constrói cartas ainda mais ricas

Os Cartões Adaptativos oferecem muito mais do que apenas texto personalizável.

É possível:

  • Adicione Images ao seu cartão
  • Organize o seu conteúdo com Containers e Columns
  • Adicionar múltiplos tipos de Actions
  • Colete Input dos seus utilizadores
  • Tenha uma carta show another card
  • Espreita o explorador completo de esquemas!

SDKs de Plataforma

Se o seu bot for desenvolvido usando .NET ou NodeJS, temos bibliotecas para tornar a construção de Adaptive Cards ainda mais fácil.

Platform Install Mais informações
.NET Install-Package AdaptiveCards -IncludePrerelease Bot Framework .NET Docs
NodeJS npm install adaptivecards Bot Framework NodeJS Docs

Estado do canal

O Bot Framework permite-lhe publicar o seu bot em múltiplos canais. Estamos a trabalhar com vários canais para fornecer suporte total aos Adaptive Cards. Consulte a página de Estado do Parceiro para as últimas novidades.

Mergulha já!

Apenas arranhámos a superfície deste tutorial, por isso, por favor, consulte os links abaixo para explorar mais formas de as Adaptive Cards poderem melhorar o seu bot.