OpenAIのAssistants APIを呼び出してRetrievalを実行するAPEXアプリケーションを作成してみました。
GIF動画では、以下に列記した操作を行なっています。
- Filesのページを開き、Oracle APEX 23.2の新機能について記述されたWebページのテキストをOpenAIにアップロードします。こちらののページがソースです。
- Assistantsのページを開き、アシスタントを作成します。toolsとしてretrievalを指定し、アップロードしたファイルをAssistant Filesに含めています。
- Messagesのページを開きます。
- 新規にスレッドを作成します。
- メッセージを作成します。Contentには「Oracle APEX 23.2の新機能を、手短に一覧にしてください。」と記述しました。
- 実行します。
- Runオブジェクトが作成されます。リフレッシュをクリックし、Statusがcompletedになるまで待ちます。
- Statusがcompletedになった後に、Roleがassistantのメッセージ（OpenAI側で生成されたメッセージ）の内容を確認します。
今回の問い合わせでは、以下の回答が得られました。
Oracle APEX 23.2の新機能は以下のとおりです：
アプリケーションの作業用コピー: バグ修正や機能追加後、選択的に変更をメインアプリケーションにマージできます。複数の開発者が1つのアプリケーションへの変更をコントリビュートすることが可能です【9†source】。
無制限の属性: 開発者はテンプレート・コンポーネント・プラグインを25属性という制約なしに作成でき、テンプレート・コンポーネントのレンダリングがより高速になりました【13†source】。
ユニバーサル・テーマのさらなる活用: ユニバーサル・テーマに付属するいくつかのテンプレート・コンポーネントが更新され、開発者はアプリケーション全体でテンプレート・コンポーネントの使用方法の汎用性が向上しました【13†source】。
開発者エクスペリエンス向上: 共有コンポーネントのサブスクリプションが改善され、サブスクライブされたコンポーネントが読取り専用となりました。自動依存性解決機能が加わり、サブスクリプションのステータスが共有コンポーネントレポートに表示されるようになりました。更に、一括リフレッシュと削除の機能が提供されます【13†source】。
クイックSQLの更新: 生成されたSQLスクリプトとE-Rダイアグラムが即座にリフレッシュされ、データモデルの視覚化やユーザー・エクスペリエンスの簡素化が可能になりました【13†source】。
RESTデータ・ソースの機能強化: 外部アプリケーションとのより深い統合が可能になり、APEXベースのソリューションが拡大しました。RESTソース・パラメータ及びRESTソース・プラグインが強化され、OpenAPIからのRESTソース・カタログを作成でき、ネイティブOData RESTソース・タイプが統合されました。さらに、Fusion Applications拡張機能のサポートが可能になり、Oracle Cloud ApplicationsのRESTデータ・ソースが完全で最適化され、Fusion Applicationsサンドボックスでの進行中のカスタマイズが簡単になりました【13†source】。
追加の新機能について情報を提供するには、さらにドキュメントをレビューする必要があります。もし必要であれば、その情報を提供できるよう検索を続けます。
上記のAPEXアプリケーションのエクスポートを以下に置いています。
https://github.com/ujnak/apexapps/blob/master/exports/openai-retrieval-assistant.zip
以下より、APEXアプリケーションの作成手順を紹介します。
以下の２つの記事で作成しているPL/SQLパッケージとRESTデータ・ソースを流用します。
パッケージUTL_OPENAI_FILES_API: https://gist.github.com/ujnak/3cb786a578c7884872d00789ceba70c9
記事「Oracle APEXのアプリケーションからOpenAIのAssistants APIを呼び出す」より、パッケージUTL_OPENAI_ASSISTANTS_APIとRESTデータ・ソースのList assistants、List messages、List runsを流用します。
パッケージUTL_OPENAI_ASSISTANTS_API: https://gist.github.com/ujnak/894aa93d7db34a6970345798ad7f86ac
パッケージUTL_OPENAI_FILES_APIおよびUTL_OPENAI_ASSISTANTS_APIは、これらのコードをSQLワークショップのSQLファイルとして実行して作成します。
ワークスペース・ユーティリティの、RESTソース・カタログを開きます。
タスクよりカタログ・グループの管理を開きます。RESTソース・カタログはカタログ・グループに所属する必要があります。カタログ・グループとしてOpenAIを作成し、作成するRESTデータ・ソースを所属させます。
グループの作成をクリックします。
名前はOpenAIとします。
作成をクリックします。
RESTカタログ・グループとしてOpenAIが作成されました。
RESTソース・カタログのページに戻ります。
タスクよりカタログのインポートをクリックします。
ダウンロードしたRESTソース・カタログのSQLファイルOpenAI Assistants API.sqlをインポートするファイルとして選択します。ファイル・タイプはRESTソース・カタログです。
次へ進みます。
すぐにインストールします。
次へ進みます。
カタログ・グループとしてOpenAIを選択します。
RESTカタログのインポートをクリックします。
RESTソース・カタログとしてOpenAI Assistants APIが作成されました。
以上で、APEXアプリケーションでRESTデータ・ソースとしてOpen AI Assistants APIのList assistants、List messages、List runsおよびOpenAI Files APIのList filesを作成する準備ができました。
新規にアプリケーションを作成します。名前はOpenAI Retrieval Assistantとします。
アプリケーションの作成をクリックします。
アプリケーションが作成されたら、共有コンポーネントのRESTデータ・ソースを開きます。
作成をクリックします。
RESTデータ・ソースの作成としてRESTソース・カタログからを選択します。
次へ進みます。
RESTソース・カタログのOpenAI Assistants APIの参照をクリックします。
List assistants、List messages、List runsのプラスをクリックして、作成するRESTデータ・ソースとして選択します。なお、List threadsのAPIはAssistants APIより削除されたか、仕様が変わったため利用できなくなった模様です。
選択が完了したら、次へ進みます。
RESTデータ・ソースの作成をクリックします。
RESTデータ・ソースとしてList assistants、List messages、List runsが作成されます。
同様の手順でOpenAI Files APIより、RESTデータ・ソースList filesを作成します。
以上でRESTデータ・ソースの作成は完了です。
アプリケーション定義の置換に、置換文字列としてG_OPENAI_API_KEYを設定します。置換値はOpenAIのAPIキーが設定されているWeb資格証明の静的IDです。
ファイルのアップロードと削除を行うページを作成します。
ページの作成をクリックします。
対話モード・レポートを選択します。
対話モード・レポートのページのページ番号は2、名前はFiles、ページ・モードは標準です。フォーム・ページを含めるをオンにし、フォーム・ページ番号は3、フォーム・ページ名はFile Detail、フォーム・ページ・モードはドロワーを指定します。
データ・ソースとしてRESTデータ・ソースを選び、RESTデータ・ソースとしてList filesを選択します。
ナビゲーションはデフォルトのまま変更せず、次へ進みます。
ページの作成をクリックします。
RESTデータ・ソースList filesをデータ・ソースとした対話モード・レポートとフォームのページが作成されます。
データ・ソースのList filesのデータベース操作は行のフェッチだけで、行の挿入、行の更新、行の削除は含まれていません。そのため、ページ作成ウィザードは作成、変更の適用、削除を実行するボタンやプロセスを生成していません。
作成されたページを実行します。
すでにアップロードされているファイルが存在すれば、対話モード・レポートに表示されます。
このページにファイルの作成（OpenAIへのアップロード）と削除の操作を追加します。
ページ・デザイナで対話モード・レポートのページを開きます。
対話モード・レポートのリージョンにボタンを作成します。このボタンはページ作成ウィザードによって作成されるものと同じ設定にします。
識別のボタン名はCREATE、ラベルは作成とします。レイアウトの位置として対話モード・レポートの検索バーの右を選択します。外観のホットはオンにします。
動作のアクションとしてこのアプリケーションのページにリダイレクトを選択し、ターゲットとしてページ3を設定します。
変更を保存します。
ページ・デザイナでフォームのページを開きます。
ページ・アイテムP3_BYTES、P3_OBJECT、P3_STATUS、P3_FILENAME、P3_CREATED_AT、P3_STATUS_DETAILSを選択します。これらは表示のみの値でユーザーから値を入力することはありません。サーバー側の条件のタイプとしてアイテムはNULLではない、アイテムとしてP3_IDを選択することで、ファイルの作成（アップロード）では表示されないようにします。
ページ・アイテムP3_PURPOSEを選択します。
識別のタイプをテキスト・フィールドに変更します。デフォルトのタイプを静的、静的値としてassistantsを設定します。アップロードするファイルの用途は、意識して変更しない限りRetrievalを用途とするassistantsを設定します。
アップロードするファイルを選択するページ・アイテムを作成します。
識別の名前はP3_FILE、タイプはファイルのアップロード、ラベルはFileとします。ストレージのタイプは表APEX_APPLICATION_TEMP_FILES、ファイルをパージするタイミングはリクエストの終わりです。セッション・ステートのストレージはリクエストごと(メモリー)とします。
このページにファイルの更新処理は実装しないため、ファイルを選択するのはファイルの作成時（アップロード時）に限られます。サーバー側の条件のタイプにアイテムはNULL、アイテムとしてP3_IDを指定することにより、アップロード処理以外ではページ・アイテムが表示されないようにします。
ファイルの作成と削除を実行するボタンを作成します。
ファイルの作成を行うボタンは、ボタン名をCREATEとします。設定は、ページ作成ウィザードによって作成されるボタンCREATEと同じ設定にします。
識別のラベルは作成、レイアウトの位置はCreate、外観のホットはオンにします。動作のアクションはページの送信、サーバー側の条件のタイプはアイテムはNULL、アイテムとしてP3_IDを選択します。
ファイルの削除を行うボタンは、ボタン名をDELETEとします。設定は、ページ作成ウィザードによって作成されるボタンDELETEと同じ設定にします。
識別のラベルは削除、レイアウトの位置はDelete、動作のアクションはページの送信、確認の要求をオンにします。確認のメッセージに「本当に削除しますか？」と記述します。サーバー側の条件のタイプはアイテムはNULLではない、アイテムとしてP3_IDを選択します。
ファイルのアップロードを行うプロセスは、識別の名前をUpload File、タイプとしてコードの実行を選択します。ソースのPL/SQLコードに以下を記述します。
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| declare | |
| l_file clob; | |
| begin | |
| for r in ( | |
| select * from apex_application_temp_files | |
| where name = :P3_FILE | |
| ) | |
| loop | |
| :P3_ID := utl_openai_files_api.upload_file( | |
| p_filename => r.filename | |
| ,p_content_type => r.mime_type | |
| ,p_file_content => r.blob_content | |
| ,p_purpose => :P3_PURPOSE | |
| ,p_credential_static_id => :G_OPENAI_API_KEY | |
| ,p_file => l_file | |
| ); | |
| end loop; | |
| end; |
成功メッセージは「ファイルがアップロードされました。」とします。サーバ側の条件のボタン押下時にCREATEを指定します。
以上で、OpenAIへのファイルのアップロードと削除を行うページは完成です。
ファイルの削除を行うプロセスは、識別の名前をDelete File、タイプとしてAPIの呼出しを選択します。設定のパッケージにUTL_OPENAI_FILES_APIを選びプロシージャまたはファンクションとしてDELETE_FILEを選択します。
成功メッセージは「ファイルが削除されました。」とします。サーバ側の条件のボタン押下時にDELETEを指定します。
パラメータファンクションの結果を選択し、パラメータの出力を無視をオンにします。
パラメータp_file_idを選択し、値のタイプはアイテム、アイテムとしてP3_IDを指定します。
パラメータp_credential_static_idを選択し、値のタイプはアイテム、アイテムとしてG_OPENAI_API_KEYを指定します。
パラメータp_fileを選択し、パラメータの出力を無視をオンにします。
パラメータp_credential_static_idに置換文字列G_OPENAI_API_KEYを設定すると、page item not foundというエラーが発生します。エラーは発生しますが、きちんと置換文字列はパラメータとして渡されます。Oracle APEX 23.2以前では発生していなかったと思うのですが、きちんと確認していません。
パラメータのタイプに静的値、静的値として&G_OPENAI_API_KEY.を設定すると、エラーの発生を回避できます。
アシスタントの作成と削除を行うページを作成します。
ファイルのときと同様に、対話モード・レポートのページの作成を始めます。
対話モード・レポートのページのページ番号は4、名前はAssistants、ページ・モードは標準です。フォーム・ページを含めるをオンにし、フォーム・ページ番号は5、フォーム・ページ名はAssistant Detail、フォーム・ページ・モードはドロワーを指定します。
データ・ソースとしてRESTデータ・ソースを選び、RESTデータ・ソースとしてList assistantsを選択します。
ナビゲーションはデフォルトのまま変更せず、次へ進みます。
ページの作成をクリックします。
ファイルのときと同様に、対話モード・レポートのリージョンに作成ボタンを作ります。
識別のボタン名はCREATE、ラベルは作成とします。レイアウトの位置として対話モード・レポートの検索バーの右を選択します。外観のホットはオンにします。
動作のアクションとしてこのアプリケーションのページにリダイレクトを選択し、ターゲットとしてページ5を設定します。
変更を保存します。
共有コンポーネントのLOVを開きます。
LOVの作成として最初からを選択します。
次へ進みます。
次へ進みます。
データ・ソースにRESTデータ・ソースを選び、RESTデータ・ソースとしてList filesを選択します。
次へ進みます。
戻り列としてID、表示列としてFILENAMEを選択します。
作成をクリックします。
同様の手順で、アシスタントのLOV、LOV_ASSISTANTSを作成します。
LOVの名前はLOV_ASSISTANTSとします。
RESTデータ・ソースとしてList assistantsを選択します。
戻り列としてID、表示列としてNAMEを選択します。
作成をクリックします。
ページ・デザイナでページ番号５のAssistant Detailのページを開きます。
ページ・アイテムP5_NAME、P5_MODEL、P5_OBJECTを選択し、識別のタイプをテキスト・フィールドに変更します。
ページ・アイテムP5_OBJECTとP5_CREATED_ATを選択し、サーバー側の条件のタイプにアイテムはNULLではない、アイテムとしてP5_IDを設定します。これらの値はユーザーが入力することはないためP5_IDがNULL、つまりアシスタントの作成時には表示しません。
アシスタントが使用するツールを設定するページ・アイテムを作成します。
識別の名前はP5_TOOLS、タイプはテキスト領域、ラベルはToolsとします。デフォルトのタイプに静的を選択し、静的値として以下を記述します。今回のアプリケーションはretrievalのみの使用を想定していますが、記述を変えることによりCode InterpreterやFunction Callingも呼び出せるようにしておきます。
[{"type":"retrieval"}]
セッション・ステートのストレージはリクエストごと(メモリーのみ)、アシスタントの作成時のみページ・アイテムが表示されるように、サーバー側の条件のタイプはアイテムはNULL、アイテムにP5_IDを指定します。
Retrievalが参照するファイル（Assistant Files）を選択するページ・アイテムを作成します。
識別の名前はP5_FILE_IDS、タイプはチェック・ボックス・グループ、ラベルはFile Idsとします。LOVのタイプとして共有コンポーネントを選択し、LOVに先ほど作成したLOV_FILESを選択します。追加値の表示はオフです。
セッション・ステートのストレージはリクエストごと(メモリーのみ)、アシスタントの作成時のみページ・アイテムが表示されるように、サーバー側の条件のタイプはアイテムはNULL、アイテムにP5_IDを指定します。
ページ・アイテムP5_MODELのデフォルトとして、タイプが静的、静的値としてgpt-4-1106-previewを設定します。ツールとしてRetrievalを使うための設定です。
ボタンCREATEとDELETEを作成します。これはファイルを操作するフォームでの手順と同じです。サーバー側の条件のアイテムとしてP3_IDの代わりにP5_IDを指定します。
アシスタントを作成するプロセスを作ります。
識別の名前はCreate Assistant、タイプとしてAPIの呼出しを選択します。設定のパッケージはUTL_OPENAI_ASSISTANTS_API、プロシージャまたはファンクションとしてCREATE_ASSISTANTを選択します。
成功メッセージは「アシスタントが作成されました。」とします。サーバー側の条件のボタン押下時にCREATEを指定します。
パラメータp_file_idsを選択します。ページ・アイテムP5_FILE_IDSはチェック・ボックス・グループであるため、選択したファイルのIDがコロンを挟んで連結された文字列になります。これをJSON配列に変換します。
値のタイプとしてファンクション本体を選択し、PL/SQLファンクション本体として以下を記述します。
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| declare | |
| l_array json_array_t; | |
| begin | |
| l_array := json_array_t(); | |
| for c in ( | |
| select column_value from apex_string.split(:P5_FILE_IDS,':') | |
| ) | |
| loop | |
| l_array.append(c.column_value); | |
| end loop; | |
| return l_array.to_clob(); | |
| end; |
パラメータp_credential_static_idの値のタイプは静的値、静的値は&G_OPENAI_API_KEY.とします。
パラメータp_responseはデバッグ用途なので、出力を無視をオンにします。
アシスタントを削除するプロセスを作成します。
識別の名前はDelete Assistant、タイプとしてAPIの呼出しを選択します。設定のパッケージはUTL_OPENAI_ASSISTANTS_API、プロシージャまたはファンクションとしてDELETE_ASSISTANTを選択します。
成功メッセージは「アシスタントが削除されました。」とします。サーバー側の条件のボタン押下時にDELETEを指定します。
パラメータp_assistant_idの値のアイテムとしてP5_IDを指定します。
パラメータp_credential_static_idの値のタイプは静的値、静的値は&G_OPENAI_API_KEY.とします。
パラメータp_credential_static_idにはすべて同じ設定を行うため、今後の説明は簡単にします。
パラメータファンクションの結果、p_response、p_object、p_deletedは、パラメータの出力を無視をオンにします。
以上で、OpenAIのアシスタントの作成と削除を行うページは完成です。
もっとも主要なページである、スレッドの作成とメッセージの作成および問合せの実行を行うページを作成します。
ファイルやアシスタントのときと同様に、対話モード・レポートのページの作成を始めます。
対話モード・レポートのページのページ番号は6、名前はMessages、ページ・モードは標準です。フォーム・ページを含めるをオンにし、フォーム・ページ番号は7、フォーム・ページ名はMessage Detail、フォーム・ページ・モードはドロワーを指定します。
データ・ソースとしてRESTデータ・ソースを選び、RESTデータ・ソースとしてList messagesを選択します。
ナビゲーションはデフォルトのまま変更せず、次へ進みます。
進んだ先で主キー列1のID (Varchar2)を選択し、ページの作成をクリックします。
メッセージを扱う対話モード・レポートとフォームのページが作成されます。
スレッドの作成および削除、メッセージの作成、スレッドの実行、実行の確認、アシスタントが生成したメッセージの表示といった、今回作成するアプリケーションの主要な処理を、これらのページに実装します。
ページ・デザイナでページ番号６の対話モード・レポートのページを開きます。
識別の名前はP6_ASSISTANT_ID、タイプは選択リスト、ラベルはAssistantとします。検証の必須の値はオンです。
LOVのタイプとして共有コンポーネントを選択し、LOVとして先ほど作成したLOV_ASSISTANTSを選びます。追加値の表示はオフ、NULL値の表示をオンとして、NULL表示値に- アシスタントを選択 -と記述します。
セッション・ステートのストレージはページを遷移した後でも値が維持されるように、セッションごと(永続)を選択します。
スレッドの作成と削除を行うボタンとスレッドIDを保持するページ・アイテムを載せるリージョンを作成します。以前はOpenAIのAssistants APIにList threadsがあり、作成済みのスレッドIDをAPIを呼び出して取り出せたのですが、そのAPIが無くなったため、代わりにスレッドIDをページ・アイテムに保持します。
リージョンを作成し、ページ・アイテムP6_ASSISTANT_IDの下に配置します。
識別のタイトルをThread、タイプは静的コンテンツとします。外観のテンプレートとしてItem Containerを選択します。設定しなくても良いですが、ボタンとページ・アイテムの見栄えを良くするために、テンプレート・オプションを開きAlignmentにCenterを選択します。
識別のボタン名はCREATE_THREAD、ラベルはスレッド作成とします。レイアウトのリージョンにThreadを選択し、位置はButton Startとします。動作のアクションはデフォルトのページの送信です。
タイプが静的コンテンツのリージョンでテンプレートにItem Containerを選択すると、直接リージョンにボタンやページ・アイテムを作成することができません。一旦、Body直下にボタンやページ・アイテムを作成した後、レイアウトのリージョンとしてItem Containerのリージョンを設定する必要があります。
作成したスレッドIDを保持するページ・アイテムを作成します。
識別の名前はP6_THREAD_ID、タイプはテキスト・フィールド、ラベルはThread IDとします。レイアウトのリージョンにThreadを選択し、位置はItemとします。
セッション・ステートのストレージはページを遷移した後でも値が維持されるように、セッションごと(永続)を選択します。
スレッドを削除するボタンを作ります。
作成したスレッドはアプリケーション側で管理し、使わなくなったら削除する必要があります。今回のアプリケーションでは、利用者がスレッドの削除を実行します。使われなくなったスレッドの自動削除といった、ハウスキーピングの機能は実装していません。
識別のボタン名はDELETE_THREAD、ラベルはスレッド削除とします。レイアウトのリージョンにThreadを選択し、位置はButton Endとします。動作のアクションはデフォルトのページの送信です。
確認の要求をオンにし、確認のメッセージとして「本当に削除しますか？」と記述します。
対話モード・ポートのリージョンMessagesを選択します。メッセージの一覧を取得するには、Thread IDの指定が必要です。
ソースの送信するページ・アイテムにP6_THREAD_IDを指定します。サーバー側の条件のタイプにアイテムはNULLではないを選択し、アイテムにP6_THREAD_IDを指定します。
対話モード・レポートのパラメータのthread_idを選択し、値のタイプにアイテム、アイテムにP6_THREAD_IDを指定します。
スレッドの実行を一覧する対話モード・レポートを作成します。
リージョンMessagesを重複させ、識別のタイトルをRuns、RESTソースをList runsに変更します。
スレッドを実行するボタンを作成します。作成したボタンはリージョンThreadの下に配置します。
識別のボタン名はRUN、ラベルは実行とします。外観のホットをオンにし、テンプレート・オプションのWidthはStretchとします。
スレッドに紐づいたメッセージと実行の一覧（対話モード・レポート）を更新するボタンを作成します。作成したボタンはボタンRUNの下に配置します。
識別のボタン名はREFRESH、ラベルはリフレッシュとします。テンプレート・オプションのWidthはStretchとします。
動作のアクションとして動的アクションで定義を選択します。
動的アクションの識別の名前はRefresh Messages and Runsとします。タイミングはボタンのデフォルトで、イベントはクリック、選択タイプはボタン、ボタンはREFRESHになります。
TRUEアクションとしてリフレッシュを選択し、影響を受ける要素の選択タイプにリージョン、リージョンとしてMessagesを指定します。
同様にリージョンRunsをリフレッシュするTRUEアクションを作成します。作成済みのTRUEアクションを重複させ、影響を受ける要素のリージョンをRunsに変更するとよいでしょう。
メッセージを新規に作成するボタンを、リージョンMessagesに作ります。
識別の名前はCREATE、ラベルはメッセージ作成とします。レイアウトの位置として、対話モード・レポートの検索バーの右を選択します。外観のホットをオンにします。
動作のアクションとしてこのアプリケーションのページにリダイレクトを選択します。
ターゲットをリンク・ビルダーで開き、ページとして7、アイテムの設定の名前にP7_THREAD_ID、値に&P6_THREAD_ID.を設定します。
OpenAIのAssistants APIでメッセージを作成するには、スレッドが必要です。
リージョンMessagesを選択し、プロパティ・エディタの属性を開きます。
リンクのターゲットをリンク・ビルダーで開きます。
アイテムの設定に、名前としてP7_THREAD_ID、値に\&P6_THREAD_ID.\を追加します。
ページの表示上の設定は以上で完了です。これからプロセスの作成を行います。
左ペインでプロセス・ビューを開きます。
スレッドを作成するプロセスを作成します。
識別の名前はCreate Thread、タイプはAPI呼出しです。設定のパッケージとしてUTL_OPENAI_ASSISTANTS_API、プロシージャまたはファンクションとしてCREATE_THREADを指定します。成功メッセージとして「スレッドが作成されました。」を記述します。
サーバー側の条件のボタン押下時にCREATE_THREADを指定します。
p_credential_static_idは静的値の&G_OPENAI_API_KEY.とします。p_responseの出力は無視します。この設定はパッケージUTL_OPENAI_ASSISTANTS_APIのAPI呼出しで共通です。
スレッドを削除するプロセスを作成します。
識別の名前はDelete Thread、タイプはAPI呼出しです。設定のパッケージとしてUTL_OPENAI_ASSISTANTS_API、プロシージャまたはファンクションとしてDELETE_THREADを指定します。成功メッセージとして「スレッドが削除されました。」を記述します。
サーバー側の条件のボタン押下時にDELETE_THREADを指定します。
スレッドを実行するプロセスを作成します。
識別の名前はCreate Run、タイプはAPI呼出しです。設定のパッケージとしてUTL_OPENAI_ASSISTANTS_API、プロシージャまたはファンクションとしてCREATE_RUNを指定します。成功メッセージとして「スレッドの実行を開始しました。」を記述します。
サーバー側の条件のボタン押下時にRUNを指定します。
パラメータファンクションの結果とp_responseを選択し、出力を無視をオンにします。
パラメータp_model、p_instructions、p_tools、p_metadataはAPIデフォルトのまま変更しません（結果としてP6_ASSISTANT_IDとして指定されたアシスタントの設定が使用されます）。これらのパラメータも変更は不要です。
スレッドを削除した時にセッション・ステートをクリアするプロセスを作成します。
パラメータp_credential_static_idの値は、静的値の&G_OPENAI_API_KEY.とします。
識別の名前をClear Session State after Deleteとします。タイプとしてセッション・ステートのクリアを選択します。設定のタイプとして現在のページのすべてのアイテムのクリアを選択します。ページ・アイテムP6_ASSISTANT_IDとP6_THREAD_IDが未設定の状態になります。
サーバー側の条件のボタン押下時にDELETE_THREADを指定します。
メッセージの作成と表示をページ番号７のフォームのページに実装します。
ページ・デザイナでページ番号７のフォームのページを開きます。
RESTデータ・ソースのデータ・プロファイルの設定により、ページ・アイテムP7_ROLE、P7_OBJECT、P7_RUN_ID、P7_THREAD_ID、P7_ASSISTANT_IDのタイプがテキスト領域になっています。
これらのページ・アイテムをすべて選択し、タイプをテキスト・フィールドに変更します。
ページ・アイテムP7_ROLEに計算を作成し、デフォルトの値をuserにします。
ページ・アイテムP7_ROLEに作成した計算の、計算のタイプに静的値を選択し、静的値としてuserを指定します。サーバー側の条件のタイプとしてアイテムはNULLを選択し、アイテムにP7_ROLEを指定します。実行のポイントがリージョンの前であることを確認します。
これでページ・アイテムP7_ROLEに値が未設定の場合は、値がuserになります。
ページ・アイテムP7_OBJECT、P7_RUN_ID、P7_CREATED_AT、P7_ASSISTANT_IDは、作成済みのメッセージに含まれる値であり、メッセージ作成時の引数にはなりません。
そのため、これらのページ・アイテムを選択し、サーバー側の条件のタイプとしてアイテムはNULLではないを選択し、アイテムとしてP7_IDを指定します。
メッセージ（Messageオブジェクト）のcontentに含まれるtext部分を表示するページ・アイテムを作成します。OpenAIのアシスタントが、Markdownのメッセージを返すことを想定しています。
識別の名前はP7_TEXT、タイプはMarkdownエディタ、ラベルはTextとします。用途は表示のみなので、設定のツールバーはなし、構文の強調表示もなしとします。
セッション・ステートのデータ型としてCLOBを選択し、ストレージはリクエストごと(メモリーのみ)とします。
サーバー側の条件のタイプとしてアイテムはNULLではないを選択し、アイテムとしてP7_TEXTを指定します。表示すべきデータがあるときに限り、ページ・アイテムP7_TEXTを表示します。
メッセージのcontentを入力するページ・アイテムを作成します。メッセージを作成するときは、単純な文字列として扱います。メッセージを表示するときは、MessageオブジェクトのcontentはJSONドキュメントとして返されるため、JSONのまま表示します。
識別の名前はP7_CONTENT、タイプはテキスト領域、ラベルはContentとします。
セッション・ステートのデータ型としてCLOBを選択し、ストレージはリクエストごと(メモリーのみ)とします。
レンダリング前のヘッダー前にあるプロセス初期化フォームMessage Detailを、OpenAI Assistants APIのRetrieve Messageを呼び出してメッセージの内容を取得するように変更します。
プロセス初期化フォームMessage Detailを選択します。
タイプをAPIの呼出しに変更します。設定のパッケージとしてUTL_OPENAI_ASSISTANTS_APIを選択し、プロシージャまたはファンクションとしてRETRIEVE_MESSAGEを指定します。
サーバー側の条件のタイプとしてアイテムはNULLではないを選択し、アイテムとしてP7_IDを指定します。
パラメータp_message_idの値のタイプをアイテム、アイテムとしてP7_IDを指定します。
パラメータp_credential_static_idの値は、静的値の&G_OPENAI_API_KEY.とします。
contentとして返されるJSONドキュメントをプリティ・プリントするプロセスを作成します。プロセスを作成し、初期化フォームMessage Detailの下に配置します。
識別の名前はContent Pretty Print、タイプはコードを実行とします。ソースのPL/SQLコードとして以下を記述します。
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| declare | |
| l_raw_json clob; | |
| l_pretty_output clob; | |
| begin | |
| l_raw_json := :P7_CONTENT; | |
| select json_serialize( | |
| l_raw_json returning clob pretty | |
| ) into l_pretty_output | |
| from dual; | |
| :P7_CONTENT := l_pretty_output; | |
| end; |
サーバー側の条件のタイプとしてアイテムはNULLではないを選択し、アイテムとしてP7_CONTENTを指定します。
メッセージのcontentの内容からtextを取り出すプロセスを作成します。作成したプロセスは、プロセスContent Pretty Printの下に配置します。
識別の名前はRetrieve Text From Content、タイプはコードを実行とします。ソースのPL/SQLコードとして以下を記述します。
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| declare | |
| l_contents json_array_t; | |
| l_content json_object_t; | |
| l_text_json json_object_t; | |
| l_text clob; | |
| begin | |
| l_contents := json_array_t(:P7_CONTENT); | |
| for i in 1..l_contents.get_size() | |
| loop | |
| l_content := treat(l_contents.get(i-1) as json_object_t); | |
| if l_content.get_string('type') = 'text' then | |
| l_text_json := l_content.get_object('text'); | |
| l_text := l_text || l_text_json.get_string('value'); | |
| end if; | |
| end loop; | |
| :P7_TEXT := l_text; | |
| end; |
サーバー側の条件のタイプとしてアイテムはNULLではないを選択し、アイテムとしてP7_CONTENTを指定します。
ページ作成ウィザードでソースとして指定したRESTデータ・ソースには、作成にあたるデータベース操作が実装されていないため、フォームに作成ボタンが作られていません。作成をボタンをフォームに作成します。
識別のボタン名はCREATE、ラベルは作成とします。レイアウトのリージョンはボタン、位置はCreateとします。外観のホットをオンにします。
動作のアクションはデフォルトのページの送信です。
サーバー側の条件のタイプとしてアイテムはNULLを選択し、アイテムとしてP7_IDを指定します。
ボタンを押した時に実行される、メッセージを作成するプロセスを作成します。
プロセス・ビューを開き、プロセスを作成します。作成したプロセスはダイアログを閉じるの上に配置します。
識別の名前はCreate Message、タイプはAPIの呼出しとします。設定のパッケージとしてUTL_OPENAI_ASSISTANTS_APIを選択し、パッケージまたはファンクションとしてCREATE_MESSAGEを指定します。成功メッセージとして「メッセージが作成されたした。」と記述します。
サーバー側の条件のボタン押下時にCREATEを指定します。
パラメータp_thread_id、p_role、p_contentにはそれぞれデフォルトで、ページ・アイテムP7_THREAD_ID、P7_ROLE、P7_CONTENTが割り当たります。パラメータp_file_ids、p_metadataはAPIデフォルトとする（つまり無指定）ため、変更は不要です。
パラメータp_credential_static_idの値として、静的値の&G_OPENAI_API_KEY.を設定し、パラメータp_responseの出力は無視します。
以上で、OpenAIのAssistants APIを呼び出しRetrievalを実行するAPEXアプリケーションは完成です。
Oracle APEXのアプリケーション作成の参考になれば幸いです。
完
