Oracle Cloud Infrastructure Documentation

Creating a Knowledge Base in Generative AI Agents

Important

Pre-General Availability: 2024-01-24

The following legal notice applies to Oracle pre-GA (Beta) releases. For copyright and other applicable notices, see Oracle Legal Notices.

Pre-General Availability Draft Documentation Notice

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

This documentation is not a commitment by Oracle to deliver any material, code, functionality or services. This documentation, and Oracle Pre-GA programs and services are subject to change at any time without notice and, accordingly, should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality for Oracle’s Pre-GA programs and services remains at the sole discretion of Oracle. All release dates or other predictions of future events are subject to change. The future availability of any future Oracle program or service should not be relied on in entering into any license or service agreement with Oracle.

  1. On the Knowledge Bases list page, click Create knowledge base.
    If you need help finding the list page, see Listing Knowledge Bases.
  2. Enter the following values:
    • Name: A name that starts with a letter or underscore, followed by letters, numbers, hyphens, or underscores. The length can be from 1 to 255 characters.
    • Compartment: The compartment that you want to store the agent in
    • Description: An optional description
    • Tags: Click Show advanced options and add one or more tags to the agent. If you have permissions to create a resource, then you have permission to update its tags. If you need help, see Tags and Tag Namespace Concepts.
  3. Select data store
    Select one of the following options:
    • Object Storage
    • OCI OpenSearch
      Important

      If you select this option, you must have an OCI OpenSearch cluster with ingested data that's indexed and ready to use. Ensure that you have chunked your documents to files with less than 10,000 token each, before you ingest those documents into OpenSearch.

  4. If you selected, Object Storage, perform one of the following actions:
    • Create one or more data sources for this knowledge base. If you need help, see Creating a Data Source.
    • Create the data sources later.
  5. If you selected, OCI OpenSearch, enter the following information:
    • OpenSearch cluster: Change the compartment if the cluster is in another compartment. Select the OCI OpenSearch cluster name.
    • OpenSearch Index: Enter the following information for the OpenSearch index:
      • Index Name
      • Body key
      • URL key (Optional)
      • Title key (Optional)
    • Secret Details: Perform one of the following actions:
      Note

      See the OpenSearch Guidelines for Generative AI Agents to help you enter the values for this step.
      • Select the Basic Auth Secret option and then select the secret for OCI Search with OpenSearch.
      • Select the IDCS Secret option, and then enter the following information for the IDCS confidential application that you want to use for the agent:
        • Identity domain: Change the compartment if the idenity domain is in another compartment. Select the OpenSearch cluster's idenity domain application name.
        • Client Id: Enter the client ID for the OpenSearch cluster's IDCS client application.
        • Client Secret Vault: Change the compartment if the secret is in another compartment. Select the secret that contains the client secret.
        • Scope URL: Enter the API endpoint for the identity domain's resource server application and include the scope for the agent. For example, if the scope is genaiagent, the scope URL can be https://*.agent.aiservice.us-chicago-1.oci.oraclecloud.com/genaiagent.

      To learn about OpenSearch clusters, see the information about an OpenSearch cluster's detail page.

  6. Click Create.