Udostępnij przez


Karty adaptacyjne dla deweloperów botów

Karty adaptacyjne są doskonałym rozwiązaniem dla botów. Umożliwiają one tworzenie karty raz i jej wyświetlanie w wielu aplikacjach, takich jak Microsoft Teams, własna witryna internetowa i nie tylko.

Uwaga / Notatka

Program Skype nie jest obsługiwany w bieżącej wersji zapoznawczej. Aby uzyskać najnowsze informacje, zobacz stronę Stan partnera .

Integracja z platformą Bot Framework

Za pomocą platformy Bot Framework możesz napisać jednego bota, który może rozmawiać z użytkownikami w wielu "kanałach", takich jak Skype, Microsoft Teams, Facebook Messenger itp.

Walkthrough

Dodanie karty adaptacyjnej do bota jest dość proste.

Krok 0. Rozpocznij od podstawowego komunikatu

Przedstawiono standardowy ładunek Bot Framework message, który można dostarczyć do dowolnego kanału i wyświetlić tekst użytkownikowi.

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

Krok 1. Dodawanie karty adaptacyjnej attachment

Aby dodać dodatkowe elementy oprócz samego tekstu, Bot Framework posiada koncepcję attachments.

Dołączmy kartę adaptacyjną wyświetlającą niestandardowy tekst.

Podstawowa karta adaptacyjna

{
  "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"
          }
        ]
      }
    }
  ]
}

Krok 2. Tworzenie jeszcze bogatszych kart

Karty adaptacyjne oferują znacznie więcej niż tylko dostosowywalny tekst.

Masz następujące możliwości:

  • Dodaj Images do karty
  • Organizowanie zawartości przy użyciu elementów Containers i Columns
  • Dodaj wiele typów Actions
  • Zbierz Input od użytkowników
  • Mieć jedną kartę show another card
  • Zapoznaj się z pełnym eksploratorem schematów!

Zestawy SDK platformy

Jeśli bot jest opracowywany przy użyciu platformy .NET lub NodeJS, mamy biblioteki ułatwiające tworzenie kart adaptacyjnych.

Platforma Install Dowiedz się więcej
.NET Install-Package AdaptiveCards -IncludePrerelease Dokumentacja .NET Bot Framework
NodeJS npm install adaptivecards Dokumentacja platformy Bot Framework NodeJS

Stan kanału

Platforma Bot Framework umożliwia publikowanie bota w wielu kanałach. Pracujemy z różnymi kanałami, aby zapewnić pełną obsługę kart adaptacyjnych. Aby uzyskać najnowsze informacje, zobacz stronę Stan partnera .

Zanurz się!

Dopiero zaczęliśmy w tym samouczku, dlatego zachęcamy do zapoznania się z poniższymi linkami, aby dowiedzieć się więcej o tym, jak karty adaptacyjne mogą ulepszyć Twojego bota.