teams-message-formatting

Teams メッセージの書式設定

受け取ったテキストを、受信先の Teams サーフェスに合わせて書式設定します。ユーザーからの明示的な指示は、このスキルのガイドラインより優先されます。

テキスト形式を特定する

コンテンツ、宛先フィールド、既存のペイロードまたは SDK を入力として使用します。そのコンテキストからテキスト形式を推測します。不明な選択によって構文やメンションのメタデータが変わる場合は、宛先を確認してください。

サーフェス	テキスト形式	メンションのメタデータ
Bot アクティビティの text	Bot Markdown または textFormat: "xml" のサブセット	アクティビティの entities
Adaptive Card の TextBlock／ファクト	限定的な Markdown、HTML は不可	ルートの msteams.entities
Graph の chatMessage.body	text または Teams 制限付きの html	本文の <at id="N"> と対応する mentions エントリ
Hero／サムネイルカードの text	XML／HTML のサブセット	サーフェス固有。タイトルとサブタイトルには書式設定なし

Slack の mrkdwn は Teams のマークアップではありません。Adaptive Card の Markdown は見出し、表、画像、コードフェンス、引用をサポートしていません。こうした構造が求められる場合は、サポートされているカード要素を使用してください。テキストのみのコンテンツにカードは必要ありません。

テキストと ID を保持する

• 受信側の構文に合わせてエスケープしてから、JSON にシリアライズします。エスケープされていないユーザーテキストを HTML／XML やメンションのマークアップに連結しないでください。
• 表示されるメンションテキストとそのメタデータを一致させます。提供または解決済みの ID を使用してください。表示名は ID の根拠になりません。
• モバイルでの Bot リストのサポートなど、クライアントごとの差異を考慮します。句読点を修正するためだけにトランスポートを変更しないでください。
• Graph のペイロードでは、通常の委任送信と移行権限を区別します。アプリ専用の通知には、サポートされている配信経路が必要です。必要な機能がない場合は、ペイロードでその機能を実現できるかのように装わず、説明してください。

意味と既知のサーフェスを維持しながら、要求されたテキスト、修正済みの文字列／オブジェクト、または統合パッチを返します。不足しているランタイム ID や、未検証のクライアント動作があれば明示してください。投稿は書式設定とは別の操作であり、ユーザーからの依頼または既存の承認が必要です。

参考資料

関連する形式またはメタデータの詳細のみを参照してください。

タスク	参考資料
Bot Markdown／XML、カードの Markdown、Hero カード、レガシーテキスト	MARKDOWN-HTML.md
Bot／カード／Graph のメンション、ユーザー、タグ、チーム、チャネル	MENTIONS.md
Graph の HTML、コード／絵文字タグ、添付ファイル、権限	GRAPH-CHATMESSAGE.md
コンパクトなサーフェスと構文の一覧	CHEATSHEET.md

カードのレイアウト／アクションについては、teams-adaptive-cards がインストールされていればそれを使用するか、Teams のカードに関するドキュメントを参照してください。このテキスト書式設定ワークフローは、別のスキルがインストールされているかどうかに依存しません。