interactive-input

インタラクティブ入力ブロック

ラジオボタン、チェックボックス、テキストフィールド、トグルなどのインタラクティブな UI コンポーネントを、チャットの回答に直接埋め込めます。対応クライアントではネイティブの UI 要素として表示され、その他のクライアントでは代わりに読みやすい JSON コードブロックが表示されます。

使用する場面

• クイズや演習（単一選択／複数選択、穴埋め）
• アンケートや投票
• 構造化データの収集（フォーム）
• ユーザーが選択肢から選んだり、構造化された入力を行ったりする必要があるあらゆる場面

仕組み

通常の Markdown の回答内で、JSON ブロックを ```interactive のコードフェンスで囲みます。同じメッセージ内で、通常のテキストとインタラクティブブロックを自由に組み合わせられます。

スキーマのリファレンス

スキーマの仕様全体については、references/schema.md を参照してください。

簡単な例

複数選択の質問を提示する場合、選択肢をテキストで列挙する代わりに、次のようにします。

Here's your first question:

```interactive
{
  "id": "q1",
  "card": {
    "body": [
      { "type": "TextBlock", "text": "What is the capital of France?", "weight": "bold" },
      { "type": "Input.ChoiceSet", "id": "answer", "style": "expanded",
        "choices": [
          { "title": "A. London", "value": "london" },
          { "title": "B. Paris", "value": "paris" },
          { "title": "C. Berlin", "value": "berlin" },
          { "title": "D. Madrid", "value": "madrid" }
        ]
      }
    ],
    "actions": [{ "type": "Action.Submit", "title": "Submit" }]
  }
}
```

ルール

1. すべてのインタラクティブブロックに、一意の id フィールドを指定する必要があります
2. すべてのインタラクティブブロックの card.body に、少なくとも 1 つの要素を指定する必要があります
3. ユーザーが回答を送信できるよう、card.actions に Action.Submit を含めてください
4. 選択肢をすべて視覚的に表示するには、選択肢セットに "style": "expanded" を使用してください（クイズにおすすめです）
5. 選択肢が多い場合、ドロップダウンでの選択には "style": "compact" を使用してください
6. 複数選択の質問では、Input.ChoiceSet に "isMultiSelect": true を設定してください
7. 本文の最初の TextBlock は、送信された回答で質問ラベルとして使用されます
8. 1 つのメッセージに複数のインタラクティブブロックを含めることができます（例：クイズ全体）
9. JSON は必ず ```interactive のコードフェンスで囲んでください。インタラクティブブロックに ```json を使用してはいけません
10. JSON は簡潔で有効な形式にしてください。コメントや末尾のカンマは使用できません