18.9.2.2 Editing a Generative AI Service

Edit a Generative AI Service on the Generative AI Services, Create/Edit page.

This topic describes common Generative AI Service attributes. The actual attributes that display depend upon the selected AI Provider. To learn more about an attribute, see item Help.

To edit a Generative AI Service:

1. Navigate to the Generative AI Services page:
   1. On the Workspace home page, click the App Builder icon.
   2. On the App Builder home page, click the Workspace Utilities icon.
   3. On the Workspace Utilities page, click Generative AI.
      The Generative AI Services page appears.
2. Select the AI Service Name.
3. Identification:
   1. Identification, AI Provider - Determines the AI Provider to use for this Generative AI Service.
   2. Identification, Name - The name of the Generative AI Service. The name displays on the Generative AI Services page in Workspace Utilities.
      Example: HCM OpenAI Service
4. Settings:
   1. Settings, Used by App Builder - When enabled, this Generative AI Service is used by App Builder.
   2. Settings, Default for New Apps - When enabled, this Generative AI Service is automatically selected as the default AI Service for all newly created applications.
5. Credentials:

   The Credentials attributes that display depend upon the selected AI Provider.

   1. Edit the attributes. To learn more about an attribute, see item Help.
   2. Test Connection - To validate entered information prior to completing your edits, click Test Connection.

      If the connection is valid, the following message displays:

      Connection Succeeded!

      If the connection fails, resolve the errors that display.

6. Advanced:

   The Advanced attributes that appear next depend upon the selected AI Provider. To learn more, see item Help.

   1. Advanced, Additional Attributes - Click Additional Attributes to include additional attributes that will be added to the JSON request payload as part of performing a Generative AI Service operation.
   2. Advanced, Static ID - The Static ID for the Generative AI Service. The static ID is used when using the service with the APEX_AI package (APEX_AI.CHAT).
      Example: HCM_OPENAI
   3. Advanced, Maximum AI Tokens - Enter the maximum number of AI Tokens per 24 hour period that Oracle APEX can use for the Generative AI Service. Not every Generative AI Service provides token usage information, so Oracle APEX may not be able to enforce this limit.

      The APEX_AI.GET_AVAILABLE_TOKENS function also returns the numbers of tokens available.

      An administrator can also set the Maximum AI Tokens at the workspace or instance-level. See Viewing Existing Workspace Information and Configuring Instance-Level Workspace Isolation Attributes in Oracle APEX Administration Guide

      .
   4. Advanced, HTTP Headers - Additional HTTP headers used in the Generative AI Service (REST) request.

      HTTP headers are specified in the following format:

      name_1=value_1

      name_2=value_2

   5. Advanced, Comments - Enter any developer comments or notes.
7. Click Apply Changes.