# プロンプトの作成と管理

> プロンプトの作成と管理 - プロンプトの作成、変数の追加、バージョン管理、エージェントで使用するプロンプトのユーザーまたは組織との共有。

This Markdown file sits beside the HTML page at the same path (with a `.md` suffix). It summarizes the topic and lists links for tools and LLM context.

Companion generated at `2026-07-23T18:01:59.367277+00:00` (UTC).

## Primary page

- [プロンプトの作成と管理](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md): Full documentation for this topic (Markdown sidecar).

## Sections on this page

- [プロンプトの作成](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#create-prompts): In-page section heading.
- [変数の追加](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#add-variables): In-page section heading.
- [定義されたプロンプトを表示する](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#view-defined-prompts): In-page section heading.
- [プロンプトのバージョンを作成する](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#create-prompt-versions): In-page section heading.
- [プロンプトの管理](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#manage-prompts): In-page section heading.
- [テーブル内のリストをフィルターする](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#filter-table-listing): In-page section heading.
- [バージョンを比較](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#compare-versions): In-page section heading.
- [プロンプトの共有](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#share-prompts): In-page section heading.

## Documentation content

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

プロンプト タイルには、最初は保存済みおよび共有済みのプロンプトすべてが一覧表示されます。 エントリーをクリックすると、設定の詳細が表示されます。

**レジストリのリスト:**
[https://docs.datarobot.com/ja/docs/images/manage-prompts-2.png](https://docs.datarobot.com/ja/docs/images/manage-prompts-2.png)

**プロンプトの詳細:**
[https://docs.datarobot.com/ja/docs/images/prompt-3.png](https://docs.datarobot.com/ja/docs/images/prompt-3.png)


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

- プロンプトの作成 。
- プロンプトの反復処理のための バージョン管理機能 。
- プロンプトの比較、およびユーザーや組織とのプロンプトの共有による プロンプトの管理 。
- エージェントでのプロンプトの呼び出し 。

**詳細：プロンプト管理のメリット**

プロンプトを単純なテキストファイルとして管理すると、運用レベルのAIエージェントを構築する際に重大なリスクと非効率性が生じます。 DataRobotのプロンプト管理システムは、以下の表に示す主要な問題に対処します。

| 問題 | プロンプト管理システムによるソリューション |
| --- | --- |
| バージョン管理の競合 | バージョン管理は、変更の追跡に不可欠であり、再現性を確保し、安定したバージョンへのロールバックを容易にし、コラボレーション、デバッグ、およびコンプライアンスのための明確な監査証跡を作成します。 |
| 一貫性の欠如 | テンプレートを使えば、プロンプト構造を標準化して再利用し、静的な命令と動的なデータを分離することができます。 その結果、アプリケーションコードを変更することなく、イテレーションが高速化され、一貫性が確保され、更新が容易になります。 |
| コンプライアンス違反 | ガバナンスによって、プロンプトを作成、テスト、デプロイするためのプロセスを制御できます。 これにより、一元化されたレジストリと承認ワークフローを通じて、品質、セキュリティ、コンプライアンスが確保されます。これは企業にとって不可欠です。 また、ガバナンスは、プロンプトに含めることができるデータのタイプに関するポリシーを適用することによって、プロンプトインジェクション攻撃やデータ漏洩などのセキュリティリスクを軽減するのにも役立ちます。 大規模な組織では、一元化された管理と監視によって、一貫性のないプロンプトや低品質のプロンプトの拡散を防ぎ、LLMが全社的にどのように使用されているかを包括的に把握できます。 |
| スタンドアロンテスト | 統合プラットフォームにより、データ駆動型のプロンプトエンジニアリングを用いた実験と評価が可能になります。 A/Bテスト、比較テスト、およびパフォーマンス追跡（コスト、レイテンシー、品質）は、最も効果的なプロンプトを特定するのに役立ちます。 |

## プロンプトの作成

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

**最初のプロンプト:**
プロンプトを作成していない場合、またはプロンプトを共有していない場合、ライブラリは空の状態を示します。

[https://docs.datarobot.com/ja/docs/images/prompt-2.png](https://docs.datarobot.com/ja/docs/images/prompt-2.png)

**入力されたプロンプトライブラリ:**
プロンプトを作成した場合、またはプロンプトが共有されている場合は、 プロンプト タイルのランディングページに一覧表示されます。

[https://docs.datarobot.com/ja/docs/images/prompt-1.png](https://docs.datarobot.com/ja/docs/images/prompt-1.png)


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

| フィールド | 説明 |
| --- | --- |
| 名前 | プロンプトの名前を入力します。 名前に含めることができるのは、英文字、数字、アンダースコア（_）、ダッシュ（-）、スペース、角括弧だけです。 |
| 説明 | プロンプトの説明を入力します。 説明は開発者向けです。プロンプトライブラリのランディングページと個々のプロンプトの詳細ページに表示されます。 |
| プロンプトテキスト | 各ユーザープロンプトに含めるテキストを500万文字以内で入力します。 プロンプトテキストには、以下で説明するように、変数を含めることができます。 なお、このフィールドに入力されたテキストは、LLMの最大出力トークン数の制限の一部としてカウントされます。 1つのプロンプトで最大100個の変数を使用できます。 |
| 変数 | 二重中括弧{{ variable_name }}で囲まれた変数名を入力します。 変数の定義はエージェントファイルに含める必要があり、英数字およびアンダースコア（_）のみを使用してください。 変数の文字数制限は次のとおりです。名前の最大文字数 = 200文字。説明の最大文字数 = 200文字。 |
| コメント（オプション） | 個々のプロンプトの詳細ページに表示するテキストを入力します。 |

変数を使用していない場合は、 作成 をクリックします。 使用している場合は、 [変数の追加](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#add-variables) に関するセクションを参照してください。

また、既存のプロンプトを修正する方法については、 [プロンプトのバージョン管理](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#create-prompt-versions) を参照してください。

### 変数の追加

プロンプトテキスト フィールドに変数を入力すると、 変数 セクションが展開され、説明フィールドが表示されます。 説明は必須です。このフィールドの内容は、個々のプロンプトの詳細ページに表示されます。 変数を定義するものでは ありません 。 [変数の定義](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/prompt-in-agent.html.md) は、 `agents.py` ファイルの `MyAgent` クラスで行う必要があります。

変数を含めるには：

1. agents.pyで変数を定義します。 なお、この手順を最初に完了する必要はありませんが、プロンプトをテストする前に完了する必要があります。
2. 変数名を二重括弧（{{ }}）で囲んで変数を示すプロンプトテキストを入力します。 参照する変数ごとに、その変数のエントリーが変数セクションに含まれています。 プロンプトテキストで同じ変数を複数回使用できます。
3. 作成をクリックします。

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

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

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

表示されるプロンプトは読み取り専用です。 修正するには、 [新しいバージョンを作成](https://docs.datarobot.com/ja/docs/agentic-ai/prompt-mgmt/create-prompts.html.md#create-prompt-versions) します。

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

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

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

1. レジストリのプロンプトタイルにあるプロンプトのテーブルリストから、修正したいプロンプトをクリックします。 プロンプトの最新バージョンが表示されます。読み取り専用です。
2. 右上の現行プロンプトから新しいバージョンを作成をクリックして、プロンプトの新しいバージョンを作成するためのキャンバスを開きます。 既存のプロンプトテキスト、変数、およびコメント領域が編集可能になりました。 ただし、名前と説明は編集できません。
3. 必要に応じて、テキストと変数を修正します。 すべての説明フィールドが入力されていることを確認します。
4. 作成をクリックします。 新しいプロンプトがバージョンパネルに表示されます。

## プロンプトの管理

プロンプトを作成した後、またはプロンプトが自分と共有された後、それらを並べ替え、比較、および共有できます。 プロンプト管理システムは、レジストリ内の プロンプト タイルからアクセスします。

### テーブル内のリストをフィルターする

プロンプトテーブルをフィルターして、特定のユーザーが作成したプロンプトのみを一覧表示することができます。 これを行うには、 作成者 ドロップダウンからプロンプト作成者を選択します。

### バージョンを比較

バージョン間で行われた変更を確認するには、 バージョンの比較 機能を使用します。 比較するには：

1. テーブル内のリストからプロンプトを選択します。 最新バージョンのプロンプトが開きます。
2. バージョンを比較をクリックして、比較モーダルを開きます。
3. ドロップダウンを使用して、比較するバージョンを選択します。 色によってプロンプトテキストの変更箇所を識別できます。エントリー全体を確認するには、スクロールバーを使用します。 変数およびコメントの変更箇所も示されます。

### プロンプトの共有

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

[標準共有](https://docs.datarobot.com/ja/docs/api/dev-learning/python/admin/sharing.html.md) モーダルが表示されます。