Schede adattive per gli sviluppatori di bot

Le schede adattive sono ideali per i bot. Consentono di creare una scheda una sola volta e di renderla bellamente all'interno di più app, ad esempio Microsoft Teams, il proprio sito Web e altro ancora.

Nota

Skype non è supportato nell'anteprima corrente. Per le informazioni più recenti, vedi la pagina sullo stato dei partner.

Provare questa operazione

Fai clic sul collegamento seguente e parla il bot Scuba. Prova a dire I'm looking for scuba e ti aiuterà a prenotare il viaggio per le immersioni dei tuoi sogni.

Tutte le risposte del bot vengono create tramite schede adattive.

Ottieni il codice: l'intero codice sorgente del bot Contoso Scuba è disponibile in GitHub.

Integrazione di Bot Framework

Con Bot Framework è possibile scrivere un singolo bot che è in grado di chattare con utenti in più "canali", ad esempio Skype, Microsoft Teams, Facebook Messenger e così via.

Procedura dettagliata

È piuttosto semplice aggiungere una scheda adattiva al tuo bot.

Passaggio 0: Iniziare con un messaggio di base

Ecco un payload message standard di Bot Framework che può essere recapitato a qualsiasi canale e visualizzare testo per l'utente.

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

Passaggio 1: Aggiungere una scheda adattiva attachment

Per aggiungere contenuti avanzati oltre al semplice testo, Bot Framework introduce il concetto di attachments.

Proviamo a collegare una scheda adattiva che visualizza testo personalizzato.

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

Passaggio 2: Compilare schede ancora più avanzate

Le schede adattive offrono molto più che semplice testo personalizzabile.

È possibile:

• Aggiungere Images alla scheda
• Organizzare i contenuti con Containers e Columns
• Aggiungere più tipi di Actions
• Raccogliere Input dagli utenti
• Usare una scheda per show another card
• Consulta tutte le informazioni in Schema Explorer.

Platform SDK

Se il bot è stato sviluppato usando .NET o NodeJS, sono disponibili librerie per rendere ancora più semplice la creazione di schede adattive.

Piattaforma	Installare	Altre informazioni
.NET	Install-Package AdaptiveCards -IncludePrerelease	Documentazione di Bot Framework per .NET
NodeJS	npm install adaptivecards	Documentazione di Bot Framework per NodeJS

Stato del canale

Bot Framework consente di pubblicare i bot in più canali. Stiamo collaborando con vari canali per fornire un supporto completo per le schede adattive. Per le informazioni più recenti, vedi la pagina sullo stato dei partner.

Approfondimento

In questa esercitazione è stata fornita solo una presentazione generale. Visita i collegamenti seguenti per altre informazioni su come usare le schede adattive per migliorare i bot.

• Esamina le schede di esempio per trovare l'ispirazione
• Usa Schema Explorer per informazioni sugli elementi disponibili
• Crea una scheda usando il visualizzatore interattivo
• Contattaci per eventuali commenti