Oracle Cloud Infrastructure Documentation

OCI Search with OpenSearch Guidelines for Generative AI Agents

To make your data available to OCI Generative AI Agents, you have the following data options:

  • Object Storage data: Upload data files to OCI Object Storage and let Generative AI Agents automatically ingest the data. This option is service-managed. Skip this topic if your data files are in Object Storage.
  • Oracle Database vector store: Bring your own (BYO) vectorsearch from an Oracle Database 23ai or an Autonomous Database 23ai vector store to Generative AI Agents. Skip this topic if you have this option.
  • OpenSearch data: Bring your own (BYO) ingested and indexed OCI Search with OpenSearch data for the agents to use. This topic provides guidelines for this option, assuming you're already familiar with OCI Search with OpenSearch.
Note

  • Perform the following steps in the US Midwest (Chicago) region. Generative AI Agents is only available in this region.

Creating a Cluster

Use the Search and visualize data using OCI Search Service with OpenSearch tutorial to create a cluster and prepare data for your agent.

  1. Set up the OpenSearch Service Permissions.
  2. Create an OpenSearch cluster,
  3. Prerequisites to connect to OpenSearch cluster including the VCN, subnet, and security rules for OCI Search with OpenSearch.
  4. Add data to OCI OpenSearch.
  5. Create indexes for OpenSearch data.

For all the information you need about OCI Search with OpenSearch, see the OCI Search with OpenSearch documentation.

Creating a Secret

Before you add Search with OpenSearch data to a knowledge base in Generative AI Agents, you must create a secret for OpenSearch in OCI Vault service.

  1. In the OCI Console, Create a Vault.
  2. After the vault is active, create a key for the vault.
  3. For the vault, create a secret with the following specifics:
    • Select the key that you created in the previous step.
    • Manually enter the username and password for the OpenSearch cluster with the following format:
      • Secret Type Template: Plain-Text
      • Secret Contents: <OpenSearch-username>:<OpenSearch-password>