Installation from OCI Marketplace

You can install the Agent Factory application from the Oracle Cloud Marketplace in just a few steps:

Launch Stack

1. Visit the Agent Factory listing on Oracle Cloud Marketplace.

   

2. Click Get App and sign in to your OCI tenancy.

3. On the product overview page, review the details and usage instructions. Then, select the Launch Stack button in the top right corner.

   

4. Once you review and accept the Oracle Standard Terms and Restrictions, select Launch Stack button in the bottom right corner.

   

5. Under General Settings, select the region and the desired compartment where the application will be created.

   

6. Under Network Configuration, select an existing VCN and subnet. The recommended VCN configuration contains a 10.0.0.0/16 CIDR block, an internet gateway for external connectivity, a route table directing 0.0.0.0/0 traffic to the internet gateway, and a security list allowing inbound SSH (port 22), HTTP (port 8080), and Oracle Database (port 1521) traffic from any source. A public subnet (10.0.1.0/24) is also defined, associated with the custom route table and security list, with public IPs allowed on Virtual Network Interface Cards (VNICs).

   

7. Provide a display name and an instance shape for the Agent Factory server and select Next.

8. Review the details and select Create to start the instance creation job.

   

9. Once the job succeeds, copy the application URL in the format https://<instance_public_ip>:8080/studio/installation as displayed in the logs.

   

10. Access the URL to view the Sign Up page of the Oracle AI Database Private Agent Factory and start setting up the application.

Configure Application

The following prerequisites are required to successfully set up the Oracle AI Database Private Agent Factory:

• Oracle Database 26ai. You will need access to an instance of Oracle Database 26ai. It is recommended to create a dedicated user for this purpose. This user should be used exclusively for managing these tables and not for storing production data. The following SQL script is recommended for creating the dedicated user:

  CREATE USER <DB_USER> IDENTIFIED BY <DB_PASSWORD> DEFAULT TABLESPACE USERS QUOTA unlimited ON USERS;
   GRANT CONNECT, RESOURCE, CREATE TABLE, CREATE SYNONYM, CREATE DATABASE LINK, CREATE ANY INDEX, INSERT ANY TABLE, CREATE SEQUENCE, CREATE TRIGGER, CREATE USER, DROP USER TO <DB_USER>;
   GRANT CREATE SESSION TO <DB_USER> WITH ADMIN OPTION;
   GRANT READ, WRITE ON DIRECTORY DATA_PUMP_DIR TO <DB_USER>;
   GRANT SELECT ON SYS.V_$PARAMETER TO <DB_USER>;
   exit;

• LLM endpoint. The Oracle AI Database Private Agent Factory relies on integration with a Large Language Model to function properly. You will require appropriate authentication credentials or an access key to connect the application with an available LLM instance of your choice.

Access the Application

1. Copy and paste the application URL in a browser. You will see a page like below.

   

2. Click ‘Advanced’ and then ‘Proceed to host’.

   

Configure User

Set up an email and a secure password.

Configure Database Connection

1. Provide your database connection details. You can either enter the Oracle AI Database 26ai connection details directly, provide the connection string or upload a database wallet file, along with a user and password.

   • Basic: Enter all the connection details manually and the previously created database user and password.

     

     Description of the illustration install-step-2-db-config-1.png

   • Connection String: Enter the Database Connection String and the previously created database user and password.

     

     Description of the illustration install-step-2-db-config-2.png

   • Wallet: Upload a Database Wallet File and enter the previously created database user and password.

     

     Description of the illustration install-step-2-db-config-3.png

2. Click Test Connection to verify that the information entered is correct. Upon a successful connection, you will see a ‘Database connection successful’ notification. Click Next.

Install Components

1. Click Install and wait a few minutes for the setup to complete.

   

2. When finished, you will see the message ✓ Please proceed to the next step for LLM Configuration. Click Next.

   

Configure LLM

Before you continue, see Manage LLM to review the supported models and LLM providers, and how to set them up.

1. Select an LLM configuration based on your LLM provider. The application supports integration with Ollama, vLLM, OpenAI, and the full suite of OCI GenAI offerings. Depending on your selected provider, the required connection credentials may differ.

   

   Description of the illustration install-step-llm-config.png

2. Enter the required details in the selected LLM configuration and select Test Connection. Once you see the Connection successful message, select Save Configuration.

   Optionally, configure an embedding model to use for data ingestion and retrieval. By default, multilingual-e5-base model is used to generate embeddings and is also the local embedding model included with the service.

   Pre-built Knowledge Assistants currently support only embedding models from the OCI Generative AI Service. To ensure proper functionality of the pre-built knowledge agents, select from the following cohere embedding models.

   • multilingual-e5-base
   • cohere.embed-v4.0
   • cohere.embed-multilingual-light-v3.0
   • cohere.embed-english-v3.0
   • cohere.embed-multilingual-v3.0

3. Finally, select Finish Installation to complete the setup and be redirected to the login page.

Log In to the Application

Log in with the email and password created previously. After logging in, you will be greeted by the Get Started screen.