トピックの作成と編集

[アーティクル]
04/09/2024

重要

Power Virtual Agents 機能は、生成 AI への多大な投資と Microsoft Copilot 全体の統合の強化により、現在 Microsoft Copilot Studio の一部となっています。

ドキュメントやトレーニングコンテンツが更新される間、一部の記事やスクリーンショットで Power Virtual Agents が参照される場合があります。

Copilot Studio で、トピックはコパイロットの会話のプログレスを定義します。

トピックを作成するには、用意されているテンプレートをカスタマイズしたり、最初からトピックを作成したり、既存のヘルプサイトから提案を取得したりできます。

Copilot Studio で、トピック は、ユーザーとコパイロットの間の会話スレッドの一部を表します。 作成キャンバス 上でトピックを定義して使用します。トピックには 1 つ以上の 会話ノード、 が含まれ、トピックが使用できる会話パスをまとめて定義します。各ノードは、メッセージの送信や質問などのアクションを実行します。

トピックには、トリガーフレーズ のセット (顧客が使用する可能性の高い特定の問題に関連するフレーズ、キーワード、質問) が含まれます。 Microsoft Copilot Studio は、自然言語理解、顧客のメッセージ、すべてのトピックのトリガーフレーズを使用して、トリガーする最適なトピックを見つけます。メッセージは、トピックをトリガーするためにトピックのトリガーフレーズと完全に一致する必要はありません。たとえば、店舗の営業時間に関するトピックには、トリガーフレーズ check store hours が含まれる場合があります。顧客が "店舗の営業時間を参照" を送信すると、店舗の営業時間トピックがトリガーされます。

前提条件

コパイロットを作成するには、クイックスタート: Microsoft Copilot Studio コパイロットを作成および展開するを参照してください。

自然な言語の解釈

コパイロットでは自然言語理解 (NLU) を使用して、顧客が入力した内容を解析し、最適なトリガーフレーズまたはノードを見つけます。

たとえば、ユーザーが「営業時間」と入力するとします。コパイロットはそれを 店舗の営業時間 トピックと照合し、顧客が関心のある店舗を尋ねる会話を開始し、店舗の営業時間を表示します。

ボットのテスト ペインには、コパイロットの会話のプログレスがすべてのステップでどのように再生されるかが表示されます。 コパイロットのテスト ペインを使用して、Copilot Studio ポータルを終了せずにトピックを微調整できます。

コパイロットとトピックの制限については、クォータ、制限、構成の値を参照してください。

Microsoft Copilot Studio のトピック

トピックの種類

コパイロットには、システム と カスタム の 2 種類のトピックを含めることができます。すべての新しいコパイロットは、一連のシステムトピックとカスタムトピックから始まります。

システム トピックは、人と話す、または会話を終了するというカスタム要求などの重要な動作をサポートします。一部のシステムトピックにはトリガーフレーズがあり、コパイロットのニーズに合わせてカスタマイズできます。
- システムトピックを作成することはできません。
- システムトピックは削除できませんが、無効にすることはできます。
- システムトピックに変更を加えることができます。ただし、完全なコパイロットエクスペリエンスの作成に慣れるまでは、システムトピックを編集することはお勧めしません。
詳細については、システムトピックを使用するを参照してください。
カスタム トピックでは、顧客への挨拶、会話の終了、会話の再開などの一般的な動作をカバーします。
- 開始カスタムトピックを変更したり、コパイロットから完全に削除したりできます。
- 作成するトピックはすべてカスタムトピックです。

ノードの種類

使用可能なノードの種類は次のとおりです:

回答内容	プロパティ
メッセージの送信	顧客メッセージを送信します。
質問する	顧客に質問します。
アダプティブカードで質問する	他のアプリと交換するための JSON スニペットを作成します。
条件の追加	条件に基づいて会話を分岐させます。
変数管理	値を設定するか、値を解析するか、すべての変数をクリアします。
トピック管理	トピックまたは会話をリダイレクト、転送、または終了します。
アクションを呼び出す	Power Automate または Excel Online のようなフローを呼び出すか、コネクタまたはプラグインを使用します。
Advanced	生成的な答え、HTTP 要求、イベントなど。

トピックを作成する

コパイロット ページのリストからコパイロットを開きます。見やすくするために、ここでは コパイロットのテスト ウィンドウを閉じてください。
ナビゲーションウィンドウで トピックとプラグイン を選択します。
+ 作成 を選択し、トピック をポイントして、最初から を選択します。

トリガー ノードは空白のトピック作成キャンバスに表示され、認識された意図のプロパティ パネルが開きます。パネルが開いていない場合は、トリガー ノードの ノードメニュー アイコン (⋮) を選択し、プロパティ を選択します。
認識された意図のプロパティ パネルで、フレーズ 領域をクリックします。 フレーズ セカンダリパネルが表示されます。
フレーズの追加 で、トピックのトリガーフレーズを入力します。

コパイロットが顧客の応答を理解できるように AI をトレーニングするには、5 個から 10個のトリガーフレーズが必要です。トリガーフレーズをさらに追加するには、次のいずれかを実行できます:
- テキストフィールドの横にある追加アイコンを選択し、目的のフレーズを入力します。
- 一連のトリガーフレーズをそれぞれ別の行に貼り付け、Enter を選択します。
- 一連のトリガーフレーズを入力し、それぞれの後に Shift+Enter を押して別の行に配置し、Enter を選択します。
トリガーフレーズには句読点を含めることができますが、長文ではなく、短い語句を使用することをお勧めします。
ツールバーで詳細を選択して、トピック詳細 パネルを開きます。
コパイロットトピックの詳細を追加します。
- トピックを識別するための名前 (「店舗の営業時間」など) を入力します。トピックとプラグイン ページには、コパイロットで定義されているすべてのトピックがこの名前で一覧表示されます。
- 必要に応じて、どのトピックが顧客のメッセージに一致するかをコパイロットが判断できない場合に、顧客に表示する表示名を入力します。
- 必要に応じて、説明フィールドを使用して、自分自身やチームの他のコパイロット作成者のトピックの目的を説明します。顧客にトピックの説明が表示されることはありません。
上部のメニューバーの保存を選択して、トピックを保存します。

トピックの会話パスを設計する

トピックを作成すると、作成キャンバスに トリガー ノードが自動的に追加されます。その後、さまざまな種類のノードを追加して、トピックの目的の会話パスにすることができます。

トピック作成キャンバスで別のノードの後、または 2 つのノード間にノードを追加するには:

新しいノードを追加するノードの下にある ノードの追加 アイコンを選択します。
表示されたリストから目的のノードの種類を選択します。

ノードの削除

削除するノードのメニューアイコン (⋮) を選択し、削除を選択します。

キャンバス上のノードを編集するための制御

キャンバスの作成ツールバーを使用して、トピックの名前をすばやく変更できます。ツールバーでトピック名を選択し、新しい名前を入力して Enter キーを押します。

トピック名を強調表示したトピック作成キャンバスのスクリーンショット。

ツールバーのコントロールを使用して、選択したノードまたは選択した隣接ノードを切り取り、コピー、貼り付け、および削除できます。

作成キャンバス上のノードを編集するためのツールバーコントロールのスクリーンショット。

ツールバーでは、編集を元に戻すこともできます。 元に戻す メニューを開いて、すべての操作を最後に保存した状態に戻すか、直前の操作をやり直します。

ノードを貼り付ける

切り取りカット や コピー ツールを使用して、複数のノードをクリップボードに配置したら、キャンバスに貼り付ける方法は次の 2 とおりあります。

ノードを選択してから貼り付けを選択した場合、クリップボードのノードは、選択したノードの後に挿入されます。
"+" を選択して ノードの追加 メニューを表示し、貼り付け を選択すると、クリップボード上のノードがその位置に挿入されます。

コードエディターでトピックを編集する

コードエディターには、YAML でトピックが表示されます。YAML は、読みやすく理解しやすいマークアップ言語です。コードエディターを使用して、他の作成者が作成したものであっても、他のボットからトピックをコピーして貼り付けます。

重要

トピック全体をコードエディターで設計し、複雑なトピックを貼り付けることは、完全にはサポートされていません。

この例では、YAML をコピーしてコードエディターに貼り付け、顧客に配送情報を尋ねるトピックをすぐに追加します。

トピック ページで、+ 新規トピックを選択します。
作成キャンバスの右上隅で、... を選択して その他のオプション を表示し、コードエディターを開く を選択します。

コードエディターの内容を選択して削除します。次に、以下の YAML コードをコピーして貼り付けます:

kind: AdaptiveDialog
beginDialog:
  kind: OnRecognizedIntent
  id: main
  intent:
    displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
    triggerQueries:
      - Buy items
      - Buy online
      - Buy product
      - Purchase item
      - Order product

  actions:
    - kind: SendMessage
      id: Sjghab
      message: I am happy to help you place your order.

    - kind: Question
      id: eRH3BJ
      alwaysPrompt: false
      variable: init:Topic.State
      prompt: To what state will you be shipping?
      entity: StatePrebuiltEntity

    - kind: ConditionGroup
      id: sEzulE
      conditions:
        - id: pbR5LO
          condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"

      elseActions:
        - kind: SendMessage
          id: X7BFUC
          message: There will be an additional shipping charge of $27.50.

        - kind: Question
          id: 6lyBi8
          alwaysPrompt: false
          variable: init:Topic.ShippingRateAccepted
          prompt: Is that acceptable?
          entity: BooleanPrebuiltEntity

        - kind: ConditionGroup
          id: 9BR57P
          conditions:
            - id: BW47C4
              condition: =Topic.ShippingRateAccepted = true

          elseActions:
            - kind: SendMessage
              id: LMwySU
              message: Thank you and please come again.