イベント アクティビティの送信

重要

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

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

Microsoft Copilot Studio には、メッセージ以外のアクティビティを送信できる 2 つのノード (イベントの送信とアクティビティの送信) が用意されています。 これらは次のセクションで説明します。

[イベントの送信] および [アクティビティの送信] オプションを含む、詳細ノードを追加するスクリーンショット。

送信イベント

イベント送信ノードは、イベント アクティビティを送信するために特別に設計されています。 イベント アクティビティはボットから送信され、チャネルが傍受して利用することができ、チャネルはアクティビティを利用するかどうか、利用方法を決定します。 イベントを送信する際に名前を付けると、イベントに値を設定できます。 この値は、プリミティブなリテラル値、変数参照、Power Fx など、任意の形式にすることができます。 値はJ SON としてシリアル化され、送信アクティビティに追加されます。

イベント アクティビティ ノードの設定メニューを示すスクリーンショット。

このノードの用途は次のとおりです:

  • カスタムWebチャット コントロールを構成して、ボットから送信されたイベントを処理できます。 たとえば、ボットから返されるイベントを探して、ページ上でアクションを実行できます。 GitHubの Microsoft Bot Framework Web Chat samples repository on GitHubリポジトリにある 04.api/c.incoming-activity-event サンプルは、このような動作が可能であることを示しています。
  • AudioCode はイベント アクティビティを使用してサービスを制御できるようにします。 たとえば、通話録音の開始または停止などです。 詳細情報については、通話の録音 を参照してください。

他のアクティビティタイプの送信

イベント アクティビティの他に、アクティビティ送信ノードを使用して、他のタイプのアクティビティを送信することができます。 一般に、このノードの使用法は高度であるため、高度なサブカテゴリに属します。 送信できるアクティビティのタイプは、 Bot Framework スキーマ - ActivityTypes クラス で提供されるアクティビティのサブセットです。 このノードを使用する場合は、アクティビティのタイプを選択し、オプションで名前または値を設定します。

一般的なタイプは次のとおりです:

  • Typing – これはタイピング アクティビティを送信します。チャネルはそれを選択して、クライアントにタイピング インジケーターを表示します。
  • Delay – メッセージ間の遅延を提供するために使用できます。 たとえば、メッセージを送信し、次に遅延アクティビティを送信し、その後に別のメッセージを送信します。 エンド ユーザーには、最初のメッセージが表示され、その後一時停止し、次に 2 番目のメッセージが表示されます。 この場合、「値」はミリ秒の遅延数に設定されます。 詳細については、ActivityTypes.Delay フィールド を参照してください。
  • Invoke/Invoke Response – 通常、これらは Microsoft Teams に使用されます。 ユーザーは、Teams からの着信呼び出しを傍受するための Invoke トリガーを持つトピックを作成することになります。 次に、C1 は呼び出し応答アクティビティを使用して、適切な応答を Teams に送り返します。
  • Handoff – これにより、ユーザーは値を明示的に制御してハンドオフ アクティビティを送信できるようになります。 これは、AudioCode などの一部の外部チャネルに使用されます。

タイプのドロップダウン リストを含む、呼び出しアクティビティ ノードを示すスクリーンショット。