CREATE_PROFILEプロシージャ

このプロシージャは、自然言語プロンプトをSQL文に変換するための新しいAIプロファイルです。

DISABLE_PROFILEプロシージャ

この手順では、現在のデータベースのAIプロファイルを無効にします。

DROP_PROFILEプロシージャ

この手順では、既存のAIプロファイルを削除します。

ENABLE_PROFILEプロシージャ

この手順により、AIプロファイルを現在のデータベースで使用できます。

GENERATEファンクション

SET_ATTRIBUTEプロシージャ

この手順では、AIプロファイル属性を設定します。

SET_PROFILEプロシージャ

このプロシージャは、現在のデータベースのAIプロファイルを設定します。

profile_name

AIプロファイルの名前。プロファイル名は、Oracle SQL識別子のネーミング・ルールに従う必要があります。プロファイル名の最大長は125文字です。

これは必須パラメータです。

attributes

JSON形式のプロファイル属性。詳細は、AIのプロファイル属性を参照してください。

デフォルト値はNULLです。

プロファイルのステータス。

デフォルトは「有効化」です。

description

AIプロファイルの説明。

デフォルト値はNULLです。

profile_name

AIプロファイルの名前

force

TRUEの場合、AIプロファイルが存在しない場合、プロシージャはエラーを無視します。

このパラメータのデフォルト値はFALSEです。

profile_name

有効にするAIプロファイルの名前

このパラメータは必須です。

profile_name

AIプロファイルの名前。

このパラメータは必須です。

profile_name

属性を設定するAIプロファイルの名前。

このパラメータは必須です。

attribute_name

AIプロファイル属性の名前

このパラメータは必須です。

attribute_value

プロファイル属性の値。

デフォルト値はNULLです。

profile_name

現在のセッションのAIプロファイルの名前。

このパラメータは必須です。

prompt

AIを使用して翻訳する自然言語プロンプト。

プロンプトには、接頭辞としてSELECT AI <action>を含めることができます。アクションは、アクション・パラメータとして個別に指定することもできます。プロンプトに指定されたactionは、actionパラメータをオーバーライドします。デフォルトのアクションはshowsqlです。

このパラメータは必須です。

profile_name

AIプロファイルの名前。AIプロファイルがすでに DBMS_CLOUD_AI.SET_PROFILEを使用してセッションで設定されている場合、このパラメータはオプションです。

デフォルト値はNULLです。

EXEC DBMS_CLOUD_AI.set_profile('OPENAI');

-----------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'showsql')
FROM dual;

------------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'how many customers',
                              profile_name => 'OPENAI',
                              action       => 'narrate')
FROM dual;
-------------------------------------------
SELECT DBMS_CLOUD_AI.GENERATE(prompt       => 'what is oracle autonomous database',
                              profile_name => 'OPENAI',
                              action       => 'chat')
FROM dual;

AIを使用して自然プロンプトを翻訳するための処理。サポートされているアクションには、showsql (デフォルト)、narrateおよびchatがあります。アクションの説明は、「AIキーワードを使用したプロンプトの入力」に記載されています。

ORA-20000: runsql action is not supported by generate function ORA-06512: at "C##CLOUD$SERVICE.DBMS_CLOUD", line xxxx 
ORA-06512: at "C##CLOUD$SERVICE.DBMS_CLOUD_AI", line 2696 ORA-06512: at line x

Azure OpenAI Serviceデプロイ済モデルの名前。名前には、英数字、アンダースコア(_)およびハイフン(-)のみを使用できます。名前の末尾にアンダースコア(_)またはハイフン(-)は使用できません。azure_deployment_nameの取得方法については、Azure OpenAIサービス・リソースの作成とデプロイを参照してください。

Azure OpenAIサービス・リソースの名前。リソース名には英数字とハイフンのみを含めることができ、ハイフンで開始または終了することはできません。azure_resource_nameの取得方法については、Azure OpenAIサービス・リソースの作成とデプロイを参照してください。

comments

AIを使用した自然言語プロンプトの翻訳に使用されるメタデータに列コメントを含めます。BOOLEANデータ型がサポートされています。VARCHAR2データ型の文字列の有効な値は、TRUEまたはFALSEです。

credential_name

AIプロバイダAPIにアクセスするための資格証明の名前。

Bearerトークンを使用する資格証明は、ユーザー名としてプロバイダ名を使用し、パスワードとしてBearerトークンを使用して作成できます。

この属性は必須です。CREATE_CREDENTIALプロシージャを参照してください。

max_tokens

生成ごとに予測するトークンの数を示します。デフォルトは1024です。詳細は、BPEトークンを参照してください。

model

翻訳の生成に使用されるAIモデルの名前。

サポートされているモデル:

• OpenAIの場合: gpt-4、gpt-4-0613、gpt-4-32k、gpt-4-32k-0613、gpt-3.5ターボ(デフォルト)、gpt-3.5-turbo-0613、gpt-3.5-turbo-16k、gpt-3.5-turbo-16k-0613
• Cohere: command (デフォルト)、command-nightly (実験的)、command-light、およびcommand-light-nightly (実験的)の場合。小さい「軽い」モデルはより速く、大きいモデルはよりよく実行されます。カスタム・モデルには、完全なIDを指定することもできます。

object_list

SQLへの自然言語変換に適格な所有者名およびオブジェクト名を指定するJSONオブジェクトの配列。特定のユーザーのすべてのオブジェクトを含めるには、nameを省略し、JSONオブジェクトでownerキーのみを指定します。

自然言語からSQLへの変換では、オブジェクト名、オブジェクト所有者、オブジェクト列およびコメントがHTTPSリクエストを使用してAIプロバイダに送信されます。オブジェクト・リストに機密オブジェクト名、列名またはコメントを含むオブジェクトを指定しないでください。

AIプロバイダは、翻訳リクエストで許可されるメタデータのサイズに制限がある場合があります。アプリケーション・ユーザーによる自然言語プロンプトに適したオブジェクトのリストを制限することを検討してください。

[
  {"owner": "SH", "name": "SALES",
  {"owner": "TEST_USER"}
]

provider

AIプロファイルのAIプロバイダ。

サポートされているプロバイダ:

• オセアニア
• くっ付く
• アザー

この属性は必須です。

stop_tokens

生成されたテキストは、最も早い停止シーケンスの先頭で終了します。シーケンスはテキストに組み込まれます。属性値は、JSON形式の文字列値の有効な配列である必要があります。stop_tokensは、入力としてJSON配列を取ります。停止トークンまたは停止シーケンスについてさらに学習するには、OpenAIまたはCohereのドキュメントを参照してください。

temperature

生成モデルからのサンプリングにはランダム性が組み込まれているため、「生成」をクリックするたびに同じプロンプトで異なる出力が生成される場合があります。温度は、ランダム性の度合いを調整するために使用される負でない浮動小数点数です。温度が低いほど、ランダムな世代が少なくなります。詳細は、温度を参照してください。このパラメータは、サポートされているすべてのサービス・プロバイダに適用されます。