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

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：6分

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

    始める前に

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

    このタスクについて

    注:
    カスタムエンジンエージェント (CEA) は、 Microsoft 従来のボットフレームワークに代わるものです。CEA を使用すると、Microsoft Copilot仮想エージェントを検出可能にし、仮想エージェントおよびマルチターンの会話で Now Assist に完全にアクセスできます。

    Copilotを使用するには、アシスタントと Microsoft Teams アプリケーションでストリーミングを有効にします。Microsoft Copilot のストリーミングはデフォルトでアクティブになっていますが、Microsoft Teams のストリーミングはデフォルトで非アクティブです。CEA にアクセスするには、両方がアクティブ化されていることを確認します。ストリーミングが有効になっていない場合、CEAは予告なしにタイムアウトする場合があります。

    Zurichリリースでは、CEA はデフォルトで非アクティブになっています。ServiceNow®サポートチームに連絡して、インスタンスの CEA を有効にしてください。

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

    • マニフェストファイルを生成する前に、ServiceNow インスタンスで自己設定ボットを作成する (または作成済みであることを確認する) 必要があります。その後、作成した自己設定ボットごとにマニフェストパッケージを生成できます。​
    • マニフェストフォームが保存されると、アドミニストレーターは次の 3 つのファイルを含むマニフェスト zip パッケージをダウンロードできます。
      • manifest.json
      • color.png
      • outline.png
      マニフェストフォームは何度でも編集し、再ダウンロードすることができます。​
    注:
    この機能は、Microsoft Teams との仮想エージェント統合を設定する場合にのみ適用されます。ITSM または HR 機能を備えた ServiceNow for Microsoft Teams を使用する場合は、[ボットの構成] ページの [追加の 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 文字を超えないようにしてください。
      完全な説明 アプリの詳細な説明。
      注:
      詳細な説明は 4000 文字を超えないようにしてください。
      有効なドメイン アプリが Microsoft Teams にロードすることが想定される Web サイトの有効なドメインのリスト。
      注:
      現在、ServiceNow ドメインのみがサポートされています
      バージョン Microsoft Teams への増分マニフェスト送信を追跡するアプリの特定のバージョン。
      例：1.0.0 (各小数点以下最大 2 桁を使用)。
      注:
      新しいバージョンごとに大きい番号を入力してください。
      アクセントカラー アウトラインアイコンの背景として使用する色。
      注:
      値はハッシュタグ (#) で始まる有効な HTML カラーコードである必要があります。例：#293E40。
      カラーアイコン ほとんどの Microsoft Teams シナリオで表示するアプリのアイコン。
      次のオプションを選択できます。
      • [デフォルトのアイコンを使用 (Use Default icon)]：このオプションを使用して、カラーアイコンをデフォルトのカラーアイコンに戻します。
      • [カスタムアイコンを使用]：選択したアイコンのカラーにカラーアイコンを変更します。
      注:
      アイコンのカラーを変更するには、必ず 192 x 192 ピクセル未満の .png 画像ファイルのみをアップロードします。
      アウトラインアイコン アプリの使用中にアプリバーに表示されるアイコン。
      次のオプションを選択できます。
      • [デフォルトのアイコンを使用 (Use Default icon)]：アウトラインアイコンをデフォルトのアウトラインアイコンに戻します。
      • [カスタムアイコンを使用]：選択したアイコンでアウトラインアイコンを置き換えます。
      注:
      アウトラインアイコンを変更するには、必ず 32 x 32 ピクセル未満の .png 画像ファイルのみをアップロードします。
      メッセージ拡張 ユーザーが Microsoft Teams クライアントのメッセージ作成領域から結果を検索して共有できるようにするメッセージ拡張。

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

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

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

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

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

    次のタスク

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