ボット開発者向けのアダプティブカード

アダプティブカードはボットに最適です。カードを 1 回作成し、Microsoft Teams、独自の Web サイトなど、複数のアプリ内で美しくレンダリングできるようにします。

注

現在のプレビューでは、Skype はサポートされていません。最新のパートナーステータスページを参照してください。

Bot Framework の統合

Bot Framework を使用すると、Skype、Microsoft Teams、Facebook Messenger など、複数の "チャネル" でユーザーとチャットできる 1 つのボットを作成できます。

Walkthrough

アダプティブカードをボットに追加するのはかなり簡単です。

手順 0: 基本的なメッセージから始める

任意のチャネルに配信してユーザーにテキストを表示できる標準的な Bot Framework message ペイロードを次に示します。

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

手順 1: アダプティブカードを追加する `attachment`

テキストだけを超える豊かさを追加するために、Bot Framework には attachments という概念があります。

カスタムテキストを表示するアダプティブカードを添付してみましょう。

基本アダプティブカード

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

手順 2: さらに豊富なカードを構築する

アダプティブカードは、単なるカスタマイズ可能なテキスト以上のものを提供します。

次のようにすることができます。

カードに Images を追加する
Containersを使用してコンテンツを整理するColumns
複数の種類の Actions
ユーザーから Input を収集する
カードを 1 枚持つ show another card
完全なスキーマエクスプローラーを確認してください。

プラットフォーム SDK

ボットが .NET または NodeJS を使用して開発されている場合は、アダプティブカードをさらに簡単に構築するためのライブラリがあります。

Platform	Install	詳細情報
.NET	`Install-Package AdaptiveCards -IncludePrerelease`	Bot Framework .NET Docs
NodeJS	`npm install adaptivecards`	Bot Framework NodeJS Docs

チャネルの状態

Bot Framework を使用すると、ボットを複数のチャネルに発行できます。アダプティブカードの完全なサポートを提供するために、さまざまなチャネルと協力しています。最新のパートナーステータスページを参照してください。

ご参加下さい。

このチュートリアルではほんの触りだけを扱ったに過ぎませんので、以下のリンクを確認して、アダプティブカードがボットをより一層強化できる方法を探ってみてください。

サンプルカードを参照してインスピレーションを得る
スキーマエクスプローラーを使用して使用可能な要素を学習する
アダプティブカードデザイナーを使用してカードを作成する
フィードバックをお寄せください

Last updated on 2025-12-18