生成AIエージェントのためのOracle Databaseガイドライン

生成AIエージェントはデータベースを管理しないため、生成AIエージェントがデータベースに接続できるように既存のデータベースを設定する必要があります。次の要件

データベース表

次のフィールドを使用してOracle Database 23ai表を作成します。

必須フィールド

• DOCID: 各レコードまたはドキュメントに割り当てられたID
• BODY: エージェントで検索する実際のコンテンツ
• VECTOR: bodyコンテンツに基づいて埋込みモデルから生成されるベクトル

オプションのフィールド

• CHUNKID: チャンク化されたドキュメントのID。ドキュメントが512トークンより大きい場合。
• URL: コンテンツのURL参照(使用可能な場合)。
• TITLE: bodyコンテンツのタイトル

ヒント

OCI生成AIでテキスト埋込みを作成できます。

データベース関数

ファンクションは、パラメータを取ることができ、値を戻すサブプログラムです。各問合せからベクトル検索結果を返すことができるデータベース関数を設定する必要があります。要件は次のとおりです。

入力パラメータ

• p_query: 問合せ文字列
• top_k: 最上位結果の数

戻り型

• SYS_REFCURSOR

要件

• 関数の問合せフィールドに使用する埋込みモデルは、表のBODYコンテンツをベクトル埋込みに変換する埋込みモデルと同じである必要があります。

• ファンクションの戻りフィールドは、表の必須フィールド(DOCID、BODYおよびSCORE)およびオプション・フィールド(CHUNKID、TITLEおよびURL)と一致する必要があります。

  BODYコンテンツは埋込みモデルによって処理され、各コンテンツに対してVECTORが生成されます。この関数は、問合せベクトルと各VECTORの間の距離を計算し、top_k行を返します。SCOREフィールドは、問合せベクトルとBODYのVECTORの間の距離を表します。

• ファンクションの戻りフィールド名が表フィールド名と一致しない場合は、ファンクションの別名を使用する必要があります。

例

次に、データベース関数の例を示します。

create or replace FUNCTION RETRIEVAL_FUNC (p_query IN VARCHAR2,top_k IN NUMBER) RETURN SYS_REFCURSOR IS
    v_results SYS_REFCURSOR;
    query_vec VECTOR;
BEGIN
    query_vec := dbms_vector.utl_to_embedding(
        p_query,
        json('{
            "provider": "OCIGenAI",
            "credential_name": "OCI_VECTOR_CREDENTIAL",
            "url": "https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText",
            "model": "cohere.embed-english-v3.0"
        }')
    );

    OPEN v_results FOR
        select l.id as DOCID, lv.chunk_id as CHUNKID, l.file_name as TITLE, 
        'https://objectstorage.us-chicago-1.oraclecloud.com/n/{namespace}/b/{bucket_name}/o/' || l.file_name as URL,
        lv.chunk_txt as BODY, vector_distance(embed_vector, query_vec) AS SCORE
        from legislation_vector lv, legislation l
        where l.id = lv.id
        order by SCORE 
        fetch first top_k rows only;

    RETURN v_results;
END;

次に、ネットワークに関する高度なガイドラインを示します。

ネットワーキング要件

• OCIの仮想クラウド・ネットワーク(VCN)のプライベート・サブネットにデータベースを追加します。
• サブネットのイングレス・ルールの次のプロパティを設定します:
  • ソース・タイプ: CIDR
  • ソースCIDR: VCNのIPv4 CIDRブロック(10.0.0.0/16など)
  • IPプロトコル: TCP
  • ソース・ポート範囲: すべて
  • 宛先ポート範囲: 1521-1522

セキュリティ要件

• Vaultの作成: データベースのシークレットを保存します。
• ボールトをデータベースと同じコンパートメントに作成します。

データベース・ツール・サービスを使用して、OCI内のOracleデータベースへの再利用可能な接続を作成できます。データベースの接続を作成するには、次のガイドラインに従います。