Ask Essbaseの構成

You can use these steps to efficiently configure, activate, and manage Ask Essbase for seamless AI-driven querying within your Oracle Essbase environment.

前提条件

Ask Essbaseを構成する前に、AI機能の前提条件のステップを完了します。

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

ノート:

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

ノート:

最適なパフォーマンスを得るには、AI接続の作成時にMeta Llamaチャット・モデルを使用します。使用可能なモデルを表示するには、「事前トレーニング済基本モデル」を参照してください。

データベース接続の設定

  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. 秘密キー: 秘密キーを作成する手順は、必須キーおよびOCIDsを参照してください。
    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つのドット)をクリックし、「構成ファイルの表示」を選択して「構成ファイルのプレビュー」を表示します。

    詳細は、必須キーおよびOCIDsを参照してください。

  5. 次の詳細を使用して、「チャット・プロファイル詳細」セクションおよび「ベクトル化セクションおよびMDXジェネレータ詳細」セクションに入力します:
    1. チャット・モデル: 「事前トレーニング済基本モデル」にリストされている使用可能なチャット・モデルを選択します。
    2. OCIリージョン:生成AIサービスおよび使用するモデルが使用可能なリージョンを選択します。リージョン別の生成AIモデルを参照してください。
    3. 生成AIサービスURL:選択したOCIリージョンおよびモデルの推論APIエンドポイントを使用します。たとえば、米国中西部(シカゴ)リージョンの場合: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
    4. ベクトル埋込みモデル: 「事前トレーニング済基本モデル」にリストされている使用可能な埋込みモデルを選択します。
    5. 転送タイムアウト: 3000
    6. 説明: (オプション)。

Vectorizeドキュメント

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

    ノート:

    ベクトル埋込みモデルを変更した場合は、新しい埋込みモデルを使用するAI接続でAsk Essbaseを再構成してから、ドキュメントを再度ベクトル化します。

Ask Essbaseの使用の開始

  1. ベクトル化が完了したら、Ask Essbaseで直接質問します。
  2. AIは、完全な回答とサポート・ドキュメントへのリンクを提供します。

非アクティブ化

  1. 「設定」を選択し、フォーム・ページで「削除」アイコンを選択して、Ask Essbaseを非アクティブ化します。

    ノート:

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