Autonomous Database: Oracle LiveLabs ワークショップの Select AI のAPEXデモ環境を作成してみた

Posted at 2024-02-21

■ はじめに

本記事は2024年1月時点の作業を元に記載しています

Select AI 機能の情報収集していたところ、Oracle が無償提供している Oracle LiveLabs で Select AI とAPEXデモを作成するワークショップが公開されていたので試してみました。

参考資料:
Oracle LiveLabs: Run Workshop - Chat with Your Data in Autonomous Database Using Generative AI

■ 事前に準備するもの

OCIアカウント ※以下のOCI Cloud Free Tier アカウントも可

■ 作業の流れ

OpenAI のアカウント作成とセキュリティ・キーの取得
Select AI のデモ・アプリケーション(APEX)を含む ADB の作成
LLM(OpenAI)の利用設定
APEXに接続

■ 1. OpenAI のアカウント作成とセキュリティ・キーの取得

Lab 1: Start up for Access to Large Langage Model(LLM): Task1: Sign up for Access to a Large Language Model (LLM) を参考に作業をします。

以下のリンクにアクセスして、OpenAIのアカウントを作成します。
https://platform.openai.com/signup?launch

※筆者はGoogleアカウントに紐づけしました。

アカウント作成後にOpenAIにログインし、APIページに遷移します。

LiveLabsの画面ショットを参考に画面左のメニューから Setting > Billing にナビゲートして支払情報としてクレジット・カードを登録します。

無料で5ドル分のクレジットが付与されますが、初期費用として最小で5ドルチャージする必要があります。
※単純な検証では十分なクレジットになります。筆者が1か月程度、簡単な検証に使用して$0.33 消費しています。

チャージが完了したら、画面左のメニュー: API Keys に遷移し、"Create new secret key" より OpenAI のシークレット・キーを作成します。

任意の名前で登録後、OpenAIのシークレット・キーをコピーし、保存します。

■ 2. Select AI のデモ・アプリケーション(APEX)を含む Autonomous Database の作成

・コンパートメントを作成

Lab 1: Start up for Access to Large Langage Model(LLM): Task2: Create an OCI Compartment を参考に、デモ環境を構築するコンパートメントを作成します。

・ADB デモ環境を作成

Lab 1: Start up for Access to Large Langage Model(LLM): Task3: Provision an ADB Instance, Load Data, and Install the Select AI Demo Application を参照しながら、ADBデモ環境を作成します。

最初に"Deploy workshop"のボタンをクリックします。

クリックすると利用中のOCIアカウントで、Resource Manager の Stack が起動され、"Deploy-ChatDB-Autonomous-Database-Select-AI-demonstration-RM.zip"がロードされます。

LiveLabsのガイドに従ってパラメータを設定していきます。"Secret API key to used to connect to AI model"にOpenAIで作成したシークレット・キーを登録することで、ADBがOpenAIに接続することができます。

確認画面で問題がなければ、スタックを適用してデモ環境の作成を開始します。

リソースマネージャのジョブが起動しますので、完了するのを待ちます。

完了後、"出力"より以下の情報をコピーし、保存します。

adb_user_name
adb_user_password
select_ai_demo_url

■ 3. LLM(OpenAI)の利用設定

LiveLabsを参考に作成したOCIコンソールからデモ用ADBにアクセスし、Database Actions > SQL を開き、ナビゲータより"MOVIESTREAM"ユーザーを選択し、作業を行います。

ネットワークACLの設定

以下を実行し、api.openai.com にREST呼び出しを行うためのネットワークACLに "MOVIESTREAM" のプリンシパルを追加します

BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE (
  HOST         => 'api.openai.com',
  LOWER_PORT   => 443,
  UPPER_PORT   => 443,
  ACE          => xs$ace_type(
      PRIVILEGE_LIST => xs$name_list('http'),
      PRINCIPAL_NAME => 'MOVIESTREAM',
      PRINCIPAL_TYPE => xs_acl.ptype_db));
END;
/

DBMS_CLOUD_AI の権限の付与

以下を実行し、DBMS_CLOUD_AI の実行権限を付与します

GRANT EXECUTE ON DBMS_CLOUD_AI TO moviestream

クレデンシャルの作成

dbms_cloud.create_credentialを実行して、LLM APIリクエストのためのクレデンシャルを作成します。

BEGIN
    dbms_cloud.create_credential (
        credential_name  => 'OPENAI_CRED',
        username => 'OPENAI',
        password => 'OpenAIで作成したシークレット・キー'
    );
END;
/

AIプロファイルの作成

DBMS_CLOUD_AI.CREATE_PROFILEを実行して、LLM, クレデンシャル, LLMに共有するオブジェクトのリストを含むAIプロファイルを作成します。

BEGIN
    DBMS_CLOUD_AI.CREATE_PROFILE(
        profile_name => 'openai_gpt35',
        attributes =>
            '{"provider": "openai",
            "credential_name": "OPENAI_CRED",
            "object_list": [{"owner": "MOVIESTREAM", "name": "movies"},
                            {"owner": "MOVIESTREAM", "name": "streams"},
                            {"owner": "MOVIESTREAM", "name": "customer_extension"},
                            {"owner": "MOVIESTREAM", "name": "pizza_shop"},
                            {"owner": "MOVIESTREAM", "name": "actors"},
                            {"owner": "MOVIESTREAM", "name": "genre"},
                            {"owner": "MOVIESTREAM", "name": "customer_segment"},
                            {"owner": "MOVIESTREAM", "name": "customer_contact"}
                            ]
            }'
        );
END;
/

※オブジェクトを追加後に、編集して実行することで、AIプロファイルを追加でき、プロファイルを切り替えることでデモで使用するオブジェクトを変更させることができます。