Oracle Cloud Infrastructure Documentation

Specifying a Data Source for a Knowledge Base in Generative AI Agents

In this task, you add a data source to a knowledge base and optionally ingest the data. You must already have a knowledge base to perform this task.

If you don't have a knowledge base, create a knowledge base. When you create the knowledge base you can specify its data source.
Note

You can only have one data source per knowledge base. You can update a data source with new data instead of deleting and adding a new one. If you decide to delete a data source, we recommend that you review the data source's content first. See the links in managing data sources to get details, update, or delete a data source. To specify a data source for a knowledge base that lacks a data source, follow these steps:
  1. On the Knowledge Bases list page, select the knowledge base that you want to create a data source for.
    If you need help finding the list page, see Listing Knowledge Bases.
  2. Select Specify data source.
  3. 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.
    • Description: An optional description
  4. Enable multi-modal parsing: Select this option to parse and include information from charts and graphs in the documents.
  5. Select the bucket that contains the data for this data source. Change the compartment if the bucket is in another compartment.
    See Data requirements for Object Storage to ensure that the files in the buckets meet the requirements for Generative AI Agents.
  6. After the contents of the bucket is listed, perform one of the following actions:
    • Select all in bucket
    • Select the files and folders to include.
    • Add object prefixes manually to type the prefixes for the files and folders to be included.
    Important

  7. (Optional) Select the checkbox to start the ingestion job for this data source and add the data to this knowledge base. You can run the ingestion job later.
  8. (Optional) Select Show advanced options and add one or more tags to the data source. 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.
  9. Select Create.
    Note

    When you run an ingestion job, the data source takes a while to create.

    For the meaning of an ingestion job status and the action to take if there is a failure issue, see Ingesting Data Source Data, Step 6.