Create a GenAI Connection

Define a GenAI connection to your application.

  1. Log in to the Essbase web interface as a service administrator.
  2. Click Sources, then select Create Connection.
  3. Select GenAI as the Connection Type.
  4. Enter a descriptive name for your AI connection in the Name field.
  5. The Service Provider is set to Oracle by default.
  6. Click Database connection and choose the database for which you want to create an AI connection.
  7. Fill in the parameters to complete the Vector and chat credential details section:
    1. User OCID: Find this value in the Configuration file preview.
    2. Tenancy OCID: Find this value in the Configuration file preview.
    3. OCI Compartment ID: Go to Identity in the Oracle Cloud Infrastructure console, then select Compartments. You can find the compartment ID there.
    4. Private Key: Refer to the Required Keys and OCIDs for instructions to create your private key.
    5. Fingerprint: Find this value in the Configuration file preview.

    Note:

    To get your OCI credentials:
    1. Sign in to the Oracle Cloud Infrastructure console.
    2. Click Profile icon, then select User settings.
    3. Go to Tokens and keys.
    4. Under the Fingerprint list, select your API key.
    5. Click the action menu.
    6. Select View configuration file to view the Configuration file preview.

    Note:

    If you haven't set up your OCI configuration:
    1. Sign in to the Oracle Cloud Infrastructure console.
    2. Click Profile icon, then select User settings.
    3. Go to Tokens and keys.
    4. Click Add API key.
    5. Choose Paste a public key.
    6. On your VM, open your public key file and copy the public key content.
    7. Return to the Oracle Cloud Infrastructure page and paste your public key content.
    8. Click Add.
    9. After you add your API key, click action menu and then select View configuration file to view the Configuration file preview.

    For more details, refer to the Required Keys and OCIDs.

  8. Use the following details to complete the Chat profile details section and Vectorization and MDX generator details section:
    1. Chat model: Select any available model listed under Pretrained foundational models
    2. OCI region: Select a region where the GenAI service is currently available.
    3. Generative AI service URL: Get this from the inference API of any model listed under Pretrained foundational models.

      For example:

      https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130/actions/embedText
    4. Vector embedding model: Select any available model listed under Pretrained foundational models
    5. Transfer timeout: 3000
    6. Description: (Optional)