大規模言語モデル（LLM）アプリケーションを構築する際、異なるビジネスシナリオごとに類似したプロンプトを設計・調整するのは、時間と手間がかかる上に、保守性も低くなります。プロンプトテンプレートは、固定されたプロンプト構造と動的な変数を分離する仕組みです。再利用可能なテンプレートを作成することで、プロンプトを一元管理・最適化し、効率的な生成を実現できます。
このトピックは、国際版（シンガポールリージョン）にのみ適用されます。
ワークフロー
-
テンプレートの作成：Alibaba Cloud Model Studio コンソールまたは API を使用してテンプレートを作成・保存できます。作成後、一意のテンプレート ID が発行されます。
-
テンプレートの取得：API とテンプレート ID を使用して、テンプレートの内容を取得できます。
-
プロンプトの生成：テンプレート内の変数にご利用のビジネスデータを入力し、最終的なプロンプトを生成します。
-
テンプレートの利用：生成されたプロンプトを対象のモデルに送信して、結果を取得します。
テンプレートの種類
プロンプトテンプレートは、「組み込みプロンプトテンプレート」と「カスタムプロンプトテンプレート」の 2 種類に分類されます。
|
ディメンション |
組み込みプロンプトテンプレート |
カスタムプロンプトテンプレート |
|
提供元 |
Alibaba Cloud Model Studio が提供。複数のビジネスシナリオに対応しています。 |
|
|
有効性 |
最適化済みで安定しています。 |
ご自身で設計・テストを行います。その有効性は設計品質に依存します。 |
|
使いやすさ |
追加の開発作業は不要です。コンソールまたは API から直接呼び出せます。
|
テンプレートの精度向上には複数回の反復が必要になる場合があります。そのため、明確な命令、例に基づくガイダンス、フォーマット制約などのプロンプト設計原則および最適化手法を理解し、基本的な開発および技術スキルを有している必要があります。 |
|
主な利用シーン |
|
|
|
編集可否 |
いいえ。 |
必要に応じて自由に調整できます。 |
組み込みプロンプトテンプレート
1. 表示
Alibaba Cloud Model Studio が提供するさまざまなシナリオ向けの組み込みプロンプトテンプレートを表示・利用するには、プロンプト ページにアクセスします。
2. 表示と管理
表示：テンプレートカードの 詳細を見る をクリックすると、テンプレートの名前、内容、変数、ID を確認できます。
管理：
-
をクリックして、テンプレートの内容をコピーできます。
-
をクリックします。テンプレートの内容が自動的に エージェントアプリケーション のプロンプトエディターに挿入されます。そのまま利用するか、ご利用のシナリオに合わせて編集できます。
-
をクリックすると、「組み込みプロンプトテンプレート名_コピー_タイムスタンプ」という名前のカスタムプロンプトテンプレートが、プロンプト ページに作成されます。
カスタムプロンプトテンプレート
1. 作成
カスタムプロンプトテンプレートは、コンソール または API のいずれかを使用して作成できます。
コンソール
-
組み込みプロンプトテンプレートの修正
組み込みプロンプトテンプレート カードで、 をクリックすると、「組み込みプロンプトテンプレート名_コピー_タイムスタンプ」という名前のカスタムコピーが作成されます。
-
ビジネスニーズに基づく作成
プロンプト ページで、Create Prompt をクリックし、設定を完了してから 保存 をクリックすると、テンプレートが作成されます。
API
-
ワークスペース ID の取得：詳細については、「APP ID およびワークスペース ID の取得」をご参照ください。
-
カスタムプロンプトテンプレートの作成：「CreatePromptTemplate – プロンプトテンプレートの作成」API を使用できます。
2. 表示と管理
表示：カスタムプロンプトテンプレートを作成後、プロンプト ページで確認できます。
管理：
-
テンプレートカードの 編集 をクリックして、内容を変更できます。
-
をクリックして、テンプレートの内容をコピーできます。
-
をクリックします。テンプレートの内容が自動的に エージェントアプリケーション のプロンプトエディターに挿入されます。そのまま利用するか、ご利用のシナリオに合わせて編集できます。
-
をクリックすると、「カスタムプロンプトテンプレート名_コピー_タイムスタンプ」という名前の新しいカスタムプロンプトテンプレートが、現在のページに作成されます。
-
をクリックすると、作成済みのテンプレートを削除できます。
プロンプトテンプレートの利用
コンソール
-
組み込みまたはカスタムのプロンプトテンプレートカードで、 をクリックします。テンプレートの内容が自動的にエージェントアプリケーションのプロンプトフィールドに挿入されます。
-
アプリケーションにモデルを設定し、質問を入力してプロンプトをテストできます。
API
-
GetPromptTemplate – プロンプトテンプレートの取得 の API リファレンスを開き、Debug をクリックします。
-
パラメータ設定 パネルで、workspaceId および promptTemplateId を入力します。
-
workspaceId：ご利用のワークスペース ID。詳細については、「APP ID およびワークスペース ID の取得」をご参照ください。
-
promptTemplateId：組み込みまたはカスタムのプロンプトテンプレートの ID。テンプレートカード上で確認できます。
-
-
呼び出し をクリックして、API をオンラインでデバッグできます。
SDK
-
GetPromptTemplate – プロンプトテンプレートの取得 の API リファレンスを開き、Debug をクリックします。
-
パラメータ設定 パネルで、workspaceId および promptTemplateId を入力します。設定後、これらの値が自動的に SDK の例に挿入されます。
-
workspaceId：ご利用のワークスペース ID。詳細については、「APP ID およびワークスペース ID の取得」をご参照ください。
-
promptTemplateId：組み込みまたはカスタムのプロンプトテンプレートの ID。テンプレートカード上で確認できます。
-
-
デバッグパネルで、SDK の例 をクリックします。
-
オンラインで例を実行するか、プロジェクト全体をダウンロードし、accessKeyId および accessKeySecret を設定してから実行できます。
詳細については、「AccessKey および AgentKey の取得」をご参照ください。
エラーコード
呼び出しが失敗してエラーが返された場合、トラブルシューティング情報については、「エラーメッセージ」をご参照ください。
よくある質問
Q：「GetPromptTemplate」API を呼び出すことと、コード内でプロンプト文字列を直接構築することの違いは何ですか？
A：「GetPromptTemplate」API を使用することで、以下のようなメリットがあります：
-
ロジックとコンテンツの分離：コードの変更や再デプロイを伴わず、Alibaba Cloud Model Studio コンソール上でプロンプトの更新・最適化が可能です。
-
一元管理と共同作業：すべてのプロンプトを一箇所に保管できます。これにより、プロンプトエンジニアや開発者など、チーム全体で共同作業を行い、バージョン管理やテンプレートの再利用が可能になります。
-
プロンプトの一貫性：アプリケーションのすべての部分やすべてのサービスで、同一のプロンプトバージョンおよび構造を使用できることを保証できます。これにより、手動による更新に起因する不整合を回避できます。