Note
本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。
カスタム エージェントの Azure OpenAI サービスまたは Azure AI Foundry モデルに対する手順を構成するためのカスタム プロンプトを作成できます。
カスタム プロンプトは、次の 2 つのレベルのいずれかでエージェントに追加できます。
- エージェント レベル
- トピック レベル
カスタム プロンプトをエージェント フローのノードとして追加することもできます。 この方法なら、フローのどの時点でもプロンプトを呼び出せます。
エージェントにツールとしてプロンプトを追加する
左側のウィンドウで [ エージェント ] を選択し、新しいプロンプトをツールとして追加するエージェントを選択します。
[ ツール ] タブを選択します。
[新しいツール] を選択します。
プロンプト を選択します。
カスタム プロンプト エディターが開きます。 このエディターを使って エージェント用のカスタムプロンプトを作成してください。
トピックにプロンプトノードを追加する
左側のウィンドウで [ エージェント ] を選択し、変更するトピックを含むエージェントを選択します。
トピックを開き、ノードの下にある [ ノードの追加 ] アイコン
を選択し、その後で新しいノードを追加します。[ツールの追加] を選択します>新しいプロンプト。
カスタム プロンプト エディターが開きます。 このエディターを使って エージェント用のカスタムプロンプトを作成してください。
Note
匿名ユーザー (認証なし) を許可するように構成されたエージェントは、Dataverse テーブルをナレッジ ソースとして使用できません。 ただし、プロンプトの入力パラメーターを指定したり、プロンプトを実行する目的のモデルを選択したり、生成されるテキストのランダム性と創造性を制御するために目的の温度を設定したりできます。
エージェント フローにプロンプト ノードを追加する
左側のウィンドウで [フロー ] を選択し、変更するエージェント フローを選択します。
新しいノードを追加するフロー内のポイントに、[
新しいアクションの挿入] アイコンを選択します。 [ アクションの追加] ウィンドウが開きます。[ AI 機能] で、[ プロンプトの実行] を選択します。
[プロンプトの実行] ノードがフロー キャンバスに追加されます。
既存のプロンプトを追加する場合は、一覧からそのプロンプトを選択します。 新しいプロンプトを追加するには、[ 新しいカスタム プロンプト] を選択します。
カスタム プロンプト エディターが開きます。 このエディターを使って エージェント用のカスタムプロンプトを作成してください。
プロンプト エディターを使用したプロンプトの構成とテスト
カスタムプロンプトエディターは、エージェント用のプロンプトテンプレートを作成、カスタマイズ、テストするための強力なツールです。 プロンプトエディターは、エージェントに効果的なプロンプトを作成できるように設計されています。
プロンプト エディターを使用すると、いくつかの方法でプロンプトの指示を記述できます。 次のようにすることができます。
- 手動で独自の手順を書き出す
- あなたがプロンプトでしてほしいことを説明し、それに基づいてCopilotを使用して指示を生成します。
- プロンプト ライブラリのプリセット テンプレートを使用してプロンプトを作成する
プロンプトには、次のようないくつかの側面を構成できます。
- プロンプトに使用するチャット モデル、モデルの設定 (温度、ナレッジ取得の設定、応答にリンクを含めるかどうか、コード インタープリターと推論を有効にするかどうかなど)。
- テキストや画像などのプロンプトへのユーザー入力、およびテスト対象のサンプル データ。
- Dataverse テーブルから処理して含める知識。
- 出力に適用する書式。
プロンプト作成が終わったら、入力ごとにサンプルデータを指定し、「 Test」を選択してテストします。 エディターは、プロンプトと指定したサンプル データに基づいて応答を生成します。
Create a custom promptでプロンプトを作成・テストするためのエディターの使い方を学びましょう。
迅速な指示のためのベストプラクティス
プロンプトノードを使う際は、プロンプトエンジニアリングのベストプラクティスに従ってください。 この機能を最大限に活用するには、次のヒントを参考にしてください。
- 具体的に:カスタム指示を明確かつ具体的に作成し、エージェントが正確に何をすべきか分かるようにしましょう。 混乱や誤った応答につながる可能性のある、曖昧な言葉やあいまいな言葉は避けてください。
- 例を使用する: 指示を説明する例を示し、エージェントが自分の期待を理解できるようにします。 例は、エージェントが正確で適切な応答を生成するのに役立ちます。
- シンプルに保つ:カスタム指示に詳細や複雑な論理を詰め込みすぎないようにしましょう。 エージェントが効果的に処理できるよう、指示はシンプルかつ簡潔にしてください。
- 簡潔に:カスタム指示は簡潔かつ要点を押さえましょう。 命令が長すぎると、待機時間、タイムアウト、またはプロンプトの処理に問題が発生する可能性があります。
- エージェントに抜け道を与える:割り当てられたタスクを完了できない場合に代替ルートをエージェントに与えましょう。 たとえば、ユーザーが質問したときに、「回答が見つからない場合は "見つかりません" と応答してください」という内容を含めることができます。この代替パスにより、エージェントは誤った応答の生成を回避できます。
- テストと改良:カスタム指示が意図通りに動作しているかを徹底的にテストしてください。 エージェントの応答の正確性と有効性を向上させるため、必要に応じて調整を行います。
Important
- プロンプトビルダーのプロンプトは、Azure OpenAI ServiceおよびAzure AI Foundryが提供するモデル上で動作します。
- この機能は特定の地域に限定されています。
- この機能は、使用制限または容量帯域幅調整の対象となる場合があります。