genAIService

Direct Properties:

PropertyTypeRequiredDefault ValueDetails
namestringYesdata type=string; maxLen=255
Enter a descriptive name for this Generative AI Service.
providerenumYesdata type=string; lov=STATIC
Valid values: ociGenAI openai cohere googleGemini anthropicClaude mistralAi ollama genericOpenaiApiCompatible

Property Groups:

  • ociGenAI
  • endpointUrl
  • authentication
  • additionalData
  • appBuilder
  • advanced
  • comments
ociGenAI
PropertyTypeRequiredDefault ValueDetails
compartmentIdstringYesdata type=string; maxLen=255
Applies whenprovider = ociGenAI
servingModeenumYesdata type=string; lov=STATIC
Valid values: onDemand dedicated
Applies whenprovider = ociGenAI
endpointIdstringYesdata type=string; maxLen=255
Applies whenprovider = ociGenAI and servingMode = dedicated
projectIdstringYesdata type=string; maxLen=255
Applies whenprovider = ociGenAI and provider in (openai) and providerApi = responsesprovider = ociGenAI and provider in (genericOpenaiApiCompatible) and providerApi = responsesprovider = ociGenAI and provider in (ollama) and providerApi = responsesprovider = ociGenAI and provider in (ociGenAI) and providerApi = responsesprovider = ociGenAI and provider in (googleGemini) and providerApi = responses
ociGenAI {
  compartmentId: value
  servingMode: onDemand
  endpointId: value
  projectId: value
}
endpointUrl
PropertyTypeRequiredDefault ValueDetails
urlstringYesdata type=string; maxLen=4000
Enter the endpoint URL for this Generative AI Service.
endpointUrl {
  url: value
}
authentication
PropertyTypeRequiredDefault ValueDetails
credentialsreferenceNodata type=reference; lov=COMPONENT; references=webCredential
authentication {
  credentials: @component
}
additionalData
PropertyTypeRequiredDefault ValueDetails
httpHeadersmultiline stringNodata type=multiline string; maxLen=4000
attributesmultiline stringNodata type=multiline string; maxLen=4000
additionalData {
  httpHeaders: ```
    value
  ```
  attributes: ```
    value
  ```
}
appBuilder
PropertyTypeRequiredDefault ValueDetails
usedByAppBuilderbooleanYesfalsedata type=boolean
defaultForNewAppsbooleanYesfalsedata type=boolean
appBuilder {
  usedByAppBuilder: false
  defaultForNewApps: false
}
advanced
PropertyTypeRequiredDefault ValueDetails
modelNamestringNodata type=string; maxLen=255
maxTokensintegerNodata type=integer; maxLen=32767

Enter the maximum number of AI Tokens per rolling 24 hour period that Oracle APEX can use for this Generative AI Service.

Please note that not every Generative AI Service supports token usage information, so it might be possible that &PRODUCT_NAME can't enforce this limit.

serverTimeoutintegerNodata type=integer; maxLen=32767

Defines the transfer timeout for communicating with the Generative AI Service in seconds.

staticIdstringYesdata type=string; maxLen=255
Use the Static ID to reference the Generative AI Service in API Calls. Static IDs are also used to identify an existing Generative AI Service when the application is being exported and imported to another workspace.
providerApienumYesdata type=string; lov=STATIC
Valid values: responses generic interactions chatCompletions generateText
Applies whenprovider in (openai)provider in (genericOpenaiApiCompatible)provider in (ollama)provider in (ociGenAI)provider in (googleGemini)
advanced {
  modelName: value
  maxTokens: 42
  serverTimeout: 42
  staticId: value
  providerApi: responses
}
comments
PropertyTypeRequiredDefault ValueDetails
commentsmultiline stringNodata type=multiline string; maxLen=4000
comments {
  comments: ```
    value
  ```
}

APEXlang Example

genAIService sample (
    name: value
    provider: ociGenAI
    ociGenAI {
        compartmentId: value
        servingMode: onDemand
        endpointId: value
        projectId: value
    }
    endpointUrl {
        url: value
    }
    authentication {
        credentials: @component
    }
    additionalData {
        httpHeaders: ```
          value
        ```
        attributes: ```
          value
        ```
    }
    appBuilder {
        usedByAppBuilder: false
        defaultForNewApps: false
    }
    advanced {
        modelName: value
        maxTokens: 42
        serverTimeout: 42
        staticId: value
        providerApi: responses
    }
    comments {
        comments: ```
          value
        ```
    }
)