Add a Knowledge Base

Once you have performed prerequisite steps and configured the connection to OCI Search with OpenSearch, you can add a knowledge base.

Prerequisites

Add a Knowledge Base

  1. In the navigation pane, select Projects.
  2. Select the project in which you want to create the knowledge base.
  3. In the left navigation pane, select Knowledge Base Knowledge base icon.
  4. In the Knowledge base section, click Add .

    The Create knowledge base panel is displayed.

  5. Configure required fields for your knowledge base:
    • Name: Name for knowledge base. Provide a descriptive name so that you know what your knowledge base contains.
    • Identifier: Oracle Integration generates this value using the Name value.
    • Connection: Select the OCI Search with OpenSearch connection that you previously configured to associate with your knowledge base. This is where documents from OCI Object Storage will be ingested.
    • Embedding model:

      Use the model that best suits your use case. The default embedding model used is the general purpose model huggingface/sentence-transformers/all-mpnet-base-v2.

      To view a summary of each model, select the Embedding model field, and click Show description View details iconnext to the embedding model. For additional information on pretrained models in OCI Search with OpenSearch, see Pretrained Models in Search with OpenSearch.

    • Description: Describe the types of documents this knowledge base contains.
  6. Click Create.

    The knowledge base is created. This can take some time.

    In addition to the knowledge base, other artifacts are created for you: ready-to-use integrations, connections, AI agent with specific guidelines for knowledge bases, agentic AI tool with specific guidelines for knowledge bases, and agentic AI pattern optimized for knowledge bases.

    Note:

    You'll see two knowledge bases created: one with the name you specified, and another one with the name Default Recipe Knowledge Base. This is a known issue.
  7. Delete the extra knowledge base that was created with the name you specified. You'll be using the Default Recipe Knowledge base instead.

    The Default Recipe Knowledge Base is linked to all integrations and required artifacts to use the knowledge base.

    1. Next to the knowledge base that has the name you specified, click Actions Actions icon, then select Delete.
      The Delete knowledge base dialog is displayed.
    2. Click Delete.
  8. Rename the Default Recipe Knowledge Base to the name that you want.
    1. Next to the Default Recipe Knowledge Base, click Actions Actions icon, then select Edit.
      The Edit knowledge base pane is displayed.
    2. In the Name field, change Default Recipe Knowledge Base to the name that you want.
    3. Click Update.
  9. Specify the OCI Object Storage bucket from which to upload documents into the knowledge base.
    1. To return to the project workspace, click Go back Back icon.
    2. In your project, in the left toolbar, select Integration Integrations icon.
    3. In the Lookups section, next to the ConfigurationsLookups, click Actions Actions icon, then select Edit.
      The ConfigurationsLookups page is displayed.
    4. In KnowledgeBaseStorageBucket, specify the name of the OCI Object Storage bucket in which you are going to upload documents to be ingested into the knowledge base. You don't need to configure any other fields.
    5. Click Save.
  10. Activate the integration KnowledgeBaseUploadAndIngestFiles.

    This integration supports dragging and dropping documents into your knowledge base.

    1. In your project, in the left toolbar, select Integration Integrations icon.
    2. In the Integration section, next to the KnowledgeBaseUploadAndIngestFiles, click Actions Actions icon, then select Activate.

Next step

Optionally, add custom metadata to the knowledge base. See Add Custom Metadata to a Knowledge Base.

Additionally, you can now add documents into the knowledge base. Manually add them or upload them from OCI Object Storage. See: