にアップロードするマニフェストファイルの自動生成 Microsoft Teams

マニフェストファイルを自動生成し、 Microsoft Teams アプリのブランディングをカスタマイズして、組織で 仮想エージェント 利用できるようにします。

始める前に

必要なロール：virtual_agent_admin または admin

このタスクについて

新しい Microsoft Teams UI の自動マニフェストファイルジェネレーターは、アドミニストレーターの入力に基づいてボット ID を自動的に入力し、他の設定 (ブランディングなど) を更新します。​ マニフェストファイルジェネレーターでは、マニフェストパッケージを 1 回選択するだけでダウンロードすることもできます。

• マニフェストファイルを生成する前に、ServiceNow インスタンスで自己設定ボットを作成する (または作成済みであることを確認する) 必要があります。その後、作成した自己設定ボットごとにマニフェストパッケージを生成できます。​
• マニフェストフォームを保存したら、次の 3 つのファイルを含むマニフェスト zip パッケージをダウンロードできます。
  • manifest.json
  • color.png
  • outline.png
  マニフェストフォームは何度でも編集し、再ダウンロードすることができます。​

注:

この機能は、Microsoft Teams との仮想エージェント統合を設定する場合にのみ適用されます。ITSM または HR 機能を備えた Microsoft Teams に ServiceNow を使用する場合は、[計画] の横にある [詳細] リンクを選択して、[ボット構成] ページで追加の ITSM と HR の統合を有効にします。これにより、ここでマニフェストの設定を続行する代わりに、別のモジュールでマニフェストを設定できます。詳細については、「 マニフェストファイルの作成とダウンロード」を参照してください。

手順

1. 移動先 すべて > 対話型インターフェース > 設定.
2. [全般設定] の [チャネルとルーティング] セクションで、[すべて表示] を選択します。
3. [チャネルと統合 (Channels and integrations)] ページの Microsoft Teams タイルで、[管理] を選択します。
4. [自己設定ボット] セクションで、[ボットを管理] アイコン [
   メッセージ拡張を有効にしておらず、初めてアクセスする場合は、 Microsoft Teams 統合のメッセージ拡張機能を有効にできるようになったことを通知する [新機能アラートをオンにする (Turn on new feature alert)] メッセージが表示されます。
5. [ 構成 ] タブで [ 構成を編集 ] を選択し、フォームのフィールドに入力します。

   表 : 1. ボットの構成:VA Microsoft Teams マニフェスト

   フィールド	説明
   短い名前	アプリの短い表示名。 注: 名前が 30 文字を超えないようにしてください。
   フルネーム	アプリのフルネーム。アプリの短縮名が 30 文字を超える場合は、フルネームを使用します。 注: フルネームが 100 文字を超えないようにしてください。
   ボット (クライアント) ID	一意 Microsoft 生成された識別子。 このフィールドは自動的にボット作成ステップに関連付けられ、変更できません。
   簡単な説明	アプリエクスペリエンスの簡単な説明。スペースが限られている場合は、簡単な説明を使用します。 注: 簡単な説明は 80 文字を超えないようにしてください。
   詳細な説明	アプリの詳細な説明。 注: 詳細な説明は 4,000 文字を超えないようにしてください。
   有効なドメイン	アプリが Microsoft Teams でロードすることが想定される Web サイトの有効なドメインのリスト。 注: 現在、 ServiceNow ドメインのみがサポートされています。
   バージョン	Microsoft Teams へのマニフェストの増分送信を追跡するアプリの特定のバージョン。 例:1.0.0。各小数点以下最大 2 桁を使用します。 注: 新しいバージョンごとに大きい番号を入力してください。
   アクセントカラー	アウトラインアイコンの背景として使用する色。 注: 値は、ハッシュタグ (#) で始まる有効な HTML カラーコードである必要があります。たとえば、「#293E40」などです。
   カラーアイコン	ほとんどの Microsoft Teams シナリオで表示するアプリのアイコン。 次のオプションを選択できます。 [デフォルトのアイコンを使用]:アイコンの色をデフォルトのカラーアイコンに戻します。 カスタムアイコンを使用:選択したアイコンの色でカラーアイコンを変更します。 注: アイコンの色を変更するには、必ず 192 x 192 ピクセル未満の .png 画像ファイルのみをアップロードしてください。
   アウトラインアイコン	アプリの使用中にアプリバーに表示されるアイコン。 次のオプションを選択できます。 [デフォルトアイコンを使用]:アウトラインアイコンをデフォルトのアウトラインアイコンに戻します。 カスタムアイコンを使用:アウトラインアイコンを任意のアイコンに変更します。 注: アウトラインアイコンを変更するには、必ず 32 x 32 ピクセル未満の .png 画像ファイルのみをアップロードしてください。
   メッセージ拡張またはコパイロット	このセクションでは、ボットが NLU/キーワード用に設定されている場合はメッセージ拡張機能をアクティブ化し、ボットが LLM 用に設定されている場合はコパイロットをアクティブ化できます。(ボットの LLM のアクティブ化の詳細については、「 ポータル、チャネル、またはモバイルアプリでのチャットアシスタントの表示」を参照してください)。 ボットを NLU/キーワード用に構成すると、[メッセージ拡張] チェックボックスが表示されます。メッセージ拡張を使用すると、ユーザーは Microsoft Teams クライアントのメッセージ作成領域から結果を検索して共有できます。 このボットを Microsoft Copilotに使用している場合は、 メッセージ拡張機能を有効にしていることを確認してください。 アプリまたはボットのメッセージ拡張機能を有効にすると、Microsoft Copilotを使用しているNow Assistとの会話中に、メッセージ拡張機能領域に同じアプリまたはボットが表示されます。 コパイロット: ボットを LLM 用に構成した場合、このオプションがメッセージ拡張機能に置き換わります。カスタムエンジンエージェント (CEA) は宣言エージェント (DA) に代わるもので、コパイロットで Now Assist 機能を使用できるようにします。 [コパイロット] チェックボックスをオンにすると、[サンプルプロンプト] ウィンドウが表示されます。ここにボットへのプロンプトを入力して、LLM がその指示に従わせるようにします。

   各フィールドの詳細については、 Microsoft Teams のドキュメントを参照してください。

6. [Save (保存)] を選択します。
   マニフェストファイルが保存されているボット構成ページにリダイレクトされ、ダウンロードできるようになります。

   注:

   ダウンロードページで [構成を編集 ] を選択してマニフェストファイルを編集し、必要なだけ何度でもファイルをダウンロードすることもできます。更新されたフォームを正常に保存できるように、新しいマニフェストごとに [ バージョン] フィールドに大きい数字のバージョン番号を入力してください。

7. [ボットの構成] ページの [パッケージ] で、[ ダウンロード ] ボタンを選択してパッケージ ファイルをダウンロードします。
   注:

   ダウンロードページで [構成を編集 ] を選択してマニフェストファイルを編集し、必要なだけ何度でもファイルをダウンロードすることもできます。ただし、更新されたフォームを正常に保存するためには、新しいマニフェストごとに [ バージョン] フィールドに大きい数字のバージョン番号を入力してください。

次のタスク

マニフェストパッケージファイルをアップロードしてボットを公開します。