イベント活動の送信

重要

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 サンプル リポジトリにある 04.api/c.incoming-activity-event サンプルは、イベント処理がどのように動作するかを示しています。
• AudioCode はイベント アクティビティを使用してサービスを制御できるようにします。 たとえば、通話録音の開始または停止などです。 追加情報については、通話のレコーディング を参照してください。

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

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

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

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

関連リンク

• トピックにまたがる変数の再利用
• ボットのルック アンド フィールのカスタマイズ