トピックの入力と出力を管理する

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

トピック には入力および出力パラメータを持てます。 トピックが 別のトピックにリダイレクト する場合、これらのパラメータを使用してトピック間で情報を渡すことができます。

エージェントが 生成オーケストレーションを使えば、会話コンテキストを使ってトピックを実行する前に自動的に入力を埋めたり、ユーザーに値を尋ねる質問を生成したりできます。 この動作は、ツールに対する生成型スロットフィリングがどのように機能するかに似ています。

生成オーケストレーションを用いるエージェントは、トピック出力として文脈応答を生成することができます。 このような場合、トピック自体から逐語的なメッセージを構成する必要はありません。

トピックの入力と出力は、同じ生成計画内で他のトピックやツールと値を共有できます。

入力と出力を追加する

トピックの入力や出力を追加するには、オーサリングキャンバス上部のツールバーで「 詳細 」を選択してください。 または、トピックリストページのコンテキストメニューから「詳細」を選択することもできます。

トピック詳細パネルで「入力」または「出力」タブを選択し、「新しい変数を作成」を選択して新しい入力または出力変数を作成できます。

すべての入力および出力パラメータに対して、名前を入力し、データ型を選択し、対応する変数の説明を入力する必要があります。

エージェントが 生成 AI を使用してユーザーへの応答方法を決定する場合、入力変数に使用できるプロパティが増えます。 具体的には、 エージェントはこの入力をどのように入力するのか? を決定します。これは、トピックを実行する前にエージェントがこの変数に値をどう入力するかを決定します。 既定では、各入力は 最適なオプションで動的に入力に設定されています。 エージェントはユーザーのメッセージや過去の会話など、利用可能なコンテキストから値を取得しようとします。 適切な値が見つからない場合、エージェントはユーザーに値を尋ねるための質問を生成します。 ユーザーに尋ねる代わりに、入力を値で上書きすることを選択できます。 入力パラメーターを上書きするには、エージェントは、この入力をどのように入力しますか の下にある 値として設定する を選択し、希望する値を入力します。 この値はリテラル値、既存の変数、または Power Fx 式を指定できます。

エージェントが入力に対して正しいタイプの値を確実に取得するようにするには、識別形式 でエンティティタイプも指定する必要があります。

新しい入力変数が追加された詳細ペインのスクリーンショット

ユーザーに値を要求したり、ユーザーの回答を検証したりする際のエージェントの動作を制御するための、入力に関する追加設定を構成できます。

これらの設定の1つであるユーザーへの確認を求めるは、トピック入力でのみ使用できます。 これは、エージェントがトピックを実行する前に変数に値を入力しようとする必要があるかどうかを決定します。 このプロパティはデフォルトで選択されます。