wms: 11628 - Updated screenshots to reflect new OCI console UI

common-242/2-configure-oci/2-configure-oci.md

@@ -0,0 +1,124 @@
+# Configure a Generative AI Service in APEX
+
+## Introduction
+
+To use the native GenAI features in APEX, you must configure a Generative AI service in APEX. To configure a Generative AI service, you will first need to obtain an API key from your preferred AI provider. You can either choose **OCI Generative AI** or **OpenAI** as your AI provider.
+
+
+In this lab, you use OCI Generative AI as the AI provider to build a conversational chatbot. To use the OCI Generative AI Service in APEX, you need to first configure the OCI API keys. In Oracle Cloud Infrastructure (OCI), API keys are used for secure authentication when accessing OCI resources through REST APIs.
+
+OCI API keys consist of two parts: a **Public key** and a **Private key**. You use the OCI console to generate the Private/Public key pair.
+
+**Note:** 
+   - OCI Generative AI service is available in limited regions. To see if your cloud region supports OCI Generative AI service, visit the [documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/overview.htm#regions).
+
+   - The screenshots in this workshop are taken using Dark Mode in APEX 24.2
+
+Estimated Time: 10 Minutes
+
+### Objectives
+
+In this lab, you:
+
+- Generate API Keys using OCI Console
+
+### Downloads
+
+If you are stuck or missed out on completing the previous labs, don't worry! Click [here](https://c4u04.objectstorage.us-ashburn-1.oci.customer-oci.com/p/EcTjWk2IuZPZeNnD_fYMcgUhdNDIDA6rt9gaFj_WZMiL7VvxPBNMY60837hu5hga/n/c4u04/b/livelabsfiles/o/labfiles%2Fnyc-starter-app.zip) to download the export file, which contains everything completed until Lab 2. To run the app, follow the steps described in the **Appendix Lab**:
+    - [Task 1: Import the App into an APEX Workspace](?lab=8-appendix&type=OCIGenAI#Task1:ImporttheAppintoanAPEXWorkspace)
+    - [Task 2: Update Web Credentials in Oracle APEX and Configure Generative AI](?lab=8-appendix&type=OCIGenAI#Task2:UpdateWebCredentialsinOracleAPEXandConfigureGenerativeAI)
+
+## Task 1: Generate API Keys using OCI Console
+
+Note: If you already have an OCI key pair, you may skip this lab.
+
+To Generate the API Keys using OCI Console:
+
+1. Login into your OCI Account.
+
+   ![Add API Key](images/oci-login.png " ")
+
+2. Click **Profile** at the top-right corner and select your username.
+
+    ![Profile Menu](images/profile.png " ")
+
+3. Switch to the **Tokens and keys** tab. Click **Add API key**.
+
+   ![Tokens and keys page](images/add-api-key.png " ")
+
+4. The Add API Key dialog is displayed. Select **Generate API Key Pair** to create a new key pair.
+
+5. Click **Download Private Key**. A *.pem* file is saved to your local device. You do not need to download the public key.
+
+   *Note: You will use this private key while configuring a Generative AI service in the upcoming lab.*
+
+6. Click **Add**.
+
+    ![Profile Menu](images/add.png " ")
+
+7. The key is added, and the Configuration File Preview is displayed. Copy and save the configuration file snippet from the text box into a notepad. You will use this information while configuring a Generative AI service in APEX.
+
+    ![Profile Menu](images/configuration-preview.png " ")
+
+## Task 2: Configure Generative AI Service
+
+To use the Generative AI service in APEX, you need to first configure it at the workspace level.
+
+1. From the App Builder, navigate to **Workspace Utilities** > **All Workspace Utilities**.
+
+    ![Workspace homepage](images/ws-utilities.png ' ')
+
+2. Select **Generative AI**.
+
+    ![Workspace Utilities page](images/select-genai.png ' ') 
+
+3. Click **Create** to configure a Generative AI Service.
+
+     ![Gen AI services page](images/create-genai.png ' ') 
+
+4. For this workshop, if you prefer to use OCI Generative AI Service as the AI provider, enter/select the following:
+
+    - AI Provider: **OCI Generative AI Service**
+    - Name: **OCI Gen AI**
+    - Static ID: **oci\_gen\_ai**
+    - Compartment ID: *Enter your OCI Compartment ID*. Refer to the [Documentation](https://docs.oracle.com/en-us/iaas/Content/GSG/Tasks/contactingsupport_topic-Locating_Oracle_Cloud_Infrastructure_IDs.htm#:~:text=Finding%20the%20OCID%20of%20a,displayed%20next%20to%20each%20compartment.) to fetch your Compartment ID. If you have only one compartment, then use the OCID from the configuration file you saved in Task 1 of this lab.
+    - Region: **us-chicago-1** (Currently, the OCI Generative AI Service is only available in limited regions)
+    - Model ID: **meta.llama-3.3-70b-instruct** (The pre-trained models are frequently deprecated. Refer to the [documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/pretrained-models.htm#pretrained-models) for the latest pre-trained models.)
+    - Used by App Builder: Toggle the button to turn it **ON**. Note that the Base URL is auto generated.
+
+    ![Gen AI services page](images/oci-gen-ai-details.png ' ')
+
+    - Credential: **Create New**
+
+    - **OCI User ID**: Enter the OCID of the Oracle Cloud user Account. You can find the OCID in the Configuration File Preview generated during the API Key creation.
+        Your OCI User ID looks similar to **ocid1.user.oc1..aaaaaaaa\*\*\*\*\*\*wj3v23yla**
+
+    - **OCI Private Key**: Open the private key (.pem file) downloaded in the previous task. Copy and paste the API Key.
+
+      ![Private key file](images/private-key.png " ")
+
+    - **OCI Tenancy ID**: Enter the OCID for Tenancy. Your Tenancy ID looks similar to **ocid1.tenancy.oc1..aaaaaaaaf7ush\*\*\*\*cxx3qka**
+
+    - **OCI Public Key Fingerprint**: Enter the Fingerprint ID. Your Fingerprint ID looks similar to **a8:8e:c2:8b:fe:\*\*\*\*:ff:4d:40** 
+
+   Click **Test Connection**.
+
+   ![Gen AI services page](images/oci-test-connection.png ' ')
+
+5. If the connection is successful, click **Create**.
+   If unsuccessful, verify if you have configured the IAM Policy on OCI correctly. Refer to the [Identity and Access Management](https://livelabs.oracle.com/pls/apex/r/dbpm/livelabs/run-workshop?p210_wid=624&p210_wec) workshop for more details.
+
+    ![Gen AI services page](images/oci-genai-create.png " ")
+
+## Summary
+Congratulations! You've completed the lab.
+
+You now know how to generate an API Key using OCI console and configure a Generative AI service in APEX.
+
+You may now **proceed to the next lab**.
+
+
+
+## Acknowledgments
+- **Author** - Apoorva Srinivas, Senior Product Manager
+- **Last Updated By/Date** - Apoorva Srinivas, Senior Product Manager, February 2025

common-242/3-configure-oci-keys/3-configure-oci-keys.md

@@ -0,0 +1,92 @@
+# Configure OCI API Keys and a Bucket
+
+## Introduction
+
+In this lab, you learn how to configure the OCI API keys and create buckets in OCI object storage. In Oracle Cloud Infrastructure (OCI), API keys are used for secure authentication when accessing OCI resources through REST APIs, and a bucket refers to a logical container used to store and manage data objects within an Object Storage service.
+
+OCI API keys have two parts: a **Public key** and a **Private key**. You use the OCI console to generate the Private/Public key pair.
+
+Estimated Time: 10 Minutes
+
+### Objectives
+
+In this lab, you:
+
+- Generate API Keys using OCI Console.
+
+- Create a Bucket in OCI Object Storage.
+
+## Task 1: Generate API Keys using OCI Console
+
+To Generate the API Keys using OCI Console:
+
+1. Login into your OCI Account.
+
+   ![Add API Key](images/oci-login.png " ")
+
+2. Click **My Profile** at the top-right corner and select **User settings**.
+
+    ![Profile Menu](images/profile.png " ")
+
+3. Under **Tokens and keys** tab and click **Add API key**.
+
+    ![Add API Key](images/api-keys.png " ")
+
+4. The Add API key dialog is displayed. Select **Generate API key pair** to create a new key pair.
+
+5. Click **Download private key**. A **.pem** file will be saved to your local device. You do not need to download the public key.
+
+   >*Note: You will use this private key while configuring the web credentials in Oracle APEX in the upcoming lab.*
+
+6. Click **Add**.
+
+    ![Profile Menu](images/add-api-key.png " ")
+
+7. The key is added, and the Configuration file preview is displayed. Copy and save the configuration file snippet from the text box into a notepad. You will use this information to create Oracle APEX Web Credentials.
+
+    ![Profile Menu](images/configuration-preview.png " ")
+
+## Task 2: Create a Bucket in OCI Object Storage
+
+To create a Bucket using OCI Console, login to your OCI Account.
+
+1. To access the Object Storage service, click on the menu icon **(☰)** at the top-left corner.
+
+   ![Navigate to storage](images/navigate-to-storage.png " ")
+
+2. Under Storage, select **Buckets**.
+
+   ![Select Bucket](images/select-bucket.png " ")
+
+3. Select the compartment where you want to create the Bucket. You can choose an existing compartment or create a new one if needed. Now, select **Create Bucket**.
+
+   ![Select Bucket](images/create-bucket.png " ")
+
+4. Enter/select the following:
+
+    - Bucket Name: **OCIDocAI**
+
+    - Default Storage Tier: **Standard**
+
+    Click **Create**.
+
+    ![Select Bucket](images/bucket-details.png " ")
+
+5. Navigate to **OCIDocAI** Bucket.
+
+    ![Select Bucket](images/bucket.png " ")
+
+6. Copy and save **Bucket Name** and **Namespace** from the bucket details into a notepad. You will use this information to upload an invoice to OCI Object Storage using Invoke API.
+
+    ![Select Bucket](images/bucket-created.png " ")
+
+## Summary
+
+You now know how to generate API Keys and create Bucket using the OCI console.
+
+You may now proceed to the next lab.
+
+## Acknowledgements
+
+- **Author(s)** - Roopesh Thokala, Senior Product Manager; Ankita Beri, Product Manager
+- **Last Updated By/Date** - Ankita Beri, Product Manager, May 2025

nyc-genai-lab/0-intro/0-intro.md

@@ -38,11 +38,13 @@ Estimated Time: 60 minutes
 - If you choose OCI Gen AI as your AI provider, the prerequisites are as follows:
     - A paid Oracle Cloud Infrastructure (OCI) account or a FREE Oracle Cloud account with $300 credits for 30 days to use on other services. Read more about it at: [oracle.com/cloud/free/](https://www.oracle.com/cloud/free/). The OCI account must be created in or subscribed to one of the regions that supports OCI Generative AI Service. Currently, OCI Generative AI Service is supported in the following regions:
 
-        - US Midwest (Chicago)
-        - Germany Central (Frankfurt)
-        - UK South (London)
         - Brazil East (Sao Paulo)
+        - Germany Central (Frankfurt)
         - Japan Central (Osaka)
+        - UAE East (Dubai)
+        - UK South (London)
+        - US Midwest (Chicago)
+
 
     - OCI Generative AI service is available in limited regions. To see if your cloud region supports OCI Generative AI service, visit the [documentation](https://docs.oracle.com/en-us/iaas/Content/generative-ai/overview.htm#regions).
 

nyc-genai-lab/3-configure-oci/3-configure-oci.md

@@ -44,27 +44,19 @@ To Generate the API Keys using OCI Console:
 
     ![Profile Menu](images/profile.png " ")
 
-3. Select a Compartment and click on the domain name.
+3. Switch to the **Tokens and keys** tab. Click **Add API key**.
 
-   ![Domain List](images/domain.png " ")
+   ![Tokens and keys page](images/add-api-key.png " ")
 
-4. Select **Users** from the left navigation menu. Select and click on the username for which you would like to create the API key.
-
-   ![User list](images/select-user.png " ")
-
-4. Under Resources at the bottom-left, select **API Keys** and  click **Add API Key**.
-
-    ![Add API Key](images/api-keys.png " ")
-
-5. The Add API Key dialog is displayed. Select **Generate API Key Pair** to create a new key pair.
+4. The Add API Key dialog is displayed. Select **Generate API Key Pair** to create a new key pair.
 
 5. Click **Download Private Key**. A *.pem* file is saved to your local device. You do not need to download the public key.
 
    *Note: You will use this private key while configuring a Generative AI service in the upcoming lab.*
 
 6. Click **Add**.
 
-    ![Profile Menu](images/add-api-key.png " ")
+    ![Profile Menu](images/add.png " ")
 
 7. The key is added, and the Configuration File Preview is displayed. Copy and save the configuration file snippet from the text box into a notepad. You will use this information while configuring a Generative AI service in APEX.