著者は、Ask Oracle Select AI Chatbotを自社構築のOracle AI Database 26aiに導入し、基本的な自然言語の質問機能がスムーズに動作することを確認しました。この記事では、導入プロセス、主要な構成、および導入を試してみたい読者の参考のために遭遇する落とし穴を記録します。なお、今回は基本的な質問のみを検証しており、その他の高度な機能については未検証です。
01 |環境と前提
前提条件は比較的単純です。Oracle 26ai がインストールされており、独立したユーザーが作成されています。 ask_oracle 解析スキーマとして。今回のデプロイ環境は、Oracle APEX 26.1 上で実行される Oracle AI Database 26ai 23.26.2 です。
02 | APEXアプリケーションをインポートする
アプリケーションを APEX にインポートし、ウィザードに従ってインストールを選択し、インストールを完了します。
インストールが完了したら、APEX アカウントを使用してログインと管理者の構成を完了し、 DBMS_CLOUD、DBMS_CLOUD_AI およびその他の権限設定。
03 |モデルとプロファイルの構成
モデルは、LiteLLM を介して OpenAI 互換サービスに接続されます。キー構成は次のとおりです。
- 提供者：openai
- 資格情報：LITELLM_CRED
- オブジェクトリストモード：すべて
- 温度：0
- 最大トークン数：4096
- オブジェクトリストの適用：true
SH サンプル データはスキーマにまたがります。これらのテーブルはフロントエンド セレクターには表示されないため、オブジェクト リストに手動で入力する必要があります。
SH.SALES
SH.CUSTOMERS
SH.PRODUCTS
SH.TIMES
SH.CHANNELS
SH.PROMOTIONS
SH.COUNTRIES
04 |ネットワークACL設定
Oracle は次のように LiteLLM にアクセスする必要があります。 ASK_ORACLE ネットワーク ACL を構成します。
BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => 'litellm.example.internal',
lower_port => 443,
upper_port => 443,
ace => XS$ACE_TYPE(
privilege_list => XS$NAME_LIST(
'http',
'http_proxy'
),
principal_name => 'ASK_ORACLE',
principal_type => XS_ACL.PTYPE_DB
)
);
END;
/
05 |発生した問題
導入中に発生するいくつかの典型的な問題:
- アプリケーションが誤ってエージェント モードを選択し、エージェント チームが選択されていないことを示すメッセージが表示されます。 NL2SQL に切り替えて、正しいプロファイルを選択するだけです。
- Oracle は LiteLLM にアクセスできません。のために
ASK_ORACLEネットワーク ACL を設定すると、問題は解決します。 - HTTP エンドポイントはプロファイルを作成できません。代わりに HTTPS エンドポイントを使用してください。
- オブジェクト リストでは SH テーブルを参照できません。これはフロントエンドセレクターの制限であり、手動入力です
SH.TABLE_NAMEそれでおしまい。 - ORA-01403 は複雑なクエリで発生することがあります。合格
showprompt、showsqlLiteLLMログで階層的に確認し、最終的には正常に戻りました。
SELECT DBMS_CLOUD_AI.GENERATE(
prompt => '按销售渠道统计销售总额，按销售总额从高到低排列',
profile_name => 'SH_NL_ALFRED',
action => 'showprompt'
) AS constructed_prompt
FROM dual;
06 |最初の感情
Select AI と APEX の統合は比較的完全で、自然言語クエリ、SQL 生成、結果表示を迅速に実現できます。 ADB と比較すると、自己構築環境にはウォレット、ACL、HTTPS、および一部の ADB 固有の機能の追加処理が必要ですが、コアとなるチャット、NL2SQL、RAG、およびエージェントの機能には実装の基盤があります。
私に従ってAIと一緒に成長してください~
