Create and manage prompts¶

プロンプトは、LLMやエージェントと対話したり、LLMやエージェントから出力を生成したりする上で基本的な部分です。 プロンプト管理システムは、レジストリ内のプロンプトタイルからアクセスします。これにより、プロンプトをエージェントコンポーネントとしてプロトタイプ作成、実験、デプロイ、および監視するための、一元化され、バージョン管理された統合システムを利用できます。

The Prompts tile initially lists all saved and shared prompts. Click an entry for configuration details.

システムは以下をサポートしています。

• Creating prompts.
• Versioning capabilities, for iterating on to prompts.
• Managing prompts by comparing and sharing prompts with users or organizations.
• エージェントでのプロンプトの呼び出し。

プロンプトの作成¶

プロンプトを作成するには、レジストリ > プロンプトを開きます。 プロンプトライブラリが開き、プロンプトを作成ボタンが利用できます。

プロンプトを作成をクリックし、フィールドに入力します。 すべてのフィールドで、最大5000文字まで入力可能です。

変数を使用していない場合は、作成をクリックします。 使用している場合は、変数の追加に関するセクションを参照してください。

また、既存のプロンプトを修正する方法については、プロンプトのバージョン管理を参照してください。

変数の追加¶

プロンプトテキストフィールドに変数を入力すると、変数セクションが展開され、説明フィールドが表示されます。 説明は必須です。このフィールドの内容は、個々のプロンプトの詳細ページに表示されます。 変数を定義するものではありません。 変数の定義は、agents.pyファイルのMyAgentクラスで行う必要があります。

変数を含めるには：

1. agents.pyで変数を定義します。 なお、この手順を最初に完了する必要はありませんが、プロンプトをテストする前に完了する必要があります。

2. 変数名を二重括弧（{{ }}）で囲んで変数を示すプロンプトテキストを入力します。 参照する変数ごとに、その変数のエントリーが変数セクションに含まれています。

   

   プロンプトテキストで同じ変数を複数回使用できます。

3. 作成をクリックします。

定義されたプロンプトを表示する¶

レジストリでプロンプトタイルをクリックすると、プロンプトライブラリが開き、自分が作成した、または共有しているすべてのプロンプトが一覧表示されます。 プロンプト名を検索することも、作成者フィルターを使用して作成者で検索することもできます。

エントリーをクリックすると、プロンプトの最新バージョンの詳細が表示されます。 すべてのバージョンのリストが右側のパネルに表示されます。 別のバージョンを表示するには、パネル内のバージョンをクリックするか、ドロップダウンを使用します。

表示されるプロンプトは読み取り専用です。 修正するには、新しいバージョンを作成します。

プロンプトのバージョンを作成する¶

プロンプトのバージョン管理は、時間の経過に伴うプロンプトの変更を管理する上で極めて重要です。なぜなら、わずかな変更であっても、LLMの出力を大きく左右する可能性があるためです。 これにより、再現性が確保され、チームは特定のモデル出力を生成した正確なプロンプトバージョンにリンクできます。また、新しい変更によってパフォーマンスが低下した場合に、安定したバージョンへの迅速なロールバックが容易になります。

プロンプトのバージョンを管理するには：

1. Click on the prompt you want to modify from the table list of prompts on the Prompts tile in Registry. The display shows the most recent version of the prompt; it is read-only.

2. 右上の現行プロンプトから新しいバージョンを作成をクリックして、プロンプトの新しいバージョンを作成するためのキャンバスを開きます。 既存のプロンプトテキスト、変数、およびコメント領域が編集可能になりました。 ただし、名前と説明は編集できません。

3. 必要に応じて、テキストと変数を修正します。 すべての説明フィールドが入力されていることを確認します。

   

4. 作成をクリックします。 新しいプロンプトがバージョンパネルに表示されます。

Manage prompts¶

Once you have created prompts, or prompts have been shared with you, you can sort, compare, and share them. Access the prompt management system from the Prompts tile within Registry.

Filter table listing¶

You can filter the prompt table to list only those prompts created by certain users. To do so, select prompt creators from the Created by dropdown.

バージョンを比較¶

Use the Compare versions functionality to review changes made between versions. To compare:

1. Select the prompt from the table listing. The latest version of the prompt opens.

2. Click Compare versions to open the comparison modal.

   

3. Using the dropdowns, select the versions to compare.

   

   Color helps to identify changes in the prompt text; use the scrollbars to see complete entries. Changes in variable and comments are also indicated.

プロンプトの共有¶

ユーザー、グループ、または組織とプロンプトを共有できます。 オーナーは、既存のプロンプトから共有、ロールの変更、または新しいバージョンの作成ができます。 プロンプトを共有するには、アクションメニュー をクリックし、プロンプトを共有を選択します。

標準共有モーダルが表示されます。