プロンプトの作成とバージョン管理¶
プロンプトは、LLMやエージェントと対話したり、LLMやエージェントから出力を生成したりする上で基本的な部分です。 プロンプト管理システムは、レジストリ内のプロンプトタイルからアクセスします。これにより、プロンプトをエージェントコンポーネントとしてプロトタイプ作成、実験、デプロイ、および監視するための、一元化され、バージョン管理された統合システムを利用できます。
システムは以下をサポートしています。
- プロンプトの作成。
- バージョン管理機能。時間の経過に伴うプロンプトの変更を管理します。
- エージェントでのプロンプトの呼び出し。
詳細：プロンプト管理のメリット
プロンプトを単純なテキストファイルとして管理すると、運用レベルのAIエージェントを構築する際に重大なリスクと非効率性が生じます。 DataRobotのプロンプト管理システムは、以下の表に示す主要な問題に対処します。
| 問題 | プロンプト管理システムによるソリューション |
|---|---|
| バージョン管理の競合 | バージョン管理は、変更の追跡に不可欠であり、再現性を確保し、安定したバージョンへのロールバックを容易にし、コラボレーション、デバッグ、およびコンプライアンスのための明確な監査証跡を作成します。 |
| 一貫性の欠如 | テンプレートを使えば、プロンプト構造を標準化して再利用し、静的な命令と動的なデータを分離することができます。 その結果、アプリケーションコードを変更することなく、イテレーションが高速化され、一貫性が確保され、更新が容易になります。 |
| コンプライアンス違反 | ガバナンスによって、プロンプトを作成、テスト、デプロイするためのプロセスを制御できます。 これにより、一元化されたレジストリと承認ワークフローを通じて、品質、セキュリティ、コンプライアンスが確保されます。これは企業にとって不可欠です。 また、ガバナンスは、プロンプトに含めることができるデータのタイプに関するポリシーを適用することによって、プロンプトインジェクション攻撃やデータ漏洩などのセキュリティリスクを軽減するのにも役立ちます。 大規模な組織では、一元化された管理と監視によって、一貫性のないプロンプトや低品質のプロンプトの拡散を防ぎ、LLMが全社的にどのように使用されているかを包括的に把握できます。 |
| スタンドアロンテスト | 統合プラットフォームにより、データ駆動型のプロンプトエンジニアリングを用いた実験と評価が可能になります。 A/Bテスト、比較テスト、およびパフォーマンス追跡（コスト、レイテンシー、品質）は、最も効果的なプロンプトを特定するのに役立ちます。 |
プロンプトの作成¶
プロンプトを作成するには、レジストリ > プロンプトを開きます。 プロンプトライブラリが開き、プロンプトを作成ボタンが利用できます。
プロンプトを作成していない場合、またはプロンプトを共有していない場合、ライブラリは空の状態を示します。
プロンプトを作成した場合、またはプロンプトが共有されている場合は、プロンプトタイルのランディングページに一覧表示されます。
プロンプトを作成をクリックし、フィールドに入力します。 すべてのフィールドで、最大5000文字まで入力可能です。
| フィールド | 説明 |
|---|---|
| 名前 | プロンプトの名前を入力します。 名前に含めることができるのは、英文字、数字、アンダースコア（_）、ダッシュ（-）、スペース、角括弧だけです。 |
| 説明 | プロンプトの説明を入力します。 説明は開発者向けです。プロンプトライブラリのランディングページと個々のプロンプトの詳細ページに表示されます。 |
| プロンプトテキスト | 各ユーザープロンプトに含まれるテキストを入力します。 プロンプトテキストには、以下で説明するように、変数を含めることができます。 なお、このフィールドに入力されたテキストは、LLMの最大出力トークン数の制限の一部としてカウントされます。 1つのプロンプトで最大100個の変数を使用できます。 |
| 変数 | 二重中括弧{{ variable_name }}で囲まれた変数名を入力します。 変数の定義はエージェントファイルに含める必要があり、英数字およびアンダースコア（_）のみを使用してください。 変数の文字数制限は次のとおりです。
|
| コメント（オプション） | 個々のプロンプトの詳細ページに表示するテキストを入力します。 |
変数を使用していない場合は、作成をクリックします。 使用している場合は、変数の追加に関するセクションを参照してください。
また、既存のプロンプトを修正する方法については、プロンプトのバージョン管理を参照してください。
変数の追加¶
プロンプトテキストフィールドに変数を入力すると、変数セクションが展開され、説明フィールドが表示されます。 説明は必須です。このフィールドの内容は、個々のプロンプトの詳細ページに表示されます。 変数を定義するものではありません。 変数の定義は、agents.pyファイルのMyAgentクラスで行う必要があります。
変数を含めるには：
-
agents.pyで変数を定義します。 なお、この手順を最初に完了する必要はありませんが、プロンプトをテストする前に完了する必要があります。 -
変数名を二重括弧（{{ }}）で囲んで変数を示すプロンプトテキストを入力します。 参照する変数ごとに、その変数のエントリーが変数セクションに含まれています。
プロンプトテキストで同じ変数を複数回使用できます。
-
作成をクリックします。
定義されたプロンプトを表示する¶
レジストリでプロンプトタイルをクリックすると、プロンプトライブラリが開き、自分が作成した、または共有しているすべてのプロンプトが一覧表示されます。 プロンプト名を検索することも、作成者フィルターを使用して作成者で検索することもできます。
エントリーをクリックすると、プロンプトの最新バージョンの詳細が表示されます。 すべてのバージョンのリストが右側のパネルに表示されます。 別のバージョンを表示するには、パネル内のバージョンをクリックするか、ドロップダウンを使用します。
表示されるプロンプトは読み取り専用です。 修正するには、新しいバージョンを作成します。
プロンプトのバージョンを作成する¶
プロンプトのバージョン管理は、時間の経過に伴うプロンプトの変更を管理する上で極めて重要です。なぜなら、わずかな変更であっても、LLMの出力を大きく左右する可能性があるためです。 これにより、再現性が確保され、チームは特定のモデル出力を生成した正確なプロンプトバージョンにリンクできます。また、新しい変更によってパフォーマンスが低下した場合に、安定したバージョンへの迅速なロールバックが容易になります。
プロンプトのバージョンを管理するには：
-
レジストリのプロンプトタイルにあるプロンプトのリストから、修正したいプロンプトをクリックします。 読み取り専用バージョンが表示されます。
-
右上の現行プロンプトから新しいバージョンを作成をクリックして、プロンプトの新しいバージョンを作成するためのキャンバスを開きます。 既存のプロンプトテキスト、変数、およびコメント領域が編集可能になりました。 ただし、名前と説明は編集できません。
-
必要に応じて、テキストと変数を修正します。 すべての説明フィールドが入力されていることを確認します。
-
作成をクリックします。 新しいプロンプトがバージョンパネルに表示されます。
プロンプトの共有¶
ユーザー、グループ、または組織とプロンプトを共有できます。 オーナーは、既存のプロンプトから共有、ロールの変更、または新しいバージョンの作成ができます。 プロンプトを共有するには、アクションメニュー をクリックし、プロンプトを共有を選択します。 標準共有モーダルが表示されます。