Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

## Description

The **Oracle AI Optimizer and Toolkit** (the **AI Optimizer**) provides a streamlined environment where developers and data scientists can explore the potential of Generative Artificial Intelligence (GenAI) combined with Retrieval-Augmented Generation (RAG) capabilities. By integrating **Oracle Database 23ai** AI VectorSearch and SelectAI, the Sandbox enables users to enhance existing Large Language Models (LLMs) through RAG.
The **Oracle AI Optimizer and Toolkit** (the **AI Optimizer**) provides a streamlined environment where developers and data scientists can explore the potential of Generative Artificial Intelligence (GenAI) combined with Retrieval-Augmented Generation (RAG) capabilities. By integrating **Oracle AI Database** VectorSearch and SelectAI, the Sandbox enables users to enhance existing Large Language Models (LLMs) through RAG.

## AI Optimizer Features

Expand All @@ -25,7 +25,7 @@ For more information, including more details on **Setup and Configuration** plea

### Prerequisites

- Oracle Database 23ai incl. Oracle Database 23ai Free
- Oracle AI Database incl. Oracle AI Database Free
- Python 3.11 (for running Bare-Metal)
- Container Runtime e.g. docker/podman (for running in a Container)
- Access to an Embedding and Chat Model:
Expand Down Expand Up @@ -89,7 +89,7 @@ To run the application in a container; download the [source](https://github.com/

The **AI Optimizer** can be deployed in Oracle Cloud Infrastructure (OCI) using Infrastructure as Code (IaC).

Choose either a light-weight Virtual Machine or robust Oracle Kubernetes Engine deployment, both with an Oracle Autonomous Database 23ai:
Choose either a light-weight Virtual Machine or robust Oracle Kubernetes Engine deployment, both with an Oracle Autonomous Database:
[![Deploy to Oracle Cloud][magic_button]][magic_arch_stack]

For more information, please visit the [IaC Documentation](https://oracle.github.io/ai-optimizer/advanced/iac/index.html).
Expand Down
4 changes: 2 additions & 2 deletions docs/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The {{< full_app_ref >}} provides a streamlined environment where developers and

- **GenAI**: Powers the generation of text, images, or other data based on prompts using pre-trained **LLM**s.
- **RAG**: Enhances **LLM**s by retrieving relevant, real-time information allowing models to provide up-to-date and accurate responses.
- **Vector Database**: A database, including Oracle Database 23ai, that can natively store and manage vector embeddings and handle the unstructured data they describe, such as documents, images, video, or audio.
- **Vector Database**: A database, including Oracle AI Database, that can natively store and manage vector embeddings and handle the unstructured data they describe, such as documents, images, video, or audio.

## Features

Expand All @@ -40,7 +40,7 @@ The [Walkthrough](walkthrough) is a great way to familiarize yourself with the *

## Prerequisites

- Oracle Database 23ai incl. Oracle Database 23ai Free
- Oracle AI Database incl. Oracle AI Database Free
- Python 3.11 (for running Bare-Metal)
- Container Runtime e.g. docker/podman (for running in a Container)
- Access to an Embedding and Chat Model:
Expand Down
2 changes: 1 addition & 1 deletion docs/content/advanced/helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ A containerized Autonomous Oracle Database:
type: "ADB-FREE"
image:
repository: container-registry.oracle.com/database/adb-free
tag: latest-23ai
tag: latest
```

**ADB-S**
Expand Down
6 changes: 3 additions & 3 deletions docs/content/client/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The {{< full_app_ref >}} consists of an API Server ([**ai-optimizer-server**](#a
![Architecture Overview](images/arch_overview.png)

The following additional components, not delivered with the {{< short_app_ref >}}, are also required. These can be run On-Premises or in the Cloud:
- [Oracle Database 23ai](#database), including [Oracle Database 23ai **Free**](https://www.oracle.com/uk/database/free/)
- [Oracle AI Database](#database), including [Oracle AI Database **Free**](https://www.oracle.com/database/free)
- Access to at least one [Large Language Model](#large-language-model)
- Access to at least one [Embedding Model](#embedding-model) (for Retrieval Augmented Generation)

Expand Down Expand Up @@ -45,7 +45,7 @@ You can develop and replace the provided client with any REST capable client.

## Database

[Oracle Database 23ai](https://www.oracle.com/uk/database/23ai/), including [Oracle Database 23ai **Free**](https://www.oracle.com/uk/database/free/) provides a persistent data store for the {{< short_app_ref >}}.
[Oracle AI Database](https://www.oracle.com/database), including [Oracle AI Database **Free**](https://www.oracle.com/database/free) provides a persistent data store for the {{< short_app_ref >}}.

![Database](./images/vector_storage.png)

Expand All @@ -54,7 +54,7 @@ You can develop and replace the provided client with any REST capable client.
The **AI Optimizer** can be used to interact with language models without having the database configured, but additional functionality such as RAG, will not be available without the database.
{{% /notice %}}

The 23ai database provides:
Oracle AI Database provides:

- the Vector Store for split and embedded documents used for Retrieval Augmented Generation (RAG).
- storage for the [Testbed](testbed) Q&A Test Sets and Evaluations
Expand Down
2 changes: 1 addition & 1 deletion docs/content/client/configuration/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ For more information on the currently supported models and how to configure them

## 🗄️ Database Configuration

A 23ai Oracle Database is required to store the embedding vectors to enable Retrieval-Augmented Generation (RAG). The ChatBot can be used without a configured database, but you will be unable to split/embed or experiment with RAG in the ChatBot.
Oracle AI Database is required to store the embedding vectors to enable Retrieval-Augmented Generation (RAG). The ChatBot can be used without a configured database, but you will be unable to split/embed or experiment with RAG in the ChatBot.

For more information on configuring the database, please read about [Database Configuration](db_config/).

Expand Down
2 changes: 1 addition & 1 deletion docs/content/client/configuration/db_config.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Licensed under the Universal Permissive License v1.0 as shown at http://oss.orac
spell-checker: ignore tablespace mycomplexsecret mycomplexwalletsecret
-->

To use the Retrieval-Augmented Generation (RAG) functionality of the {{< short_app_ref >}}, you will need to setup/enable an [embedding model](../model_config) and have access to an **Oracle Database 23ai**. Both the [Always Free Oracle Autonomous Database Serverless (ADB-S)](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/autonomous-always-free.html) and the [Oracle Database 23ai Free](https://www.oracle.com/uk/database/free/get-started/) are supported. They are a great, no-cost, way to get up and running quickly.
To use the Retrieval-Augmented Generation (RAG) functionality of the {{< short_app_ref >}}, you will need to setup/enable an [embedding model](../model_config) and have access to an **Oracle AI Database**. Both the [Always Free Oracle Autonomous Database Serverless (ADB-S)](https://docs.oracle.com/en/cloud/paas/autonomous-database/serverless/adbsb/autonomous-always-free.html) and the [Oracle AI Database Free](https://www.oracle.com/database/free/get-started/) are supported. They are a great, no-cost, way to get up and running quickly.

## Configuration

Expand Down
18 changes: 9 additions & 9 deletions docs/content/walkthrough/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Licensed under the Universal Permissive License v1.0 as shown at http://oss.orac
spell-checker: ignore mxbai, ollama, sqlplus, sysdba, spfile, freepdb, tablespace, firewalld, hnsw
-->

This walkthrough will guide you through a basic installation of the {{< full_app_ref >}}. It will allow you to experiment with GenAI, using Retrieval-Augmented Generation (**RAG**) with Oracle Database 23ai at the core.
This walkthrough will guide you through a basic installation of the {{< full_app_ref >}}. It will allow you to experiment with GenAI, using Retrieval-Augmented Generation (**RAG**) with the Oracle AI Database at the core.

By the end of the walkthrough you will be familiar with:

Expand Down Expand Up @@ -50,7 +50,7 @@ You will run four container images to establish the "Infrastructure":

- On-Premises **LLM** - llama3.1
- On-Premises Embedding Model - mxbai-embed-large
- Vector Storage/SelectAI - Oracle Database 23ai Free
- Vector Storage/SelectAI - Oracle AI Database Free
- The {{< short_app_ref >}}

### LLM - llama3.1
Expand Down Expand Up @@ -158,11 +158,11 @@ The {{< short_app_ref >}} provides an easy to use front-end for experimenting wi
podman run -d --name ai-optimizer-aio --network=host localhost/ai-optimizer-aio:latest
```

### Vector Storage - Oracle Database 23ai Free
### Vector Storage - Oracle AI Database Free

AI Vector Search in Oracle Database 23ai provides the ability to store and query private business data using a natural language interface. The {{< short_app_ref >}} uses these capabilities to provide more accurate and relevant **LLM** responses via Retrieval-Augmented Generation (**RAG**). [Oracle Database 23ai Free](https://www.oracle.com/uk/database/free/get-started/) provides an ideal, no-cost vector store for this walkthrough.
AI Vector Search in Oracle AI Database provides the ability to store and query private business data using a natural language interface. The {{< short_app_ref >}} uses these capabilities to provide more accurate and relevant **LLM** responses via Retrieval-Augmented Generation (**RAG**). [Oracle AI Database Free](https://www.oracle.com/database/free/get-started/) provides an ideal, no-cost vector store for this walkthrough.

To start Oracle Database 23ai Free:
To start the Oracle AI Database Free:

1. Start the container:

Expand Down Expand Up @@ -259,7 +259,7 @@ To configure the On-Premises Embedding Model, navigate back to the _Configuratio

### Configure the Database

To configure Oracle Database 23ai Free, navigate to the _Configuration_ screen and _Databases_ tab:
To configure Oracle AI Database Free, navigate to the _Configuration_ screen and _Databases_ tab:

1. Enter the Database Username: `WALKTHROUGH`
1. Enter the Database Password for the database user: `OrA_41_OpTIMIZER`
Expand Down Expand Up @@ -304,7 +304,7 @@ After the splitting and embedding process completes, you can query the Vector St

From the command line:

1. Connect to the Oracle Database 23ai Database:
1. Connect to the Oracle AI Database:

```bash
podman exec -it ai-optimizer-db sqlplus 'WALKTHROUGH/OrA_41_OpTIMIZER@FREEPDB1'
Expand All @@ -326,12 +326,12 @@ For this guided experiment, perform the following:

1. Ask the _ChatBot_:
```text
In Oracle Database 23ai, how do I use AHF?
In Oracle AI Database, how do I use AHF?
```

Responses may vary, but generally the _ChatBot_'s response will be inaccurate, including:

- Not understanding that 23ai is an Oracle Database release. This is known as knowledge-cutoff.
- Not understanding that there is a Oracle AI Database release. This is known as knowledge-cutoff.
- Suggestions that AFH has to do with a non-existant Hybrid Feature and running `emcli` commands. These are hallucinations.

Now select "Vector Search" in the Toolkit options and simply ask: `Are you sure?`
Expand Down
2 changes: 1 addition & 1 deletion helm/examples/values-kind-adb-free.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ server:
type: "ADB-FREE"
image:
repository: container-registry.oracle.com/database/adb-free
tag: latest-23ai
tag: latest
# oci_config:
# fileSecretName: "oci-config-file"
client:
Expand Down
6 changes: 3 additions & 3 deletions opentofu/variables.tf
Original file line number Diff line number Diff line change
Expand Up @@ -84,10 +84,10 @@ variable "infrastructure" {
variable "adb_version" {
description = "Autonomous Database Version"
type = string
default = "23ai"
default = "26ai"
validation {
condition = contains(["23ai"], var.adb_version)
error_message = "Must be 23ai."
condition = contains(["26ai"], var.adb_version)
error_message = "Must be 26ai."
}
}

Expand Down
2 changes: 1 addition & 1 deletion src/server/wip/createRDFGraph.py
Original file line number Diff line number Diff line change
Expand Up @@ -307,7 +307,7 @@ def create_semantic_relationships():
(r"overview of oracle ai vector search", r"get started"),
(r"why use oracle ai vector search", r"get started"),
(r"get started", r"generate vector embeddings"),
(r"oracle database 23ai release updates", r"get started"),
(r"oracle ai database release updates", r"get started"),
(r"conventions", r"overview of oracle ai vector search"),
(r"preface", r"overview"),
(r"introduction", r"get started"),
Expand Down
Loading