Oracle Cloud Infrastructure Documentation

Adding Data with Custom URL to an Object Storage Bucket

Create a bucket in Object Storage and add files for the agent to use in OCI Generative AI Agents. Then, assign a custom URL to each file. When an agent in OCI Generative AI Agents uses that file for its response, it can cite the file with the custom URL.

  1. In the navigation bar of the Console, select a region that hosts Generative AI Agents, for example, US Midwest (Chicago). If you don't know which region to select, see Regions with Generative AI Agents.
  2. Open the navigation menu and click Storage. Under Object Storage & Archive Storage, click Buckets.
  3. Select the compartment in which you want to create a bucket or the compartment that contains the bucket that you want to use. You must already have the following permission to add Object Storage resources to this compartment. 
    allow group <your-group-name> to manage object-family in compartment <compartment-with-bucket>
  4. To create a bucket follow these steps:
    1. Click Create Bucket.
    2. Enter a name unique to your region for the bucket.
    3. For other fields, click the Learn more links and then select options that apply to your data. Also see Creating an Object Storage Bucket.
    4. Click Create.
      By default, a new bucket is private. You can change the visibility of a bucket after you create it.
  5. Click the name of the bucket that you want to use.
  6. On the bucket details page, under Objects, click Upload.
  7. (Optional) Select Show Optional Headers and Metadata and then select and enter the following values.
    • Type: Metadata
    • Name: customized_url_source
    • Value: <your-custom-url>
    Important

    For the citation link override to work, you must use Name: customized_url_source. If you don't want the agent to return a custom URL in its citations, skip this step.
  8. Upload the files that you want for your data source.