Move the new Develop AI Retrieval Augmented Generation (RAG) apps wit…

…h Autonomous Database Select AI folder structure to production (#390)

* Update setup-workshop-environment.md

* Delete 7381.png

* workshop # 3 ADB set up

and a couple of minor typos in workshops 1 and 2

* changes to adb-dcat workshop

* more changes

* minor typos in all 4 workshops

* quarterly qa build data lake

* new lab 11 in build DL with ADW

* minor changes database actions drop-down list

* final changes to build data lake workshop

* AI updates

AI workshop updates

* ai workshop updates

* Update query-using-select-ai.md

* Update query-using-select-ai.md

* updates

* more updates

* Update query-using-select-ai.md

* more new updates to ai workshop

* Update query-using-select-ai.md

* a new screen capture

* push Marty's feedback to fork

Final changes.

* updates sandbox manifest

* updates

* restored sandbox manifest

* Update setup-environment.md

* updates after CloudWorld

* final updates to ai workshop (also new labs 4 and 5)

* marty's feedback

* incorporated feedback

* minor PR edits by Sarah

* removed steps 7 & 8 Lab 2 > Task 3 per Alexey

The customer asked to remove this as it's not a requirement for the bucket to be public.

* more changes

* more changes per Alexey

* Update load-os-data-public.md

* Quarterly QA

I added a new step per the PM's request in the Data Sharing PL/SQL workshop. I also made a minor edit (removed space) in the Data Lake workshop.

* more updates

* Quarterly QA changes

* Update consume-share.md

* minor edit based on workshop user

* quarterly qa November 2023

* Added new videos to the workshop

Replaced 3 old silent videos with new ones. Added two new videos.

* Adding important notes to the two data sharing workshops

Per the PM's request.

* folder structure only  push to production

This push and the PR later is to make sure the folder structure is in the production repo before I start development. Only 1 .md file and the workshops folder.

* typos

* cloud links workshop

* UPDATES

* Update query-view.png

* update

* minor updates to chat ai workshop (Fork)

* test clones

* test pr

* Alexey's feedback

* Update data-sharing-diagram.png

* sarah's edits

* changes to Data Load UI

* removed script causing ML issue

* Update load-local-data.md

* updates: deprecated procedure and new code

* updates and test

* more updates

* minor update

* testing using a building block in a workshop

* updates

* building blocks debugging

* Update manifest.json

* fixing issues

* Update manifest.json

* delete cleanup.md from workshop folder (use common file)

* use common cleanup.md instead of local cleanup.md

* test common tasks

* update data sharing data studio workshop

* Update create-recipient.png

* PM's 1 feedback

* quarterly qa

* missing "Lab 2" from Manifest

* always free note addition

added a note

* always free change

* Update setup-environment.md

* update manage and monitor workshop

* Folder structure for new data share workshop (plus introduction.md)

* Updated Load and Analyze from clone

* Data Lake minor changes from clone

* manage and monitor workshop

* Remove the lab from the workshop per Marty's request

* mark-hornick-feedback

* used marty's setup file

* replaced notebook with a new one

* updates to lab 6 of manage and monitor

* Update adb-auto-scaling.md

* Nilay's feedback

* Update adb-auto-scaling.md

* updates to second ai workshop

* note change

* Changes to Load and Analyze workshop (other minor changes too)

* quarterly qa

* Update diagrams per Alexey (remove delta share icon)

* updated the 15-minutes workshop

* Update analyzing-movie-sales-data.md

* ords updates and misc

* updated data studio workshop

* ORDS and Misc updates

* updated freetier version

* updated livelabs version

* updating the manage and monitor workshop

* more updates

* lab 11 updates

* updated lab 14

* updated freetier

* more updates

* Update adw-connection-wallet.md

* update

* Create purge-scn.png

* livelabs updates

* Update adb-flashback.md

* final updates

* updated screens Ramona's review

* Update click-add-peer-database-second-time.png

* update the adb-dcat workshop

1. New ord 24.1.0 launchpad.
2. New navigation path to create dynamic groups
3. Updated OML UI

* Update see-clone-information-in-details-page-2.png

* Requested changes to the Data Lake workshop

* more updates

* updates to Data Lake workshop

* kscope24 workshop for Alexey

* new lab & other updates

* Update load-os-data-private.md

* Update load-os-data-private.md

* more updates, new lab

* minor update example 2

* Update load-os-data-private.md

* Chat AI workshop changes

* new notebook

* more updates

* minor updates

* New Iceberg Lab

added to the freetier and livelabs workshops

* Update manifest.json

* Update query-iceberg-tables.md

* new livelabs folder to request green button

* folder structure for two more data sharing workshops - green button

* 3rd workshop

* NEW LIVE DATA SHARE WORKSHOP

* Anne's feedback

* update

* Update introduction.md

* changes to manifest files and setup lab

* updated AI Chat workshop

* feedback

* adding the missing lab 4 to the workshop

* Update introduction.md

* Update introduction.md

* notebook update

* Update query-using-select-ai.md

* updated notebook

* changes based on Ramona's qa

* update freetier version

* Green button version for 3881 workshop

* data share cloud links db actions green button version

* (4) data sharing workshops updates (freetier and one sandbox)

* green button for Set up live data sharing between Oracle Databases using Cloud Links and PL/SQL APIs

* Chat with your data in Autonomous Database using generative AI updates

* updated the notebook

* blurred two screens

* workaround for found bug

* green button

* updates

* minor change

* update adb

* removed old lab

* Update manifest.json

* new rag workshop

* Update integrate-genai.md

* update to new workshop

---------

Co-authored-by: Michelle Malcher <[email protected]>
Co-authored-by: Sarah Hirschfeld <[email protected]>

shared/develop-rag-apps/apex-setup/install-app.sql

@@ -0,0 +1,45 @@
+DECLARE
+    l_workspace_name VARCHAR2(100) := 'MOVIESTREAM';
+    l_schema_name VARCHAR2(100) := 'MOVIESTREAM';
+    l_workspace_usr_pwd VARCHAR2(100) := 'change_me';
+begin
+    apex_instance_admin.add_workspace(
+     p_workspace_id   => null,
+     p_workspace      => l_workspace_name,
+     p_primary_schema => l_schema_name);
+
+      -- We must set the APEX workspace security group ID in our session before we can call create_user
+    apex_util.set_security_group_id( apex_util.find_security_group_id( p_workspace => l_workspace_name));
+  apex_util.create_user( 
+        p_user_name               => 'WKSP_ADMIN',
+        p_email_address           => '[email protected]',
+        p_default_schema          => l_schema_name,
+        p_allow_access_to_schemas => l_schema_name,
+        p_web_password            => l_workspace_usr_pwd,
+        p_developer_privs         => 'ADMIN:CREATE:DATA_LOADER:EDIT:HELP:MONITOR:SQL' );  -- workspace administrator
+
+
+    commit;
+end;
+/
+
+BEGIN
+    -- Set the name of the workspace in which the app needs to be installed
+    apex_application_install.set_workspace('MOVIESTREAM');
+
+    -- Setting the application id to 101
+    apex_application_install.set_application_id(101);
+    apex_application_install.generate_offset();
+
+    -- Setting the Schema
+    apex_application_install.set_schema('MOVIESTREAM');
+
+    -- Setting application alias
+    apex_application_install.set_application_alias('ASK-ORACLE');
+
+    -- Set Auto Install Supporting Objects
+    apex_application_install.set_auto_install_sup_obj( p_auto_install_sup_obj => true );
+
+END;
+/
+@f101.sql

shared/develop-rag-apps/apex-setup/install-ask-oracle.sql

@@ -0,0 +1,57 @@
+declare
+   l_workspace_name VARCHAR2(20) := 'MOVIESTREAM';
+   l_schema_name VARCHAR2(20) := 'MOVIESTREAM';
+   l_password VARCHAR2(20) := 'watchS0meMovies#';
+
+begin
+
+    begin
+        workshop.write('create apex workspace',2);
+        apex_instance_admin.add_workspace(
+             p_workspace_id   => null,
+             p_workspace      => l_workspace_name,
+             p_primary_schema => l_schema_name);
+    exception
+        when others then              
+            workshop.write(sqlerrm); 
+    end;
+
+      -- We must set the APEX workspace security group ID in our session before we can call create_user
+    begin
+        workshop.write('add apex ' || l_schema_name || ' user',2);
+        apex_util.set_security_group_id( apex_util.find_security_group_id( p_workspace => l_workspace_name));
+        apex_util.create_user( 
+            p_user_name               => l_schema_name,
+            p_email_address           => '[email protected]',
+            p_default_schema          => l_schema_name,
+            p_allow_access_to_schemas => l_schema_name,
+            p_web_password            => l_password,
+            p_developer_privs         => 'ADMIN:CREATE:DATA_LOADER:EDIT:HELP:MONITOR:SQL' );  -- workspace administrator
+
+        commit;
+    exception
+        when others then              
+            workshop.write(sqlerrm); 
+
+    end;
+
+    -- Set the name of the workspace in which the app needs to be installed
+    apex_application_install.set_workspace(l_workspace_name);
+
+    -- Setting the application id to 101
+    apex_application_install.set_application_id(101);
+    apex_application_install.generate_offset();
+
+    -- Setting the Schema
+    apex_application_install.set_schema(l_schema_name);
+
+    -- Setting application alias
+    apex_application_install.set_application_alias('ASK-ORACLE');
+
+    -- Set Auto Install Supporting Objects
+    apex_application_install.set_auto_install_sup_obj( p_auto_install_sup_obj => true );
+
+    END;
+/
+
+@f101.sql

shared/develop-rag-apps/apex-setup/test.sql

@@ -0,0 +1,4 @@
+begin
+    admin.workshop.write('test');
+end;
+/

shared/develop-rag-apps/cleanup/cleanup.md

@@ -0,0 +1,66 @@
+# Clean up Resources Used in this Workshop (Optional)
+
+## Introduction
+
+In this lab, you will learn how to delete some or all of the resources that you created in this workshop that you don't need. If you want to re-run all the labs in this workshop again from the beginning, you can delete the entire compartment.
+
+Estimated Time: 5 minutes
+
+### Objectives
+
+* Delete the Autonomous Database instance or destroy the created stack and its resources such as the ADB instance.
+* Delete your entire compartment if you don't need it.
+
+### Prerequisites
+This lab assumes that you have successfully completed all of the preceding labs in the **Contents** menu.
+
+## Task 1: Destroy Your Stack
+
+You can destroy (instead of deleting) your stack that you created in Lab 1 in this workshop as follows. Associated resources such as your ADB instance persist after stack deletion. To avoid difficult cleanup later, we recommend that you release associated resources first by running a destroy job. See [Creating a Destroy Job](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Tasks/create-job-destroy.htm) for additional information. _If you prefer to keep your stack, you can terminate your ADB instance as detailed in Task 2._
+
+1. Open the **Navigation** menu and click **Developer Services**. In the **Resource Manager** section, click **Stacks**.
+
+2. Click your stack name.
+
+3. On the **Stack details** page, click **Destroy**. A **Destroy** confirmation box is displayed. Click **Destroy**. The initial status is **Accepted** followed by **In progress** and finally **Succeeded**. The stack resources are released.
+
+## Task 2: Terminate Your Autonomous Database Instance
+
+You can terminate your ADW instance that you created in this workshop as follows:
+
+1. Open the **Navigation** menu and click **Oracle Databases**. Click **Autonomous Database**.
+
+2. On the **Autonomous Databases** page, in the **List Scope** section, select your compartment from the **Compartment** drop-down list. In the row for your Autonomous Database instance, click the **Actions** icon (three dots), and then select **Terminate** from the context menu.
+
+3. A **Terminate Autonomous Database** dialog box is displayed. Enter your ADB instance name in the **To confirm, enter the name of the database that you want to terminate** field, and then click **Terminate Autonomous Database**.
+
+    The **State** of the Autonomous Database instance goes into **Terminating**. When the ADB is deleted, the **State** changes to **Terminated**.
+
+## Task 3 (Optional): Delete Your Compartment
+
+If you created an optional compartment for this workshop, you can delete it if you no longer need it. To delete a compartment, it must be empty of all resources. Before you initiate deleting a compartment, be sure that all its resources have been moved, deleted, or terminated, including any policies attached to the compartment. If you want to re-run this entire workshop from the beginning, you must delete all of the resources in your compartment as described in the earlier steps of this lab. Next, you can delete the compartment. See [Managing Compartments](https://docs.oracle.com/en-us/iaas/Content/Identity/Tasks/managingcompartments.htm) in the Oracle Cloud Infrastructure documentation.
+
+1. Click the **Navigation** menu and click **Identity & Security**. Under **Identity**, select **Compartments**. From the list of available compartments, search for your compartment.
+
+2. On the **Compartments** page, in the row for your compartment, click the **Actions** button, and then select **Delete** from the context menu.
+
+3. A confirmation message box is displayed. Click **Delete**. The state of the deleted compartment changes from **Active** to **Deleting** until the compartment is successfully deleted. You can click on the compartment name link in the **Name** column to display the status of this operation.
+
+**This concludes the workshop.**
+
+## Want to Learn More?
+
+* [Creating a Destroy Job](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Tasks/create-job-destroy.htm)
+* [Oracle Cloud Infrastructure Documentation](https://docs.cloud.oracle.com/en-us/iaas/Content/GSG/Concepts/baremetalintro.htm)
+* [Overview of Oracle Cloud Infrastructure Identity and Access Management](https://docs.cloud.oracle.com/en-us/iaas/Content/Identity/Concepts/overview.htm)
+
+## Acknowledgements
+
+* **Author:** Lauran K. Serhal, Consulting User Assistance Developer
+* **Last Updated By/Date:** Lauran K. Serhal, February 2025
+
+Data about movies in this workshop were sourced from Wikipedia.
+
+Copyright (c) 2025 Oracle Corporation.
+
+Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled [GNU Free Documentation License](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt)