Oracle AI Databaseと組み合わせて使うノーコードAgent BuilderのPrivate Agent Factoryが先日リリースされました。
製品の特徴など詳細は以下記事をご参照ください。
本記事ではインストーラーを使ったPrivate Agent Factoryの構築、および簡単なカスタム・フローの作成を試してみます。
検証環境
OCI Compute の VM.Standard3.Flex (2 OCPU) 上で構築しました。
OSはOracle Linux 8です。
インストール要件は下記をご確認ください。
Agent Factory構築
インストールモードは大きく以下２通りです。
- Productionモード
- Quick Startモード
Productionモードは別途構築するオンプレやOCI上のOracle AI Database 26ai、もしくはADB 26aiと組み合わせて使います。
Quick Startモードは一緒に構築されるOracle AI Database 26ai Freeと組み合わせて使います。
その他それぞれのモードで必要とされるスペック等の要件が異なります。
詳細は下記マニュアルをご参照ください。
今回は無償で手軽に始められるQuick Startモードで構築しました。
Private Agent Factoryの構築
手順は以下マニュアルに記載されていますので、こちらに沿って進めます。
本検証ではVPN接続を前提としない「No VPN. Quickstart mode」の手順を採用しました。
まずは以下サイトより applied_ai.tar.gz をダウンロードします。
ComputeにopcユーザでSSHログインし、作業ディレクトリを作成します。
今回は paf というディレクトリ名にしました。
$ mkdir paf
$ cd paf
作業ディレクトリにインストーラーをSCP等でアップロードして解凍します。
$ tar xzf applied_ai.tar.gz
すると以下のようなファイル群が作成されます。
$ ll
total 3096204
drwxr-xr-x. 4 opc opc 156 Dec 12 18:51 applied-ai
-rw-r--r--. 1 opc opc 3170353532 Jan 18 07:03 applied_ai.tar.gz
-rwxr-x---. 1 opc opc 8148 Dec 12 17:46 build-image.sh
-rwxr-x---. 1 opc opc 451 Apr 29 2025 build.sh
-rwxr-x---. 1 opc opc 52802 Dec 11 02:22 deploy.sh
-rwxr-x---. 1 opc opc 4436 Sep 4 11:06 diagnose.sh
-rwxr-x---. 1 opc opc 25287 Dec 12 01:51 interactive_install.sh
-rw-r--r--. 1 opc opc 1341 Dec 1 09:11 Makefile
drwxr-xr-x. 3 opc opc 67 Dec 12 18:51 ollama
-rw-r--r--. 1 opc opc 756 Nov 28 12:53 podman-compose-prod.yaml
-rw-r--r--. 1 opc opc 1052 Dec 11 02:22 podman-compose-quickstart.yaml
-rw-r--r--. 1 opc opc 9563 Sep 23 08:12 README-DEV.txt
-rw-r--r--. 1 opc opc 9537 Sep 23 08:12 README.txt
-rwxr-x---. 1 opc opc 9220 Nov 26 11:15 uninstall.sh
-rwxr-x---. 1 opc opc 3476 Jul 18 2025 utils.sh
なおPrivate Agent FactoryはコンテナイメージとしてPodman経由で起動されます。
そのコンテナイメージは Oracle Container Registry より取得するため、インストール中に Oracle Container Registry の認証情報の入力を求められます。
上記より事前に認証で必要となるTokenを取得しておきます。
以下にアクセスし、右上の「Sign In」よりOracleアカウントでログインします。
ログイン後、右上のユーザ名をクリックして「Auth Token」を選択し、遷移先の画面でTokenを生成します。
生成されたTokenはどこかにメモしておきます。
あとはCLI形式のインストーラーを起動するだけです。
起動後に先ほど取得したToken含め、いくつか設定項目を指定する箇所があります。
それらを入力すると必要なOSパッケージのインストールが始まります。
$ bash interactive_install.sh
詳細な端末ログはこちら
================================================================
Oracle Private AI Agent Studio Interactive Installer ��
================================================================
[INFO] This script will guide you through the setup process.
[INFO] Completed steps will be skipped on reruns.
[WARNING] Please run this script as a non-root user.
Are you on a corporate network that requires an HTTP/HTTPS proxy? (y/N): N
[INFO] Proxy disabled.
[INFO] Detected OS: Linux
Enter 1 if you are on a Standard Oracle Linux machine or 2 if you are on OCI [1]: 2
[INFO] Starting setup for OCI Oracle Linux VM...
Enter your Linux username [opc]:
[INFO] Starting step: Install Podman and configure SELinux
...(略)...
Complete!
[INFO] Setting SELinux to permissive mode for the current session...
[SUCCESS] Step 'Install Podman and configure SELinux' completed.
[INFO] Starting step: Configure Podman storage
Enter a mount point with at least 60GB of space (e.g., /scratch): /home/opc/podman
[INFO] Setting up Podman storage at '/home/opc/podman'...
[SUCCESS] Step 'Configure Podman storage' completed.
[INFO] Starting step: Log in to container registry
[INFO] Please log in to Oracle Container Registry.
[INFO] You can get a token from https://container-registry.oracle.com/
Username: <email_registered_on_container_registry>
Password: <token_from_container_registry>
Login Succeeded!
[SUCCESS] Step 'Log in to container registry' completed.
[INFO] Starting step: Install podman-compose
[INFO] Installing podman-compose via pip...
...(略)...
[2026-01-18 16:39:28.221] [SUCCESS] Step 'Install podman-compose' completed.
[2026-01-18 16:39:28.221]
[2026-01-18 16:39:28.221] [INFO] Starting step: Enable user linger
[2026-01-18 16:39:28.227] [INFO] Enabling linger mode for user 'opc' to keep services running after logout...
[2026-01-18 16:39:28.237] [SUCCESS] Step 'Enable user linger' completed.
[2026-01-18 16:39:28.237]
[2026-01-18 16:39:28.237] [INFO] Starting step: Configure firewall
[2026-01-18 16:39:28.237] [INFO] Configuring firewall to open port 8080...
[2026-01-18 16:39:28.373] success
[2026-01-18 16:39:28.697] success
[2026-01-18 16:39:28.716] [SUCCESS] Step 'Configure firewall' completed.
途中でOracle AI Database 26aiとの連携方法を聞かれますが、今回はQuick Startモードのためスキップを選択します。
[INFO] Starting step: Perform manual DB setup
[INFO] The following steps are for connecting to your own existing Oracle 23ai Database.
*******************************************************************************************************
* *
* NOTE: If you choose the 'Quickstart' mode later during the 'make build' and 'make up' step, *
* a local 23ai Database will be automatically created and configured for you. *
* In that case, you can skip the manual steps below. *
* *
*******************************************************************************************************
Do you want to proceed with the manual database setup? (y/N): N
[INFO] Skipping manual database setup.
[SUCCESS] Step 'Perform manual DB setup' completed.
最後にコンテナイメージのビルドが始まります。
この際にインストールモードを聞かれますので、今回は Quick Start を選択します。
[INFO] Starting step: Build container images
[INFO] Building container images with 'make build'. This will take several minutes.
Press [Enter] to run 'make build'...
bash build-image.sh
Select installation mode:
1) prod
2) quickstart
Enter choice (1 or 2): 2
Building the images necessary in Quickstart mode
You selected Quickstart mode. Confirm? (yes/no) [yes]: yes
Building Oracle AI Database Private Agent Factory Image...
No proxy settings detected - ensure you can access container registry
Pulling oraclelinux:8 from oracle container-registry...
...(略)...
そこから10分ほどで以下のように出力され、インストールが完了しました。
インストール完了時の出力
▗▄▖ ▗▄▄▖ ▗▄▖ ▗▄▄▖▗▖ ▗▄▄▄▖
▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌▐▌ ▐▌ ▐▌
▐▌ ▐▌▐▛▀▚▖▐▛▀▜▌▐▌ ▐▌ ▐▛▀▀▘
▝▚▄▞▘▐▌ ▐▌▐▌ ▐▌▝▚▄▄▖▐▙▄▄▖▐▙▄▄▖
▗▄▖ ▗▄▄▖▗▄▄▄▖▗▖ ▗▖▗▄▄▄▖ ▗▄▄▄▖ ▗▄▖ ▗▄▄▖▗▄▄▄▖▗▄▖ ▗▄▄▖▗▖ ▗▖
▐▌ ▐▌▐▌ ▐▌ ▐▛▚▖▐▌ █ ▐▌ ▐▌ ▐▌▐▌ █ ▐▌ ▐▌▐▌ ▐▌▝▚▞▘
▐▛▀▜▌▐▌▝▜▌▐▛▀▀▘▐▌ ▝▜▌ █ ▐▛▀▀▘▐▛▀▜▌▐▌ █ ▐▌ ▐▌▐▛▀▚▖ ▐▌
▐▌ ▐▌▝▚▄▞▘▐▙▄▄▖▐▌ ▐▌ █ ▐▌ ▐▌ ▐▌▝▚▄▄▖ █ ▝▚▄▞▘▐▌ ▐▌ ▐▌
Starting deployment mode determination...
✓ Image 'localhost/applied-ai-label:25.3.0.0.0' found.
✓ Image 'localhost/applied-ai-label:25.3.0.0.0' found.
✓ Image 'container-registry.oracle.com/database/free:23.8.0.0' found.
Both Production mode and Quickstart mode deployments are possible.
Select installation mode:
1) prod
2) quickstart
Selection: 2
You have chosen Quickstart mode. Confirm? (yes/no):
yes
Deploying Oracle AI Database Private Agent Factory in Quickstart mode...
Successfully copied utl32k.sql
Initiating startup for oracle-applied-ai-label container...
Initiating startup for oracle-database container...
✓ oracle-applied-ai-label container is UP and RUNNING.
✓ oracle-database container is UP and RUNNING.
- Waiting for oracle-database to become healthy...
- Please wait while the application is being set up within oracle-applied-ai-label container...
- Waiting for oracle-database to become healthy...
- Waiting for oracle-database to become healthy...
- Waiting for oracle-database to become healthy...
✓ Application setup successfully within the container 'oracle-applied-ai-label'.
- Configuring application container: oracle-applied-ai-label...
✓ Application container oracle-applied-ai-label configured successfully.
+---------------------------------------------------+------------+
| Stage | Status |
+---------------------------------------------------+------------+
| Stopping Oracle AI Database Private Agent Factory | Successful |
+---------------------------------------------------+------------+
| Configuring the application | Successful |
+---------------------------------------------------+------------+
| Database Migration | Successful |
+---------------------------------------------------+------------+
| Starting Oracle AI Database Private Agent Factory | Successful |
+---------------------------------------------------+------------+
The Oracle AI Database Private Agent Factory webapp can be accessed at:
https://xxxxx.xxxxx.xxxxx.oraclevcn.com:8080/studio/
- Waiting for oracle-database to become healthy...
- Waiting for oracle-database to become healthy...
✓ Container 'oracle-database' is HEALTHY.
✓ Quickstart deployment complete.
Logs can be found at: ./deploy.log
[SUCCESS] Step 'Launch application containers' completed.
[SUCCESS] Installation script finished!
[INFO] You can now access the application.
Private Agent Factoryの初期セットアップ
ここからはWebブラウザ上で初期セットアップ作業をしていきます。
まずは管理用アカウントを作成します。
｢Install」ボタンを選択し、Oracle AI Database 26ai Free内にPrivate Agent Factoryの設定情報をインストールします。
完了したら「Next」を選択します。
連携するLLM、Embeddingモデルを設定します。
今回はLLMとしてOpenAIの gpt-4o を設定しました。
EmbeddingモデルはOCI Gen AIの cohere.embed-multilingual-v3.0 を設定しました。
これで初期セットアップ完了です。
改めて先ほど作成した管理ユーザでログインします。
無事にログインできると以下のような画面が表示されます。
Agent Builderからカスタム・フローを作ってみる
Agent Builderで簡単なカスタム・フローを作って動作確認してみます。
左メニュー一覧から「Agent Builder」を選択します。
私はアップロードした記事への問合せができるChat botを以下のように作成しました。
例ではExascaleのブログ記事をアップしています。
右上の「Playground」を選択すると、以下のようにチャット形式で動作確認できます。
Pre-Build Agentsを試す
Private Agent Factoryには事前作成済みのエージェントが存在します。
1つは Knowledge agents で、Webサイトやアップロードしたファイル、SharePointから取り込んだ情報をもとにQAが出来るエージェントです。
いくつか Knowledge agents に取り込めるデータセットがデフォルトで用意されており、その中にはOracle DB 19cと26aiのマニュアルやホワイトペーパーが集約されたものもあったりします。
DBAの方にはかなり重宝しそうですね。。
今回はPre-Builder Agentsとしてもう1つ用意されている Data analysis agents を試しました。
まずは分析対象のデータをImportしておきます。
上記画面に3つ並んでいるデータセットのうち「Netflix Titles Dataset」をImportします。
左メニュー一覧から「Data analysis agents」を選択し、右上の「Create agent」を選択します。
データソースとしてImportしたNetflixのデータを選択します。
エージェント名や説明文を記入してPublishします。
あとは新規作成したエージェントの「Open agent」ボタンを選択すると利用できます。
本エージェントを使えば、例えば以下のようにチャートを生成してデータ分析を支援してくれます。
これで Oracle Analytics Cloud のAIアシスタント機能みたいなことも実現できますね。
以上、Quick StartモードでのPrivate Agent Factoryの構築と、簡単な動作確認でした。
Quick Startモードであれば無償で手軽に構築できますので、是非お試しください！