生成AIエージェント用のRAGツールのOracle Databaseガイドライン

生成AIエージェントのデータ・オプションとしてOracle Databaseバージョン23aiベクトル・ストアを使用する前に、サポートされている内容を理解し、必要なタスクを完了してください。

データベース・タイプ

生成AIエージェントは、次からのBYOベクトル埋込みをサポートしています。

• Oracle Base Database 23ai: データベースはプライベート・ネットワーク上に構成できます。DB Systemの作成を参照してください。

• 次のネットワーク・アクセス・タイプのOracle Autonomous Database 23aiのみ:

  • プライベート・エンドポイント・アクセスのみ: データベースへの接続を認証するために相互TLS (mTLS)認証を有効にできます。mTLS認証を有効にするには、「相互TLS (mTLS)認証が必要」チェック・ボックスを選択します。

  • すべての場所からのセキュア・アクセス: mTLS認証はデフォルトで有効になっており、必須です。

  Autonomous Databaseインスタンスの作成を参照してください。

mTLS認証で有効化されたAutonomous Databases

自律型データベースでmTLS認証が有効になっている場合は、ウォレットをダウンロードし、ウォレット・パスワードを作成し、ウォレットからファイルを抽出する必要があります。ステップ3のWalletのセキュリティ要件を参照してください。ネットワークおよびセキュリティ要件を構成します。

リージョン間およびクロステナンシ・データベースのサポート

クロスリージョンおよびクロステナンシ・データベースのサポートは、プライベート・ネットワーク・アクセスを使用するOracle Database 23aiでのみ使用できます。これには、ネットワーク・アクセス・タイププライベート・エンドポイント・アクセスのみで構成されたOracle Base DatabaseおよびOracle Autonomous Databaseが含まれます。パブリック・アクセスを持つ自律型データベースはサポートされません。

ホスト・リージョンで生成AIエージェントを使用する場合、次の場所にあるプライベート・アクセス・データベースに接続できます:

• 同じテナンシ内の別のリージョン。エージェント・サービスが使用可能なリージョンでデータベース・ツール接続を作成して、接続を有効にします。
• 別のテナンシエージェント・サービスが使用可能なテナンシにデータベース・ツール接続を作成して、接続を有効にします。

ネットワーク設定を設定するには、ステップ3のネットワーキング要件(クロスリージョンおよびクロステナンシ・データベース)を参照してください。ネットワークおよびセキュリティ要件を構成します。

接続を作成するには、ステップ5の説明に従って、接続文字列を手動で入力します。データベース・ツール接続の作成。

「サービスを使用する前にポリシーを追加」の説明に従って、すべての生成AIエージェント・リソースへのアクセス権をユーザーに付与するだけでなく、ボールト・シークレットおよびデータベース・ツールへのアクセス権を持つ動的グループを作成する必要があります。

1. 動的グループを作成し、次の一致ルールを追加します。

   ALL {resource.type='genaiagent'}

   ヘルプが必要な場合は、動的グループの作成を参照してください。

2. 動的グループに権限を付与します。

   • デフォルト・アイデンティティ・ドメインで使用できる次のポリシーを記述します。

     allow dynamic-group <dynamic-group-name> 
     to read database-tools-family in compartment <compartment-name>
     
     allow dynamic-group <dynamic-group-name> 
     to read secret-bundle in compartment <compartment-name>
     

   • Oracle Identity Cloud Service (IDCS)ドメイン名および動的グループ名を指定して、デフォルトではないアイデンティティ・ドメインで次のポリシーを使用します:

     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to read database-tools-family in compartment <compartment-name>
     
     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to read secret-bundle in compartment <compartment-name>
     

allow any-user to read database-tools-family in compartment <compartment-name> where any {request.principal.type='genaiagent'}

allow any-user to read secret-bundle in compartment <compartment-name> where any {request.principal.type='genaiagent'}

必要なリソースがまだ構成または作成されていない場合は、これらのタスクを実行します。

ネットワーキング要件

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

ネットワーク要件(クロスリージョンおよびクロステナンシ・データベース)

次の要件は、プライベート・ネットワーク・アクセスを使用するOracle Database 23aiにのみ適用されます。これには、ネットワーク・アクセス・タイププライベート・エンドポイント・アクセスのみで構成されたOracle Base DatabaseおよびOracle Autonomous Databaseが含まれます。パブリック・アクセスを持つ自律型データベースはサポートされません。

ネットワーク設定

• 重複しないCIDRを使用して2つのVCNsを設定します。ネットワーク設定を構成するには、リモートVCNピアリングを参照してください。
• データベースのVCNで、データベース・ポート1521-1522にアクセスするためのデータベース・ツール接続VCN CIDRのイングレス・ルールを追加していることを確認します。

クロスリージョン・データベースの例: 生成AIエージェント・サービスが実行されているリージョンとは異なるリージョンにあるデータベースに接続できます。たとえば:

• エージェント・サービスは、ORDリージョンのテナンシAで実行されています。

• プライベート・ネットワーク・アクセスを持つOracleベース・データベースまたはOracle Autonomous Databaseは、PHXリージョンにデプロイされます。

• プライベート・データベースにアクセスするには、両方のリージョンで動的ルーティング・ゲートウェイ(DRG)を構成し、ORDにデータベース・ツール接続を設定してPHXのデータベースに接続します。

クロステナンシ・データベースの例: 生成AIエージェント・サービスとは別のテナンシにあるデータベースに接続できます。たとえば:

• エージェント・サービスは、ORDリージョンのテナンシAで実行されています。

• プライベート・ネットワーク・アクセスを持つOracleベース・データベースまたはOracle Autonomous Databaseは、PHXリージョンのテナンシBにデプロイされます。

• プライベート・データベースにアクセスするには、両方のテナンシで動的ルーティング・ゲートウェイ(DRG)を構成し、テナンシA (ORDリージョン)でデータベース・ツール接続を設定して、テナンシB (PHXリージョン)のデータベースに接続します。

クロステナンシ・ネットワーキング構成は、データベース・サービスとエージェント・サービスが同じリージョンにあるか、異なるリージョンにあるかにかかわらず適用されます。

Vaultのセキュリティ要件

OCI Vaultのボールトは、データベースのシークレット(データベースへのパスワードなど)を格納するために必要です。ボールトをデータベースと同じコンパートメントに作成します。

1. Create a vault.
2. マスター暗号化キーを作成します。
3. ボールトで、データベース・パスワードにシークレットを作成します。

Walletのセキュリティ要件

自律型データベースでmTLS認証が有効になっている場合は、次のタスクを実行します:

1. ウォレットをダウンロードして、ウォレット・パスワードを作成します。クライアント資格証明(ウォレット)のダウンロードを参照してください。
2. ダウンロードしたウォレットzipから、ファイルewallet.p12を抽出して脇に置きます。データベース・ツール接続を作成するには、PKCS#12ウォレットが必要です。

生成AIエージェントで使用するために作成したデータベースで、特定の必須フィールドを含むデータベース表を作成し、問合せからベクトル検索結果を返すデータベース関数を設定します。

データベース表

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

必須フィールド

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

オプションのフィールド

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

ヒント

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のOracleデータベースへの再利用可能な接続を作成できます。

データベースの接続を作成するには、次のガイドラインに従います。