エージェントのホーム ページは、エージェントのメイン ランディング ビューです。 ここで、ユーザーはスコープ付き環境で対話を開始します。 通常、エージェントの名前、アイコン、属性を提供し、その目的に基づいて他の要素 (過去の対話、ダッシュボード、メディア ギャラリーなど) を含め、関連する機能へのコンテキストと迅速なアクセスを提供できます。
これらの基本的な要素を正しく取得することが不可欠です。 最初のメッセージが送信される前に、ID を確立し、期待値を設定し、信頼を通知します。
エージェントのホーム ページは、いくつかの異なる要素で構成されます。 各要素は、ユーザーがエージェントを理解して関与するのに役立つ特定の役割を果たします。
| 要素 | Description |
|---|---|
| タイトル バー | 基本的なエージェント情報、ナビゲーション、および基本的なオプションを表示します。 |
| アイコン | ユーザーによる認識を容易にする、エージェントのブランド化要素。 |
| 氏名 | ユーザーがその目的または機能を認識するのに役立つ、エージェントの一意の識別子またはタイトル。 |
| Attribution | エージェントの背後にある手段または組織を表示し、ユーザーがその信頼性と信頼性を確認できるようにします。 |
| チャット入力ボックス | 主な手段は、ユーザーがエージェントと対話し、クエリまたはコマンドを入力できるようにすることです。 チャット入力ボックスは、ネイティブ Microsoft 365 Chatと同じガイドラインに従い、一貫性のあるエクスペリエンスを確保します。 |
| スタート画面を表示する | ユーザーが何かを入力する前にエージェントのようこそ画面に表示される短いクリック可能な候補。 ユーザーが開始する方法とエージェントが実行できる操作について説明します。 |
Icon
アイコンは、ユーザーがエージェントに関連付ける最初の視覚的シグナルです。 明確で、目的に富み、ブランドとの整合性を保つ必要があります。
エージェント アイコンを設計するときは、次のガイドラインに従ってください。
- エージェントの目的を反映した、単純で認識可能なイメージを使用します。
- アイコンが小さいサイズで動作することを確認します。 タイトル バー、チャット ピッカー、エージェント ストアなどのコンパクトな UI サーフェスに表示されます。
- アイコン内のテキストは使用しないでください。 名前は個別に識別されます。
- サイズ、形状、色 の要件については、Teams アプリ アイコンのガイドライン に従ってください。
Note
アイコンはアプリ パッケージの一部です。 発行する前に、アイコン資産が Teams ストアの要件を満たしていることを確認します。 詳細については、 エージェントの検証ガイドラインを参照してください。
Name
名前は、タイトル バー、エージェント ピッカー、チャット履歴、およびエージェント ストアで、ユーザーがエージェント エクスペリエンス全体で表示する一意の識別子です。 エージェントの目的をすぐに伝える必要があります。
エージェントに名前を付ける場合は、次のガイドラインに従います。
- エージェントの関数またはドメインを反映する明確で簡潔な名前を使用します。 たとえば、 Contoso Ticket Manager または Sales Pipeline Agent などです。
- "best"、"amazing"、"#1" などの最上級の要求は避けてください。
- そのエージェントを他と区別できない、あまりに一般的な名前は避けてください。
- 宣言型エージェントの場合、
name内のmanifest.json値、宣言型エージェント JSON ファイル、およびプラグイン JSON ファイル内のname_for_humanは同じである必要があります。 - 名前に説明フレーズ、URL、絵文字、隠し文字は使用しないでください。
Important
UI のエージェント名は、マニフェストで定義されている名前と正確に一致している必要があります。 不整合により、ストアに発行するときに検証エラーが発生する可能性があります。
帰属
帰属表示には、そのエージェントを提供する発行元または組織が表示されます。 エージェントのホーム ページに表示され、ユーザーがエージェントに参加する前にエージェントのソースを確認するのに役立ちます。
明確な属性は、ユーザーの信頼をサポートします。 エージェントを構築したユーザーを特定し、そのエンティティに責任を負うことができるユーザーは、自信を持って関与する可能性が高くなります。 この信頼は、エージェントが機密性の高いワークフローやデータを処理する可能性があるエンタープライズ環境で特に重要です。
パートナー センターに登録されている実際の組織名が属性に反映されていることを確認します。 エージェントが独自に公開されている場合は、それが Microsoft 製またはファーストパーティ エージェントであるかのような誤解を招く表現は避けてください。
プロンプト スターター
プロンプト スターターは、エージェントのウェルカム画面に表示される短いクリック可能な候補です。 それらは、ユーザーが何かを入力する前に、有意義なインタラクションへと導きます。
効果的なプロンプト スターター:
- 実際のユース ケースを反映します。 各スターターは、エージェントが実際に完了できるタスクに対応する必要があります。
- プレーンなアクション指向言語を使用します。 動詞または明確な質問で始めます。 専門用語は避けてください。
- エージェントのさまざまな機能を網羅します。 1 つの機能を中心にすべてのスターターをクラスター化しないでください。
- 簡潔にしておきます。 各プロンプト スターターは 128 文字を超えてはなりません。
初回実行時のユーザー エクスペリエンス
ユーザーが初めてエージェントにアクセスすると、ホーム ページにエージェントのアイコン、名前、属性、プロンプト スターターが表示されます。 会話履歴は存在しません。 これが第一印象を強くする瞬間です。
最初の実行エクスペリエンスでは、次の操作を行う必要があります。
- ID と目的を直ちに確立します。 ユーザーは、エージェントが到着してから数秒以内に行うことを知っている必要があります。
- 始めるハードルを下げる。 プロンプト スターターは、ユーザーに具体的な信頼できるエントリ ポイントを提供することで、空白プロンプトの問題を削除します。
- 正確な期待値を設定します。 名前、属性、プロンプト スターターの組み合わせによって、エージェントができることとできないことを伝える必要があります。
最初の実行エクスペリエンスの設計に関する詳細なガイダンスについては、 エージェントの人間中心の設計に関するページを参照してください。
ユーザー エクスペリエンスを返す
戻るユーザーがエージェントを開くと、ホーム ページには追加のコンテキストが表示され、中断した場所を取得するのに役立ちます。
チャット ピッカー
チャット ピッカーはカスタマイズ可能ではありませんが、ユーザーはエージェントとのチャット セッション履歴間を簡単に移動できます。 返されたユーザー ビューには、過去の会話のナビゲーション可能な一覧として表示され、ユーザーはコンテキストを繰り返さずに前の操作を再開できます。
リスト
リストはカスタマイズ可能ではありませんが、エージェントのドメインの最近または関連する項目をホーム ページに直接表示するオプションのコンポーネントです。 新しいプロンプトを必要とせずに、以前の出力、追跡された項目、またはキュレーションされたコンテンツにすばやくアクセスできます。
ホーム ページ
1 つのチャット入力を超えるエージェントの場合は、ナビゲーション ビューとリスト ビューを使用してホーム ページを拡張できます。 これらのコンポーネントを使用すると、ダッシュボードと同様に、より豊富で使い慣れた操作を簡単に検出し、有効にすることができます。
Navigation
ナビゲーションを使用すると、エージェントは 1 つのホーム ページ内で複数のビューまたはモードを表示できます。 たとえば、エージェントは [ホーム ] タブと [分析情報 ] タブを提供して、ユーザーが会話インターフェイスとデータ概要ビューを切り替えることができます。
エージェントに、常時トップレベルからアクセスできることに利点のある、明確に異なる画面や領域がある場合は、ナビゲーションを使用します。
関連するコンテンツ
- エージェントの検証ガイドライン。 エージェント名、プロンプト、アダプティブ カードの応答などの送信要件を格納します。
- Teams アプリの設計の基礎。 Teams およびCopilot アプリのレイアウト、アイコン、文字体裁、色、図形のガイドライン。