プロンプト エディター

[プロンプト エディター] は 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	選択したテキストを斜体にする	—
</>	インライン コード	—
番号付きリスト	番号付きリストを切り替える	—
箇条書き	箇条書きリストを切り替える	—
元に戻す	編集をさかのぼる	Ctrl / ⌘ + Z
やり直す	編集を前進させる	Ctrl / ⌘ + Shift + Z

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

カバレッジのハイライト

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

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

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

AI による提案を確認する

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

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

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

全画面表示の編集

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

アクセシビリティ

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

よくある質問

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

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

Can I still type {{ to insert an argument?

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

Does the @ trigger conflict with email addresses or social handles?

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

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

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

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

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

参照

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