18.8.4.3 AI構成とRAGソースの管理
AI構成とRAGソースを作成して、生成AIサービスとのより充実したやり取りを可能にします。
- AI構成とRAGソースについて
AI構成とRAGソースについて学習します。 - AI構成の作成
「生成AI構成」ページにある「共有コンポーネント」でAI構成を作成します。 - AI構成の編集または削除
「生成AIサービス」の「作成/編集」ページからAI構成やRAGソースを編集または削除します。 - AI構成のコピーまたはサブスクライブ
現在のアプリケーションまたは別のアプリケーションからAI構成をコピーします。別のアプリケーションからAI構成をコピーするときに、それをサブスクライブすることもできます。 - AI構成使用状況の表示
現在のワークスペース内でAI構成が使用されている場所について、詳細を示すレポートを表示します。 - AI構成履歴の表示
このワークスペース内でAI構成に対して行われた最近の変更について、レポートを表示します。
親トピック: アプリケーションへの生成AIの組込み
18.8.4.3.1 AI構成とRAGソースについて
AI構成とRAGソースについて学習します。
「AI構成」は、主要な生成AI設定(システム・プロンプト、ようこそメッセージ、検索拡張生成(RAG)ソースなど)を一元化する共有コンポーネントです。AI構成を作成すると、「AIアシスタントの表示」や「AIによるテキストの生成」の動的アクションなど、複数のAI対応コンポーネント間でこれらの設定を再利用できます。APEX_AI
パッケージ内にあるPL/SQL APIでAI構成を使用することもできます。
AI構成について
AI構成には次の内容が含まれています:
- 名前 - アプリケーション・ビルダーのUIにおいてそのAI構成を識別します。
- 静的ID - このIDを使用して、
APEX_AI
パッケージ内のAPIでAI構成を参照します。 - サービス - そのAI構成で使用するAIサービスを示します。デフォルトでは、「アプリケーション・デフォルト」が使用されます。
- システム・プロンプト - AIサービスに対する初期指示またはコンテキスト。
- ようこそメッセージ - AIアシスタントによって表示される最初のメッセージ。この設定を使用できるのはUIがあるコンポーネント(「AIアシスタントの表示」など)のみであることに注意してください。
- 温度 - 生成されるコンテンツのランダム性または予測可能性のレベルを設定します。
- RAGソース - AIサービスに追加送信するデータ。
RAGソースについて
各AI構成には、アプリケーション固有のデータでAI会話を改善するために役立つ、0個以上のRAGソースを含めることができます。RAGソースとしては、「SQL問合せ」、「CLOBを返すファンクション本体」または単に「静的テキスト」を指定できます。RAGソースは動的であり、サーバー側の条件によって個別に保護できます。条件を満たした場合、結果となるコンテンツは、リクエストごとにシステム・プロンプトとともにAIサービスに送信され、実質的に、付加的なシステム・プロンプトの役割を果たします。
RAGソースには次の内容が含まれています:
- 名前 - アプリケーション・ビルダーのUIにおけるそのRAGソースの名前。
- 説明 - AIサービスに送信する、含まれているデータの説明。
- ソース・タイプ:
- SQL問合せ - 選択した場合、結果セットはCSV形式で含まれます。必ず、関連する列のみを含め、結果セットを関連する行のみに限定してください。
- CLOBを返すファンクション本体
- 静的テキスト
RAGソースとサーバー側条件
サーバー側の条件を満たしている各RAGソースが評価され、付加的なシステム・メッセージとして含まれます。RAGソースはコールごとに再評価されて送信されるため、ペイロードによってはトークン使用量が多くなる場合があることに注意してください。
会話に関連するデータのみが含まれるようにするには、RAGデータを条件付きで含めるための、次のいずれかの方法を使用します:
- 「セキュリティ」、「認可スキーム」を使用すると、特定のユーザーのみに特定のデータ・セットを提供するために役立ちます。
- 「サーバー側の条件」を使用すると、柔軟性がさらに高まります。一般的な条件タイプの他に、RAGソースでは、生成AI固有の条件タイプが2つ(「任意のユーザー・プロンプトに含まれる」と「最後のユーザー・プロンプトに含まれる」)サポートされています。これらの条件タイプを使用して、大/小文字の区別なしのキーワードのカンマ区切りリストを指定できます。任意のユーザー・プロンプトまたは最後のユーザー・プロンプトにそのようなキーワードが含まれている場合は、そのRAGソースが評価され、そのデータが含まれます。
- 柔軟性を最大限に高めるために、サーバー側条件のコードを実行するときと、SQL問合せまたはファンクション本体において、2つの新しいバインド変数を使用できます。
APEX$AI_ALL_USER_PROMPTS
とAPEX$AI_LAST_USER_PROMPT
は、カスタムRAGロジックを実行するために使用できるCLOB
バインド変数です。
使用可能なディクショナリ・ビュー
次のディクショナリ・ビューを使用して、アプリケーションのAI構成を問い合せることもできます:
APEX_APPL_AI_CONFIGS
APEX_APPL_AI_CONFIG_RAG_SRCS
親トピック: AI構成とRAGソースの管理
18.8.4.3.3 AI構成の編集または削除
「生成AIサービス」の「作成/編集」ページからAI構成やRAGソースを編集または削除します。
AI構成やRAGソースを編集または削除するには:
親トピック: AI構成とRAGソースの管理
18.8.4.3.4 AI構成のコピーまたはサブスクライブ
現在のアプリケーションまたは別のアプリケーションからAI構成をコピーします。別のアプリケーションからAI構成をコピーするときに、それをサブスクライブすることもできます。
AI構成をコピーするには:
- 「AI構成」ページに移動します:
- そのAI構成で、「コピー」をクリックします。
- コピー元 - AI構成のコピー元となる場所を選択します。オプションは次のとおりです。
- このアプリケーション
- その他のアプリケーション
- 現在のアプリケーションからコピーするには:
- コピー元 - 「このアプリケーション」を選択します。
- 構成のコピー - コピーする構成を選択します。
- 名前 - 作成する構成の名前を入力します。
- 「コピー」をクリックします。
- 別のアプリケーションからコピーするには:
- コピー元 - 「その他のアプリケーション」を選択します。
- アプリケーション - コピー元のアプリケーションを選択します。
- 構成のコピー - コピーする構成を選択します。
- サブスクライブ - 構成をサブスクライブするには、「サブスクライブ」を有効にします。
- 「コピー」をクリックします。
親トピック: AI構成とRAGソースの管理
18.8.4.3.5 AI構成使用状況の表示
現在のワークスペース内でAI構成が使用されている場所について、詳細を示すレポートを表示します。
AI構成使用状況レポートを表示するには:
親トピック: AI構成とRAGソースの管理
18.8.4.3.6 AI構成履歴の表示
このワークスペース内でAI構成に対して行われた最近の変更について、レポートを表示します。
AI構成履歴レポートを表示するには:
親トピック: AI構成とRAGソースの管理