トピックとツールの入力に関する追加の設定

Note

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

トピックやツールの入力を設定する際、共通の設定によってエージェントがどのように入力を収集するかが決まります。

Important

ツール入力パラメータの追加設定は常に利用可能です。 ただし、トピック入力パラメーターの場合、これらの設定は、エージェントが 生成オーケストレーションを使用するように構成されている場合にのみ使用できます。

エージェントがどのようにユーザーに入力を求められるかを設定する

デフォルトでは、エージェントは入力パラメータの名前と説明を使用して、不足している情報の入力をユーザーに求める質問を自動的に生成します。 ただし、この動作をオーバーライドして、独自の質問を作成できます。

  1. 独自の質問を入力するには、プロンプトカスタマイズを選択します。

  2. 質問を入力します。 質問には変数や Power Fx 式の参照を含めることができます。

    トピックの詳細パネルの [追加設定] セクションの一部を示すスクリーンショット。ユーザーに入力を求めるカスタムの質問が表示されています

エージェントの再プロンプト動作を設定する

デフォルトでは、エージェントがユーザーから有効な回答を得られない場合、質問をさらに2回繰り返します。 エージェントに一度だけ再試行させるか、回答を得ようとせずに先に進むかを選択できます。 エージェントが移動する際の動作をカスタマイズするには、有効なエンティティが見つかりません配下のプロパティを構成します。

  • 再プロンプトの回数: エージェントが有効な回答を取得しようとした回数。 最大 2 回繰り返すが既定となります。 1 回繰り返すまたは繰り返さないを選択することもできます。
  • 再試行プロンプト: ユーザーに再度入力を求めるために使用される質問を変更するには、基本エンティティの検証に失敗した後、カスタマイズを選択し、新しい質問を入力します。 たとえば、数値を期待している場合、「IDは何ですか?」という質問を入力するかもしれません。 数値である必要があります。」

追加のエンティティ検証

デフォルトでは、システムは「 Identified as プロパティ」で選択したエンティティのみに基づいて応答を検証します。 追加エンティティ検証を使って基本テストに基準を追加してください。 例えば、入力が数字を識別するように設定されているけれど、10未満にしたい場合もあります。 質問の再試行を変更して、ユーザーが有効な応答を入力できるよう支援することもできます。

  • 条件: ブール値 (true または false) を返す Power Fx 式を入力します。例: Topic.Var1 < 10.
  • 条件未達成プロンプト:基本的なエンティティ検証が合格しても条件に対する検証が失敗した場合に表示されるメッセージを変更するには、「 カスタマイズ」を選択し、新しい質問を入力してください。 例えば、番号を受け取ったのにそれが10を超えている場合、「IDは何ですか?」といった質問をするかもしれません。 10 未満の数値にする必要があります。

有効なエンティティが見つかりません

有効なエンティティが見つからない場合 、最大リトライ回数に達した後にエージェントが有効な応答を得ようとしなくなった場合に何が起こるかを決定します。 顧客サービス担当者にエスカレーションするか、既定値を提供することができます。

  • エンティティが見つからない場合の操作:

    • エスカレート: ユーザーをエスカレーション システム トピック にリダイレクトします。 この動作がデフォルトの動作です。
    • 変数を値に設定: 出力変数を値に設定し、次のノードに進みます。 既定のエンティティ値で、値を入力または選択します。
    • 変数を空 (値なし) に設定する: 出力変数をクリアし、次のノードに移動します。 条件ノード を後で使用し、変数に値があるかどうかを確認できます。
  • エンティティが見つかりませんでしたメッセージ:ユーザーに手順を知らせるメッセージを指定するには、「カスタマイズ」を選択し、希望するメッセージを入力してください。 たとえば、メッセージで「苦労しているようですね」と言うことができます。 チームの誰かに転送します」と表示します。