Essbaseに質問の構成

Oracle Essbase環境内でシームレスなAI駆動型問合せを行うために、Essbaseに質問を効率的に構成、アクティブ化および管理するには、次の手順を使用します。

前提条件

  • Marketplaceデプロイメント: カタログ・ストレージ・タイプオブジェクト・ストレージ・バケットに設定されていることを確認します。

ノート:

Essbaseに質問は、Marketplaceデプロイメントでデフォルトで有効になっています。すべてのユーザーが問合せを送信できますが、その設定を構成できるのは管理ユーザーのみです。

ノート:

最適なパフォーマンスを得るには、AI接続の作成時にMeta Llamaチャット・モデルを使用します(meta.llama-4-scout-17b-16e-instructなど)。使用可能なモデルを表示するには、事前トレーニング済基礎モデルを参照してください。

データベース接続の設定

  1. 「ソース」に移動します。
  2. 「接続の作成」をクリックします。
  3. 「接続タイプ」として「Oracle Database」を選択します。
  4. Oracle AI Database 26aiインスタンスの資格証明を「接続の詳細」に入力します。
  5. 「保存」をクリックします。

AI接続の作成

  1. 「ソース」に移動します。
  2. 「接続の作成」をクリックします。
  3. 「接続タイプ」として「GenAI」を選択します。
  4. パラメータを入力して、「ベクトルとチャットの資格証明詳細」セクションを完了します:
    1. ユーザーOCID: 構成ファイルのプレビューでこの値を見つけます。
    2. テナンシOCID: 構成ファイルのプレビューでこの値を見つけます。
    3. OCIコンパートメントID: Oracle Cloud Infrastructureコンソールの「アイデンティティ」に移動し、コンパートメントを選択します。そこにコンパートメントIDがあります。
    4. 秘密キー: 秘密キーを作成する手順は、必要なキーとOCIDを参照してください。
    5. フィンガープリント: 構成ファイルのプレビューでこの値を見つけます。

    ノート:

    OCI資格証明を取得するには:
    1. Oracle Cloud Infrastructureコンソールにサインインします。
    2. 「プロファイル」アイコンをクリックし、ユーザー設定を選択します。
    3. トークンとキーに移動します。
    4. 「フィンガープリント」リストで、APIキーを選択します。
    5. メニュー(3つのドット)をクリックします。
    6. 「構成ファイルの表示」を選択して、構成ファイルのプレビューを表示します。

    ノート:

    OCI構成を設定していない場合:
    1. Oracle Cloud Infrastructureコンソールにサインインします。
    2. 「プロファイル」アイコンをクリックし、ユーザー設定を選択します。
    3. トークンとキーに移動します。
    4. 「APIキーの追加」をクリックします。
    5. 公開キーの貼付けを選択します。
    6. VMで、公開キー・ファイルを開き、公開キーの内容をコピーします。
    7. Oracle Cloud Infrastructureページに戻り、公開キーの内容を貼り付けます。
    8. 「追加」をクリックします。
    9. APIキーを追加したら、メニュー(3つのドット)をクリックし、「構成ファイルの表示」を選択して構成ファイルのプレビューを表示します。

    詳細は、必要なキーとOCIDを参照してください。

  5. 次の詳細を使用して、「チャット・プロファイル詳細」セクションおよび「ベクトル化とMDXジェネレータ詳細」セクションを完了します:
    1. チャット・モデル: meta.llama-4-maverick-17b-128e-instruct-fp8、または事前トレーニング済基礎モデルにリストされている現在のモデルを選択します
    2. OCIリージョン: us-chicago-1 (すべてのリージョンを使用できます)
    3. 生成AIサービスのURL: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
    4. ベクトル埋込みモデル: cohere.embed-english-v3.0
    5. 転送タイムアウト: 3000
    6. 説明: (オプション)

ドキュメントのベクトル化

  1. 「アカデミ」に移動します。
  2. 「Essbaseに質問」を選択します。
  3. 「設定」アイコンをクリックし、設定した「アクティブなGenAI接続」を選択します。
  4. 「ベクトル化」をクリックします。
    1. これにより、ベクトル索引の作成、OCIストレージへのファイルのアップロード、およびチャットボット問合せのためのシステムの準備を行うバックグラウンド・ジョブが開始されます。
    2. ジョブの進行状況は、ジョブUIで追跡するか、チャットボット・インタフェースで直接追跡できます。
    3. このプロセスは1回のみ実行する必要があります。

Essbaseに質問の使用開始

  1. ベクトル化が完了したら、Essbaseに質問で直接質問してください。
  2. AIによって、完全な回答とサポート・ドキュメントへのリンクが表示されます。

無効化

  1. 「設定」アイコンをクリックし、フォーム・ページの「削除」アイコンをクリックして、Essbaseに質問を非アクティブ化します。

    ノート:

    このアクションでは、ベクトル索引およびベクトル表を削除するバックグラウンド・ジョブが開始され、ベクトル索引にリンクされているチャット・プロファイルが削除され、OCIバケットからすべてのドキュメント・ポインタ・ファイルが削除されます。