プロンプト エディター

Agent Builder のリッチ テキスト エディターでシステム プロンプトとユーザー プロンプトを記述します。@ トリガーを使用して、引数、ツール、コンテキスト、エスカレーション、出力への色分けされたインライン参照を挿入します。

プロンプト エディターは、システム プロンプトとユーザー プロンプトを記述するための Agent Builder のリッチ テキスト領域です。引数、ツール、コンテキスト、エスカレーション、および出力は、型付きプレースホルダーではなく、ピルと呼ばれる色分けされたインライン参照として表されます。

プロンプト エディターは、自律型エージェントと会話型エージェントで利用でき、システム プロンプトとユーザー プロンプトに適用されます。

@ トリガー

プロンプト エディターでは、すべての参照の種類に対して 1 つのトリガー キーが使用されます。

プロンプトの任意の場所に「@」を入力すると、参照ピッカーが開きます。ピッカーは、利用可能な参照を固定された順序で次の 5 つのセクションにグループ化します。

1. 入力 — エージェントが実行時に受け取る引数
2. ツール — エージェントに接続されているツール
3. コンテキスト — コンテキスト グラウンディングのソース
4. エスカレーション — エスカレーション パス
5. 出力 — 前のステップからの出力 (該当する場合)

@ の後に入力を続けると、あいまい一致を使用してリストが絞り込まれます (正確なプレフィックスは必要ありません)。たとえば、「@srch」は「tools.web_search」に一致します。

ピッカー内のキーボード ナビゲーション

キー	操作
↑ / ↓	選択範囲を上下に移動
Tab / Shift+Tab	矢印キーと同じ
Enter	強調表示された参照を挿入
Esc	挿入せずにピッカーを閉じる
マウスによる選択	選択した参照を挿入

@ でピッカーが開かないケース

通常の入力中に意図せずアクティブ化されることを防ぐため、 @ 文字が以下の条件で出現した場合にのみ、ピッカーが開きます。

• 行の先頭、または
• 空白文字の直後。

文の途中で「[e-mail]」と入力してもピッカーは開かず、「@」はプレーン テキストとして保持されます。「@」の前にスペースを入力すると、ピッカーが強制的に開きます。

{{ }} プレースホルダーとの互換性

{{argument_name}} を含む既存のプロンプトは、移行手順なしで引き続き動作します。エディターがプロンプトを読み込むと、 {{ }} プレースホルダーが画面上で自動的にピルに変換されます。プロンプトが保存されると、入力ピルは {{argument_name}} として、ツール、コンテキスト、出力ピルは @{tools.search} としてストレージに書き戻され、プロンプトをテキストとして読み取るバックエンドシステムとの互換性が維持されます。

編集中に {{ ... }} を直接入力することは作成トリガーではありません。これはプレーンテキストとして保存され、プロンプトを保存して再度開いたときにのみピルに変換されます (内部名が既存の引数と一致する場合)。@ を使用して参照を挿入します。

ピルとしての参照

プロンプト内のすべての参照は、以下を含むインライン ピルとしてレンダリングされます。

• カテゴリ アイコン
• ラベル — 参照パスの最後のセグメント (例: tools.web_search ではなく web_search)
• 参照カテゴリを反映する色 (入力は青、ツール、コンテキスト、エスカレーションは緑、出力はオレンジ)

ピルは単一のユニットとして以下のように動作します。

• 矢印キーを使用すると、1 回のキー押下でカーソルがピルをまたいで移動します。
• Backspace または Delete キーを押すと、参照全体が削除されます。
• 各ピルには、マウスをホバーすると表示される × ボタンがあり、クリックすると削除されます。
• ピルをコピーして、同じエージェント内の異なるプロンプト フィールド間で貼り付けたり、別のエージェントのプロンプトに貼り付けたりできます。エディターの外部のプレーン テキストに貼り付けると、ピルは {{...}} または @{...} テキスト形式にフォールバックします。

無効な参照

参照が、もはや存在しないリソース (削除されたツールや手動で名前が変更された引数など) を指している場合、ピルの色が赤に変わります。これは視覚的な通知にすぎず、プロンプトはそのまま保存されます。

無効な参照を解決するには、赤色のピルを削除し、 @ を使用して置換候補を選択するか、基になるリソースの名前を変更して参照が再び有効になるようにします。

名前変更の自動反映

エージェント定義内でツール、引数、コンテキスト、エスカレーション、または出力の名前を変更すると、エディターは変更を検出し、プロンプト フィールド全体でそれを参照していたすべてのピルを自動的に更新します。入れ子になったパスも一貫性を持って書き換えられます。

エージェントの定義の外部で行われた名前の変更 (生の JSON を直接編集するなど) は検出されません。

編集とプレビュー

エディターの上部にあるツールバーには、[編集]/[プレビュー] トグルがあります。

• 編集 — テキストの入力、書式設定の適用、参照の挿入を行うためのライブ編集モードです。
• プレビュー — すべてのピルとマークダウンが適用された、プロンプトの読み取り専用レンダリングです。[プレビュー] を使用すると、長いプロンプトや高度に構造化されたプロンプトを保存する前に、最終的な外観を確認できます。

[プレビュー] に切り替えると、現在の下書きが保持されます。[編集] に戻すと、切り替え前とまったく同じ編集状態に戻ります。

書式設定ツールバー

編集モードでは、ツールバーに以下の書式設定アクションが表示されます。

ボタン	効果	キーボード ショートカット
H	現在の行のトグルの見出し	—
B	選択したテキストを太字にする	—
I	選択したテキストを斜体にする	—
</>	インライン コード	—
番号付きリスト	番号付きリストを切り替え	—
箇条書き	箇条書きリストを切り替える	—
元に戻す	編集操作を 1 つ前に戻す	Ctrl / ⌘ + Z
やり直す	編集操作を 1 つ先に進める	Ctrl / ⌘ + Shift + Z

ツール バーから適用されたマークダウンは、保存されたプロンプトで逐語的に保持され、プレビュー モードでは、完全なマークダウン スタイル (見出し、リスト、フェンス付きコード ブロック、ブロック引用符、表など) でレンダリングされます。プレビュー モードがアクティブな間は、ツールバーは無効になります。

カバレッジの強調表示

評価セットの実行後にプロンプト カバレッジ データが利用可能な場合は、ツールバーに [カバレッジ] トグルが表示されます。

[カバレッジ] を選択すると、エディターが [プレビュー] に切り替わり、評価の実行中にプロンプト内のどの指示が実行されたかがインラインで強調表示されます。強調表示されたセクションを選択すると、ポップオーバーが開き、そのセクションをカバーした特定の評価の実行が一覧表示されます。トグルの横にある ↻ ボタンは、プロンプトまたは評価セットが変更された場合にカバレッジを再計算します。

[編集] に戻すと、カバレッジの強調表示が非アクティブになります。

AI による提案を確認する

Autopilot または別の AI アシスタントがプロンプトの書き換えを提案すると、エディターは以下のように差分モードになります。

• 削除されたコンテンツは赤い取り消し線付きで表示されます。
• 追加されたコンテンツは緑色で強調表示されます。
• 差分が表示されている間は、エディターは読み取り専用になります。

エディターの右下に 2 つのボタンが表示されます。[承認] を選択すると、プロンプトが提案されたバージョンに置き換えられ、[却下] をクリックすると、提案が破棄されて元のバージョンが復元されます。元のプロンプトは、これらのボタンのいずれかが選択されるまで変更されることなく保持されます。

全画面表示の編集

ツールバーの右端にある 展開 アイコンをクリックすると、エディターが全画面表示のモーダルで開きます。これは、利用可能な画面スペースが限られている長いプロンプトの場合に便利です。モーダルで行った編集内容は、モーダルを閉じても保持されます。

アクセシビリティ

• すべてのツールバー ボタンは Tab を使用してキーボードからアクセス可能で、ツールチップと aria-labelが含まれています。
• 参照ピッカーは完全にキーボードのみで操作でき、参照の挿入にマウスは必要ありません。
• [編集]/[プレビュー トグルと [カバレッジ] トグルは、aria-pressed セマンティクスを介してステートを公開します。
• エディターは、 ariaLabel 設定を通じて、アクティブなフィールド名 (「システム プロンプト」など) をスクリーン リーダーに通知します。

よくある質問

既存のプロンプトは動作しなくなりますか?

いいえ。エディターは以前と同じ形式 (入力には {{argument}} 、ツール、コンテキスト、出力には @{path}) の読み取りと書き込みを行います。既存のプロンプトはピルとして自動的に開きます。移行手順は必要ありません。

それでも「 {{ 」と入力して引数を挿入できますか?

いいえ。{{ }} はエディターの作成トリガーではなくなりました。代わりに @ を使用してください。編集中に入力した {{ ... }} はプレーン テキストとして保持され、プロンプトを保存して再度開いたときにのみピルに変換されます (内部名が既存の引数と一致する場合)。

@トリガーがメール アドレスまたはソーシャル ハンドルと競合するか

いいえ。行の先頭または空白文字の直後に @ が出現したときにのみピッカーが開くため、「[e-mail]」のように文の途中にある場合はプレーン テキストとして扱われます。

引数またはツールの名前を変更するとどうなりますか?

エディターは、エージェント定義内で行われた名前の変更を検出し、プロンプト全体ですべての参照を自動的に更新します。基になるリソースが削除された場合、またはエディターが推測できなかった方法でそのパスが変更された場合にのみ、参照が赤色になります。

新しいエディターを無効にできますか?

プロンプト エディターは、ロールアウト中に機能フラグによって制御されます。ロールアウト期間中に前のエディターに戻すには、UiPath の担当者にお問い合わせください。

参照

• プロンプト — システム プロンプト、ユーザー プロンプト、プロンプトの記述ガイダンス
• 引数を定義する — 入力引数と出力引数を作成し、プロンプトで参照する